​
Webhooks and Callbacks

On every disbursement confirmation we get from the provider/MNO, we send the following to your webhook with us. First lets define the fields

FieldDescription
statusThis is the status of the disbursemet. this can be success or failed
clientIdThis is your clientId
amountThis is the amount of the transaction in kobo
chargeThis is the charge the customer was paid
referenceThis is the unique reference generated by Payfonte for this transaction.
externalReferenceThis is the reference sent to us by you when initializing the transaction.
providerThis is the provider used for this transaction
disbursement.status
{
    "event": "disbursement.status",
    "clientId": "payfusion",
    "data": {
        "clientId": "payfusion",
        "type": "disbursement",
        "status": "success",
        "statusDescription": "success",
        "reference": "L20250614142024AAAAA",
        "providersReference": "reference-from-mno",
        "externalReference": "merchant-reference",
        "currency": "XOF",
        "country": "BJ",
        "transferRecipientId": "684d561743dac722bcd43e9f",
        "transferRecipientLabel": "MTN MoMo | 2290123456789",
        "charge": 180,
        "amount": 10000,
        "provider": "mtn-momo-benin",
        "providerLabel": "MTN MoMo",
        "providerLogo": "https://payfonte.s3.amazonaws.com/mtn-momo.png",
        "channel": "mobile-money",
        "timestamp": "2025-06-14T14:20:25.023Z",
        "narration": "disbursement narration here",
        "completedAt": 1749910827
    },
    "deliveryId": "684d852b27e08e60f4d09103"
}