Webhook Event Model

FieldTypeDescriptionNullable
event.typeEnum(String)Type of webhook event: 'payout_received', 'payout_cancelled', 'payout_failed', 'payout_completed'false
dataPayoutsTransaction Detailsfalse

Sample successful webhook event response

{ "event.type": "payout_received", "data": { "id": 1738, "amount": 5, "uid": 7, "businessId": 6, "walletId": 39, "bankId": 644, "refid": "33616792301", "currency": "NGN", "channel": "bank", "status": "pending", "meta": { "bank": { "id": 644, "uid": 7, "businessId": 6, "defaultBank": false, "maskedaccountnumber": "*****678314", "bankname": "GUARANTY TRUST BANK", "beneficiaryname": "SALAMI MURITALA OLAYIWOLA", "beneficiarycountry": "NGN", "type": "bank", "email": null, "createdAt": "2023-04-29T13:49:01.000Z", "updatedAt": "2023-04-29T13:49:01.000Z", "deletedAt": null }, "total": 5, "fee": [ { "percent": false, "fee": 0, "reason": "payout-charge" } ] }, "updatedAt": "2023-06-30T20:48:56.217Z", "createdAt": "2023-06-30T20:48:56.217Z" } }

Sample cancelled webhook event response

{ "event.type": "payout_cancelled", "data": { "id": 1734, "uid": 7, "businessId": 6, "walletId": 39, "amount": 5, "refid": "69506479732", "bankId": 644, "channel": "bank", "currency": "NGN", "meta": { "fee": [ { "fee": 0, "reason": "payout-charge", "percent": false } ], "bank": { "id": 644, "uid": 7, "type": "bank", "email": null, "bankname": "GUARANTY TRUST BANK", "createdAt": "2023-04-29T13:49:01.000Z", "deletedAt": null, "updatedAt": "2023-04-29T13:49:01.000Z", "businessId": 6, "defaultBank": false, "beneficiaryname": "SALAMI MURITALA OLAYIWOLA", "beneficiarycountry": "NGN", "maskedaccountnumber": "*****678314" }, "total": 5 }, "status": "cancelled", "providerId": null, "provider": null, "reason": null, "createdAt": "2023-06-30T20:39:10.000Z", "updatedAt": "2023-07-05T13:03:31.572Z", "deletedAt": null } }

Sample failed webhook event response

{ "event.type": "payout_failed", "data": { "id": 1734, "uid": 7, "businessId": 6, "walletId": 39, "amount": 5, "refid": "69506479732", "bankId": 644, "channel": "bank", "currency": "NGN", "meta": { "fee": [ { "fee": 0, "reason": "payout-charge", "percent": false } ], "bank": { "id": 644, "uid": 7, "type": "bank", "email": null, "bankname": "GUARANTY TRUST BANK", "createdAt": "2023-04-29T13:49:01.000Z", "deletedAt": null, "updatedAt": "2023-04-29T13:49:01.000Z", "businessId": 6, "defaultBank": false, "beneficiaryname": "SALAMI MURITALA OLAYIWOLA", "beneficiarycountry": "NGN", "maskedaccountnumber": "*****678314" }, "total": 5 }, "status": "failed", "providerId": null, "provider": null, "reason": null, "createdAt": "2023-06-30T20:39:10.000Z", "updatedAt": "2023-07-05T13:03:31.572Z", "deletedAt": null } }

Sample Successful Webhook event response

{ "event.type": "payout_completed", "data": { "id": 1734, "uid": 7, "businessId": 6, "walletId": 39, "amount": 5, "refid": "69506479732", "bankId": 644, "channel": "bank", "currency": "NGN", "meta": { "fee": [ { "fee": 0, "reason": "payout-charge", "percent": false } ], "bank": { "id": 644, "uid": 7, "type": "bank", "email": null, "bankname": "GUARANTY TRUST BANK", "createdAt": "2023-04-29T13:49:01.000Z", "deletedAt": null, "updatedAt": "2023-04-29T13:49:01.000Z", "businessId": 6, "defaultBank": false, "beneficiaryname": "SALAMI MURITALA OLAYIWOLA", "beneficiarycountry": "NGN", "maskedaccountnumber": "*****678314" }, "total": 5 }, "status": "completed", "providerId": null, "provider": null, "reason": null, "createdAt": "2023-06-30T20:39:10.000Z", "updatedAt": "2023-07-05T13:03:31.572Z", "deletedAt": null } }