Démarrer

PayRouter est 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 seule fois ; PayRouter gère le routage des fournisseurs, les relances, le rapprochement et un statut normalisé unique pour chaque paiement.

Ce guide vous mène d'un compte vide à votre première transaction en production. Si vous voulez simplement voir du code, passez au Démarrage rapide.

Nouveau ici ?

Suivez le parcours de haut en bas : Démarrer → Démarrage rapide → Authentification → Transactions → Webhooks → Tests → Passage en production. Chaque page liste ses prérequis en tête, vous savez donc toujours ce dont vous avez besoin avant de commencer.

Comment circule un paiement

Vous n'appelez jamais directement un opérateur mobile-money. Vous créez une seule transaction ; le switch de PayRouter sélectionne un fournisseur, le sollicite, et rapporte le résultat final à votre serveur.

Séquence d un paiement : votre serveur envoie une transaction à PayRouter, PayRouter la route vers un fournisseur, et un webhook du fournisseur permet à PayRouter de notifier votre URL de rappel avec le statut final.

Le parcours complet d un paiement — de votre requête jusqu au rappel de statut final.

Un seul registre. Chaque paiement est une unique Transaction avec un cycle de vie protégé : Received → Pending → Success | Failed | Cancelled.
Indépendant du fournisseur. PayRouter sélectionne un fournisseur (ou répartit la charge entre plusieurs) et normalise le résultat, de sorte que votre intégration ne change jamais lorsqu'un fournisseur change.
Asynchrone. L'argent ne circule jamais lors de la requête initiale. Vous créez une transaction, puis vous recevez le statut final sur votre callback_url.

URL de base & conventions


URL de base de production	`https://payrouter.io`
URL de base locale / dev	`http://127.0.0.1:8000`
Format	JSON — envoyez `Content-Type: application/json`
Auth	`Authorization: Bearer <token>` sur chaque appel authentifié
IDs	Tous les identifiants de ressources sont des UUID
Argent	Chaînes décimales à 2 décimales, p. ex. `"100.00"` — jamais des flottants
Erreurs	`{ "error": { "code", "message", "details" } }` — voir Erreurs
Pagination	`{ "count", "next", "previous", "results" }` — `?page=`, `?page_size=` (max 200)

Note

Tous les exemples utilisent l'URL de base de production https://payrouter.io. Lors de tests en local, remplacez-la par http://127.0.0.1:8000. Votre compte dispose aussi d'un mode sandbox pour des tests sûrs avant le passage en production — voir Tests.

Ce dont vous aurez besoin

Prerequisites

Un compte PayRouter — inscrivez-vous sur /signup et confirmez l'OTP envoyé à votre e-mail.
Un profil marchand complété (nom de l'entreprise, pays) — il vous sera demandé juste après l'inscription.
Un jeton API — généré depuis Profil → Clés API. Voir Authentification.
Un point de terminaison HTTPS public pour recevoir les webhooks (vous pouvez l'ajouter plus tard — voir Webhooks).

Quatre étapes pour passer en production

Créez votre compte et complétez votre profil marchand. PayRouter provisionne automatiquement vos comptes de service et vos portefeuilles.
Obtenez un jeton API — voir Authentification.
Créez votre première transaction en sandbox — voir le Démarrage rapide et Transactions.
Recevez le résultat sur votre webhook, puis demandez à un administrateur de vous promouvoir en production.

Démarrage rapide