customer.conversion.success

Sent to your webhook URL when a currency conversion completes. Conversions are synchronous — both wallets are already updated when this fires.

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

Payload

{
  "event": "customer.conversion.success",
  "data": {
    "customerId": "cus_ada",
    "reference": "ccvt_1721375800000_abc123",
    "fromCurrency": "USD",
    "toCurrency": "NGN",
    "fromAmount": 100,
    "toAmount": 164000,
    "rate": 1640,
    "channel": "WALLET"
  },
  "timestamp": "2026-08-25T09:10:00.000Z"
}