Démarrer

PayRouter est une passerelle de paiement unifiée : une seule API pour accepter et router les paiements mobile money à travers plusieurs fournisseurs (FreshPay, Unipesa) en RDC et au-delà. Ce guide vous mène de la création de compte à votre première transaction.

Comment ça marche

text

Votre app ──POST /api/payments/transaction/──▶ PayRouter
                                               │  crée une Transaction (statut : Received)
                                               │  le switch la route vers un fournisseur
                                               ▼
                                          Fournisseur (FreshPay / Unipesa)
                                               │
        ◀──POST votre callback_url── PayRouter ◀──webhook── Fournisseur
            (statut final : Success / Failed)

Un seul registre. Chaque paiement est une unique Transaction avec un cycle de statut protégé : Received → Pending → Success | Failed | Cancelled.
Indépendant du fournisseur. Vous n'appelez jamais un fournisseur directement. Le switch de PayRouter en sélectionne un (ou répartit la charge) et normalise le résultat.
Asynchrone. Vous créez une transaction, puis recevez le statut final sur votre callback_url.

URL de base & format


URL de base	`https://<votre-hôte>` (dev : `http://127.0.0.1:8000`)
Format	JSON (`Content-Type: application/json`)
Auth	`Authorization: Bearer <token>` (token Knox)
Erreurs	`{ "error": { "code", "message", "details" } }`
Pagination	`{ "count", "next", "previous", "results" }` (`?page=`, `?page_size=`)

Quatre étapes pour passer en production

Créez un compte sur /signup, puis confirmez l'OTP sur /verify-email.
Obtenez un token API — voir Authentification.
Créez une transaction — voir Transactions.
Recevez le résultat sur votre callback — voir Callbacks.

Authentification