Engineering · 11 min de lecture
API développeur
Encaissez et décaissez en quelques appels.
Une API épurée façon Daraja : identifiants client OAuth2, un bac à sable, l'invitation à payer et des webhooks signés et réessayés — intégrez encaissements et paiements en un après-midi.
En détail
L'API développeur est conçue pour l'argent, pas seulement pour des requêtes. Vous échangez des identifiants client contre un jeton de courte durée, puis poussez un débit vers un client ; il confirme dans son portefeuille, et vous recevez un webhook signé au moment où il se dénoue. Chaque appel est idempotent, si bien qu'un réessai après une connexion coupée ne débite jamais deux fois.
Un débit passe par un cycle de vie clair — en attente, autorisé, terminé, refusé ou expiré — que vous pouvez interroger ou recevoir par webhook. Les webhooks sont signés en HMAC-SHA256 et réessayés jusqu'à l'accusé de réception, pour que vos systèmes se fient à chaque rappel, et les requêtes de solde et de transactions permettent le rapprochement. Un bac à sable exécute le même contrat que la production, et les rails sont abstraits derrière l'API, si bien que vous intégrez une fois et changez de fournisseur sans modifier votre code.
Pourquoi c'est important
Conçu pour inspirer confiance.
- Identifiants client OAuth2 avec clés de bac à sable et de production.
- Invitation à payer (STK push) avec interrogation du statut.
- Webhooks signés en HMAC-SHA256 et réessayés auxquels vos systèmes se fient.
Résultats
- Intégrer en un après-midi
- Rapprocher automatiquement
- Bâtir sur un contrat stable
Ce qu'il contient
API développeur — en détail.
01
Jetons OAuth2
Échangez des identifiants client contre un jeton porteur.
02
Débit et statut
Poussez un débit et interrogez son cycle de vie.
03
Webhooks
Rappels signés au moment où un débit se dénoue.
04
Solde et historique
Interrogez les soldes d'encaissement et les transactions.
Flux réels
Comment ça fonctionne en pratique.
Passez d'un parcours à l'autre pris en charge par cette fonctionnalité. Chacun vérifie solde et plafonds, puis attend l'autorisation par PIN ou biométrie avant d'inscrire des écritures équilibrées au grand livre.
Invitation du marchand (STK)
Le marchand pousse un débit à travers son cycle de vie ; le client approuve une invitation.
Autorisé avec PIN ou biométrie — rien ne s'inscrit au grand livre tant que le client n'a pas confirmé.
- Solde et plafond vérifiés en premier
- Étape de validation / autorisation
- Débits et crédits équilibrés inscrits
Client
Système
01
SystèmeLe marchand pousse un débit
02
SystèmeCréer le débit · état = en attente
ClientL'invitation apparaît sur le téléphone
03
04
Système · valideValider et vérifier le solde
Client · valideAutoriser — PIN ou biométrie
05
06
SystèmeDébiter le payeur, créditer le marchand
07
SystèmeÉtat = terminé
08
SystèmeWebhook signé + réessai jusqu'à l'accusé
Système · terminéPayé ✓ · reçu affiché
Étape Validation / PIN Terminé
190+
Pays où vous pouvez vous lancer
4
Applis natives, une seule plateforme
4
Canaux — Appli · USSD · Web · API
100%
Comptabilité en partie double, toujours équilibrée
Plus de la plateforme
Un socle, chaque fonctionnalité.
Pour aller plus loin
Les guides de l'équipe PesaBridge
Articles en anglais.
Continuer la visite
Où aller ensuite
Prêt à lancer votre portefeuille ?
Réservez une démo et nous mettrons en place votre marque, votre pays et vos rails — et vous guiderons à travers les applis, l'administration et l'API.
Vous préférez parler ? Appelez le +254 746 883809