PesaBridge
Docs/Décaisser/Envoyer de l'argent (décaissements)

Décaisser

Envoyer de l'argent (décaissements)

Payez clients, entreprises et administrations fiscales depuis votre compte de règlement, avec un second facteur optionnel et des résultats asynchrones.

6 min de lecture

Sur cette page
  1. Alimenter votre compte de règlement
  2. Types de décaissement
  3. Second facteur : Initiator et SecurityCredential
  4. Synchrone ou asynchrone

Alimenter votre compte de règlement

Les décaissements partent de votre compte de règlement. Alimentez-le avec POST /partner/topup ({"amount": 100000}) et consultez-le avec GET /partner/balance.

Types de décaissement

Point de terminaisonPaieChamps clés
POST /partner/b2cLe portefeuille d'un clientto_msisdn, amount, remarks
POST /partner/bizpocketLa Biz Pocket d'un clientto_msisdn, amount, remarks
POST /partner/b2bUne autre entrepriseto_shortcode, amount, account_reference
POST /partner/taxLe fisc ou un organisme publicto_shortcode, amount, prn

Chacun accepte une clé idem. Réessayez avec la même clé après un délai dépassé : vous obtenez le décaissement d'origine, jamais un second.

Shell
curl -s https://pesa-bridge.com/api/bridgepay/v1/partner/b2c \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"to_msisdn":"254708374149","amount":2500,"remarks":"Refund #91","idem":"refund-91"}'

Second facteur : Initiator et SecurityCredential

Protégez les appels de sortie d'argent par un second facteur. Définissez une fois un mot de passe initiateur avec POST /partner/initiator. Dès lors, les décaissements et les annulations doivent porter initiator et un security_credential : ce mot de passe chiffré en RSA (PKCS#1 v1.5) avec notre certificat, encodé en base64.

  1. 1

    Télécharger le certificat

    GET /security/certificate renvoie notre certificat public X.509 (PEM).

  2. 2

    Chiffrer de votre côté

    Chiffrez le mot de passe initiateur avec ce certificat. Le mot de passe ne circule jamais en clair.

  3. 3

    Envoyer les deux champs

    Ajoutez initiator et security_credential à chaque décaissement ou annulation.

Créer un SecurityCredential
curl -s https://pesa-bridge.com/api/bridgepay/v1/security/certificate -o pesabridge.pem
openssl x509 -in pesabridge.pem -pubkey -noout > pesabridge_pub.pem
printf '%s' "$INITIATOR_PASSWORD" \
  | openssl pkeyutl -encrypt -pubin -inkey pesabridge_pub.pem -pkeyopt rsa_padding_mode:pkcs1 \
  | base64 -w0
Dans le bac à sable, POST /security/credential peut chiffrer un mot de passe de test pour vous. En production, chiffrez toujours sur votre propre serveur.

Synchrone ou asynchrone

Sans result_url, un décaissement répond une fois terminé. Avec result_url (et éventuellement timeout_url), vous recevez un accusé immédiat, et le Result final y est envoyé par POST, signé comme tout webhook : vérifiez-le de la même façon.

PrécédentPaiement hébergé et liens de paiementSuivant Webhooks

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.

Contacter le support