Construisez avec l'API PesaBridge.
Des guides pour les encaissements, les décaissements, le paiement hébergé et les webhooks, avec des exemples à coller directement dans votre terminal. Tout se teste d'abord dans le sandbox.
https://pesa-bridge.com/api/bridgepay/v1
53 endpoints · OpenAPI 3 · JSON sur HTTPS
Outils
Tout ce qu'il vous faut à côté des guides
Référence de l'API
Une surface réduite et prévisible.
/oauth/tokenÉchangez des identifiants client contre un jeton porteur./partner/stkPoussez un débit (invitation à payer) vers un client./partner/statusInterrogez l'état d'un débit./partner/balanceInterrogez le solde d'un compte d'encaissement./biz/requestDemande de paiement du marchand./ussdRappel de passerelle de menus USSD.Rails et intégrations
Connectez uniquement ce dont votre marché a besoin.
Les rails sont des adaptateurs enfichables partageant une seule interface — encaisser, décaisser, solde et rappels — pour qu'un nouveau connecteur ne touche jamais au socle.
Banques
Règlement RTGS / ACH / SWIFT / SEPA et gestion des comptes nostro.
Mobile money
Les opérateurs de mobile money de chaque marché, via des adaptateurs de rails.
Cartes et PSP
Acquisition sur les grands réseaux de cartes et intégrations avec les processeurs.
Facturiers et télécoms
Services publics, TV, gouvernement, frais de scolarité et recharge de crédit.
Conçue pour l'argent
Une API qui se comporte comme un système de paiement.
La plupart des API font circuler des données. Celle-ci fait circuler de l'argent — elle est donc idempotente, signée et bâtie autour d'un cycle de vie de débit auquel vous pouvez vous fier.
L'authentification repose sur les identifiants client OAuth2 : vous échangez une clé et un secret contre un jeton porteur de courte durée. Chaque appel modifiant l'état porte une clé d'idempotence, de sorte qu'un réessai réseau se règle exactement une fois — la propriété la plus importante lorsque de l'argent réel est en jeu.
Un encaissement est un débit. Vous le poussez vers le numéro d'un client ; une invitation à payer s'affiche sur son téléphone ; il confirme par un PIN. Le débit passe par en attente → autorisé → terminé (ou refusé / expiré / échoué), et vous en connaissez l'issue de deux façons : interroger le point de terminaison de statut, ou — mieux — recevoir un webhook au moment même où il change.
Les webhooks sont signés en HMAC-SHA256 à l'aide d'un secret que seuls vous et PesaBridge partagez, puis réessayés avec délai jusqu'à l'accusé de réception de votre point de terminaison — vous pouvez donc bâtir dessus sans craindre un événement manqué ou falsifié. Les points de terminaison de solde et de transactions bouclent le rapprochement, et un bac à sable exécute le contrat à l'identique, pour livrer en toute confiance.
Cycle de vie du débit
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}Sécurité et conformité
La confiance est le produit.
Les services financiers vivent ou meurent sur l'exactitude et le contrôle. PesaBridge intègre les deux au cœur du socle.
Partie double par construction
Chaque mouvement inscrit des débits et crédits équilibrés — les comptes se soldent à zéro, toujours.
PIN, KYC et plafonds
Niveaux de KYC configurables, plafonds par transaction et journaliers, tentatives de PIN et verrouillage du portefeuille.
Idempotent et réversible
Les clés d'idempotence évitent les doubles débits ; un moteur d'annulation unifié annule n'importe quel département.
Webhooks signés
Signatures HMAC-SHA256 et réessais pour que les systèmes partenaires se fient à chaque rappel.
Piste d'audit complète
Écritures de grand livre immuables et historique des transactions pour régulateurs et litiges.
Conformité par pays
Types de pièces d'identité, règles de KYC et tarifs changent avec le marché, par configuration.
Un blocage ?
Nos ingénieurs répondent aux questions d'intégration. Envoyez-nous la référence de la requête et nous retrouverons l'appel exact.