Payouts
This section provides a list of possible events that can be received as webhooks for Payouts.
Event types
| Events | Event Type | Status | Descriptions |
|---|---|---|---|
| Payment Initiated | Order | initiated | Payout order request has been successfully initiated. |
| Payment Scheduled | Order | fund_scheduled | Payout order has been successfully scheduled. |
| Payment Completed | Order | fund_settled | User has received the funds and the confirmation is received from the bank. |
| Payment Failed | Order | fund_failed | Fund has been failed to send to the user's account. |
Sample Event For Order:
{
"eventId": "EV-260306060254195",
"entityId": "OR-2603060602374205436",
"entityType": "order",
"status": "initiated",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060602374205436",
"type": "payout",
"depositCurrency": "USDC",
"depositAmount": 11.849139,
"withdrawCurrency": "EUR",
"withdrawAmount": 10,
"walletAddress": "",
"createdAt": "2026-03-06T06:02:48.847Z",
"customerOrderId": "OR-2603060602374205436"
},
"createdAt": "2026-03-06T06:02:54.714Z"
}{
"eventId": "EV-260306061816372",
"entityId": "OR-2603060616554559372",
"entityType": "order",
"status": "fund_settled",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060616554559372",
"type": "payout",
"depositCurrency": "USDC",
"depositAmount": 11.849139,
"withdrawCurrency": "EUR",
"withdrawAmount": 10,
"walletAddress": "",
"createdAt": "2026-03-06T06:17:04.935Z",
"customerOrderId": "OR-2603060616554559372"
},
"createdAt": "2026-03-06T06:18:16.734Z"
}{
"eventId": "EV-260306062147804",
"entityId": "OR-2603060618504996194",
"entityType": "order",
"status": "fund_failed",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060618504996194",
"type": "payout",
"depositCurrency": "USDC",
"depositAmount": 11.849139,
"withdrawCurrency": "EUR",
"withdrawAmount": 10,
"walletAddress": "",
"createdAt": "2026-03-06T06:18:59.160Z",
"customerOrderId": "OR-2603060618504996194",
"failureCode": "INVALID_ACCOUNT_DETAILS",
"failureMessage": "Invalid account details provided. Please check and try again."
},
"createdAt": "2026-03-06T06:21:47.597Z"
}Crypto payout order events
Event types
| Events | Event Type | Status | Descriptions |
|---|---|---|---|
| Payment Initiated | Order | initiated | Payout order request has been successfully initiated. |
| Payment Scheduled | Order | asset_deposited | Payout order has been successfull. |
| Payment Failed | Order | fund_deposit_failed | Fund has been failed to send to the user's account. |
Sample Events:
{
"eventId": "EV-260303142447632",
"entityId": "OR-2603031424333175002",
"entityType": "order",
"status": "initiated",
"user": {
"userId": "UX-251127054640133",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-11-27T05:46:41.322Z"
},
"order": {
"orderId": "OR-2603031424333175002",
"type": "payout",
"depositCurrency": "USDC",
"depositAmount": 10,
"withdrawCurrency": "USDTPOLYGON",
"withdrawAmount": 10,
"walletAddress": "",
"createdAt": "2026-03-03T14:24:45.909Z",
"customerOrderId": "OR-2603031424333175002"
},
"createdAt": "2026-03-03T14:24:47.812Z"
}{
"eventId": "EV-260303142501356",
"entityId": "OR-2603031424333175002",
"entityType": "order",
"status": "asset_deposited",
"user": {
"userId": "UX-251127054640133",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-11-27T05:46:41.322Z"
},
"order": {
"orderId": "OR-2603031424333175002",
"type": "payout",
"depositCurrency": "USDC",
"depositAmount": 10,
"withdrawCurrency": "USDTPOLYGON",
"withdrawAmount": 10,
"walletAddress": "",
"createdAt": "2026-03-03T14:24:45.909Z",
"customerOrderId": "OR-2603031424333175002"
},
"createdAt": "2026-03-03T14:25:01.731Z"
}Updated about 1 month ago