Disbursement

La fonctionnalité Disbursement permet aux partenaire de retirer de l’argent de leur portefeuille Yabetoo vers un compte Mobile Money (MoMo) ou un autre mode de paiement.

Veuillez noter que l’API disbursement est exclusivement accessible aux comptes partenaires. Pour obtenir l’accès à cette fonctionnalité, nous vous invitons à nous en faire la demande.

Authentification

Avant d’interagir avec l’API de retrait, vous devez obtenir votre clé secrète (secret_key) depuis votre tableau de bord Yabetoo. Cette clé est essentielle pour authentifier vos requêtes et doit être conservée en toute sécurité.

Création d’un disbursement

Pour initier un retrait, envoyez une requête POST à l’endpoint /disbursement avec les informations nécessaires.

prod https://pay.api.yabetoopay.com/v1/disbursement

sandbox https://pay.sandbox.yabetoopay.com/v1/disbursement

Headers

Name	Type	Description
Authorization*	Bearer {secret_key)

Body

{
    "amount": 10000,
    "currency": "XAF",
    "first_name": "Jean",
    "last_name": "Dupont",
    "payment_method_data": {
        "type": "momo",
        "momo": {
            "msisdn": "242066594471",
            "country": "CG",
            "operator_name": "mtn"
        }
    }
}

Response

{
    "amount": 1000,
    "currency": "xaf",
    "status": "processing",
    "firstName": "Jean",
    "lastName": "Dupont",
    "operatorName": "mtn",
    "country": "cg",
    "phone": "242066594470",
    "object": "disbursement",
    "type": 1,
    "shouldExecutedAt": "2025-03-18T09:24:57.555Z",
    "id": "wt_RMqehxy8NNi1ocJFG2SSAZMj81m6spo72vnZ",
    "createdAt": "2025-03-17T10:24:57.559+01:00",
    "updatedAt": "2025-03-17T10:24:57.559+01:00"
}

Disbursement : Traitement asynchrone

Les disbursements (versements sortants) sont exécutés de manière asynchrone, généralement à J+1 après la création de la demande.

Délai de traitement

Une fois un disbursement créé via l’API, celui-ci est planifié pour être exécuté automatiquement le jour suivant (J+1).

Ce traitement différé est nécessaire pour des raisons de sécurité et de validation.

Notification via Webhook

Afin d’être informé en temps réel de l’exécution d’un disbursement, vous devez créer un webhook de type disbursement.complete

Ce webhook est déclenché automatiquement dès que le disbursement est effectivement exécuté.

Exemple de payload

Voici un exemple de payload reçu lors de l'exécution d'un disbursement

{
  "id": "wt_QD4hRIXUKauNVEAac6jde6gF8rOgJfCG3icW",
  "object": "disbursement",
  "walletId": "wa_pccbQrBBOVJMV8tGduoXjEhoQDnaD4p3hgDE",
  "financialTransactionId": "1564701440",
  "transactionId": "6d5e238d-fb82-43d2-bfc1-e4d710139c7e",
  "amount": 1000,
  "currency": "xaf",
  "status": "succeeded",
  "failureCode": null,
  "externalId": "ext_dCkwMdCjRoh3WDuCksW22DDSqmIh1BBFEVKb",
  "createdAt": "2025-03-15T18:03:37.460+01:00",
  "updatedAt": "2025-03-16T14:00:11.628+01:00",
  "executedAt": "2025-03-16T13:00:11.628Z",
  "shouldExecutedAt": "2025-03-15T23:00:00.000Z",
  "otp": null,
  "phone": "242066594470",
  "country": "cg",
  "operatorName": "mtn",
  "firstName": "Jhon",
  "lastName": "Doe",
  "type": 1
}