{
"event": "order.created",
"data": {
"reference": "ORD-20260627-ABC123",
"merchant_reference": null,
"customer_reference": "cust-001",
"type": "onramp",
"from": {
"currency": "NGN",
"amount": 50000
},
"to": {
"currency": "USDT",
"network": "BSC",
"amount": 32.15
},
"pricing": {
"base_currency": "NGN",
"quote_currency": "USDT",
"exchange_rate": 1555.2
},
"fee": {
"currency": "USDT",
"protocol_fee": 0.3,
"partner_fee": 0,
"total": 0.5
},
"metadata": null,
"amount_paid": 0,
"amount_settled": 0,
"amount_refunded": 0,
"percentage_settled": 0,
"status": "awaiting_user_payment",
"created_at": "2026-06-27T12:00:00.000Z",
"updated_at": "2026-06-27T12:00:00.000Z"
}
}Webhooks
Ordercreated
Sent when a new order is created. Payload matches the order list shape.
WEBHOOK
orderCreated
{
"event": "order.created",
"data": {
"reference": "ORD-20260627-ABC123",
"merchant_reference": null,
"customer_reference": "cust-001",
"type": "onramp",
"from": {
"currency": "NGN",
"amount": 50000
},
"to": {
"currency": "USDT",
"network": "BSC",
"amount": 32.15
},
"pricing": {
"base_currency": "NGN",
"quote_currency": "USDT",
"exchange_rate": 1555.2
},
"fee": {
"currency": "USDT",
"protocol_fee": 0.3,
"partner_fee": 0,
"total": 0.5
},
"metadata": null,
"amount_paid": 0,
"amount_settled": 0,
"amount_refunded": 0,
"percentage_settled": 0,
"status": "awaiting_user_payment",
"created_at": "2026-06-27T12:00:00.000Z",
"updated_at": "2026-06-27T12:00:00.000Z"
}
}Body
application/json
Response
200
Acknowledged