Payouts

This section provides a list of possible events that can be received as webhooks for Payouts.

Event types

EventsEvent TypeStatusDescriptions
Payment InitiatedOrderinitiatedPayout order request has been successfully initiated.
Payment ScheduledOrderfund_scheduledPayout order has been successfully scheduled.
Payment CompletedOrderfund_settledUser has received the funds and the confirmation is received from the bank.
Payment FailedOrderfund_failedFund 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

EventsEvent TypeStatusDescriptions
Payment InitiatedOrderinitiatedPayout order request has been successfully initiated.
Payment ScheduledOrderasset_depositedPayout order has been successfull.
Payment FailedOrderfund_deposit_failedFund 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"
}