Envoyez de l’argent à des bénéficiaires via une méthode enregistrée ou des détails fournis à la volée.

API Payouts

Les payouts servent à décaisser vers des utilisateurs, partenaires ou commerçants.

Headers requis

X-Public-Key: YOUR_PUBLIC_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256_SIGNATURE

Endpoints

GET /api/v1/payouts

POST /api/v1/payouts

GET /api/v1/payouts/{id}

POST /api/v1/payouts/{id}/cancel

Initier un payout

POST /api/v1/payouts

Champs de requête

Paramètre	Type	Requis	Description
amount	number	Oui	Montant
currency	string	Oui	Code ISO
country	string	Non	Pays du bénéficiaire
payment_method_id	string	Conditionnel	Méthode enregistrée
recipient_phone	string	Conditionnel	Téléphone si aucune méthode enregistrée
operator_code	string	Conditionnel	Opérateur si aucune méthode enregistrée
recipient_first_name	string	Non	Prénom
recipient_last_name	string	Non	Nom
external_id	string	Non	Référence interne
description	string	Non	Description métier
metadata	object	Non	Métadonnées

Vous devez fournir soit :

payment_method_id

soit recipient_phone et operator_code

Exemple

curl -X POST "{{BASE_URL}}/api/v1/payouts" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000,
    "currency": "XAF",
    "recipient_phone": "+237677001122",
    "operator_code": "MTN_CM",
    "recipient_first_name": "Jean",
    "recipient_last_name": "Mballa",
    "external_id": "payout_9001",
    "description": "Vendor settlement"
  }'

Consulter un payout

GET /api/v1/payouts/{id}

Annuler un payout

POST /api/v1/payouts/{id}/cancel

L’annulation dépend du statut courant et du provider aval.

API Payouts

On this page