customer.deposit.failed

Sent to your webhook URL when a deposit attempt is rejected or abandoned by the provider. The wallet balance is unchanged.

Always verify the X-Tulu-Switch-Signature header before processing. Respond 200 within 10 seconds. Failed deliveries retry up to 3 times.

Headers

X-Tulu-Switch-Signature

String

HMAC-SHA256 of the raw request body.

X-Tulu-Switch-Event

String

customer.deposit.failed

X-Tulu-Switch-Timestamp

String

ISO 8601 dispatch timestamp.

Payload

{
  "event": "customer.deposit.failed",
  "data": {
    "customerId": "cus_ada",
    "reference": "cdep_1721375800000_abc123",
    "amount": 5000,
    "currency": "NGN",
    "channel": "WALLET",
    "provider": "Paystack",
    "reason": "Payment abandoned"
  },
  "timestamp": "2026-08-25T09:01:00.000Z"
}