customer.transfer.success

Sent to your webhook URL when a bank transfer is confirmed. The wallet was debited when POST /v2/wallet/transfer was called — this confirms funds have reached the recipient.

Always verify the X-Tulu-Switch-Signature header before processing. Respond 200 within 10 seconds.

Payload

{
  "event": "customer.transfer.success",
  "data": {
    "customerId": "cus_ada",
    "reference": "ctfr_1721375800000_abc123",
    "amount": 200,
    "currency": "NGN",
    "channel": "WALLET",
    "provider": "Paystack",
    "accountNumber": "0123456789",
    "bankCode": "058",
    "accountName": "John Doe"
  },
  "timestamp": "2026-08-25T09:05:00.000Z"
}