Questions fréquentes

Premiers pas

Qu'est-ce que PayRouter ?

Une passerelle de paiement unifiée : une seule API pour accepter et router des paiements mobile-money entre fournisseurs (Vodacom, Airtel, Orange, Africell) en RDC et au-delà. Vous intégrez une fois ; PayRouter gère le routage des fournisseurs, les relances et un statut normalisé unique par paiement. Voir Démarrer.

Dois-je contacter le service commercial pour commencer ?

Non. Inscrivez-vous, vérifiez votre e-mail, complétez votre profil marchand, et générez un jeton API. Vous pouvez construire et tester immédiatement en sandbox. L'accès à la production est accordé par un administrateur lorsque vous êtes prêt (Passage en production).

Quels pays et fournisseurs sont pris en charge ?

La RDC est active avec Vodacom, Airtel, Orange et Africell. Listez les services disponibles pour vous avec GET /api/organization/service/.

Authentification & jetons

Est-ce Bearer ou Token ?

Bearer. Envoyez Authorization: Bearer <your-token> sur chaque requête authentifiée.

Combien de temps durent les jetons API ?

Les jetons API sont valides 90 jours. Générez-les et révoquez-les sous Profil → Clés API ou via GET/POST/DELETE /api/auth/login-tokens/. Le secret complet est affiché une seule fois à la création — stockez-le en lieu sûr.

Quelle est la différence entre sandbox et production ?

account_type vaut "sandbox" pour les nouveaux comptes et "prod" après promotion. L'API est identique dans les deux ; seuls l'indicateur et le fait que de l'argent réel circule diffèrent.

Paiements

Pourquoi ne transmets-je pas mon identifiant de marchand ou d'utilisateur ?

Votre identité est dérivée de votre jeton par sécurité. Vous envoyez uniquement merchant_reference, amount, currency, service, customer_number, operation (plus callback_url, provider_code_name optionnels).

Comment spécifier la devise et le service ?

Par code, pas par UUID — p. ex. "CDF", "USD", "Vodacom". La correspondance est insensible à la casse. Listez les valeurs valides avec GET /api/organization/currency/ et GET /api/organization/service/.

Que signifie operation ?

"debit" encaisse de l'argent auprès du client ; "credit" verse de l'argent au client.

Puis-je choisir le fournisseur ?

Optionnellement. Omettez provider_code_name pour laisser le répartiteur de charge router automatiquement, ou définissez "freshpay" / "unipesa" pour en forcer un.

Comment éviter le double débit lors des relances ?

Réutilisez le même merchant_reference. Il est unique par marchand, donc une relance renvoie 400 au lieu de créer un second paiement.

L'argent est-il déplacé immédiatement ?

Non. Les paiements sont asynchrones. Vous créez une transaction (statut Received), PayRouter la sollicite, et le statut final arrive sur votre webhook.

Webhooks

Pourquoi ai-je reçu le même webhook deux fois ?

La livraison est au moins une fois. Rendez votre gestionnaire idempotent en vous basant sur reference.

Je n'ai pas encore de point de terminaison public — puis-je quand même construire ?

Oui. Développez contre l'API et interrogezGET /api/payments/transaction/<reference>/. Ajoutez le webhook avant le passage en production.

Dois-je faire confiance au montant indiqué dans le webhook ?

Ré-interrogez GET /api/payments/transaction/<reference>/ pour confirmer le statut et le montant faisant autorité avant de libérer des biens ou des fonds.

Rapprochement & support

Un webhook a été manqué. Comment récupérer ?

Interrogez les points de terminaison de liste/détail des transactions et appliquez le statut faisant autorité — voir Rapports.

Comment les montants sont-ils formatés ?

Sous forme de chaînes décimales à deux décimales, p. ex. "100.00". N'utilisez jamais de flottants.

Où signaler un problème ?

Rassemblez les reference / merchant_reference, le code et le message d'erreur, et l'horodatage, puis contactez le support. Ne partagez jamais votre jeton API. Voir Dépannage.