Offramp

To have the real-time updates between TransFi and Customers, we are configuring the webhook events to be sent to Customers on below events.

Events	Event Type	Status	Descriptions
Payment Initiated	Order	`initiated`	Post confirming the order details and payment method selection, the user will be redirecting to the payment checkout page
Crypto Recieved	Order	`asset_deposited`	TransFi has recieved the crypto from the user.
Payment Sent	Order	`fund_settled`	User has recieved the fiat.
Payment Failed	Order	`fund_failed`	The payment is declined from the user's bank.
Expired	Order	`expired`	Order expired due to inactivity.

Sample Event For Order:

{
  "eventId": "EV-260306070900332",
  "entityId": "OR-2603060708437341394",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060708437341394",
    "type": "sell",
    "depositCurrency": "USDC",
    "depositAmount": 47,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 37.71,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:08:55.340Z",
    "customerOrderId": "transfer-1234"
  },
  "createdAt": "2026-03-06T07:09:00.534Z"
}

{
  "eventId": "EV-260306071156178",
  "entityId": "OR-2603060708437341394",
  "entityType": "order",
  "status": "asset_deposited",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060708437341394",
    "type": "sell",
    "depositCurrency": "USDC",
    "depositAmount": 47,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 37.71,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:08:55.340Z",
    "customerOrderId": "transfer-1234"
  },
  "createdAt": "2026-03-06T07:11:56.127Z"
}

{
  "eventId": "EV-260306072647531",
  "entityId": "OR-2603060708437341394",
  "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-2603060708437341394",
    "type": "sell",
    "depositCurrency": "USDC",
    "depositAmount": 47,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 37.71,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:08:55.340Z",
    "customerOrderId": "transfer-1234"
  },
  "createdAt": "2026-03-06T07:26:47.932Z"
}

{
  "eventId": "EV-260306072647531",
  "entityId": "OR-2603060708437341394",
  "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-2603060708437341394",
    "type": "sell",
    "depositCurrency": "USDC",
    "depositAmount": 47,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 37.71,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:08:55.340Z",
    "customerOrderId": "transfer-1234",
    "failureCode": "INVALID_ACCOUNT_DETAILS",
    "failureMessage": "Invalid account details provided. Please check and try again."
  },
  "createdAt": "2026-03-06T07:26:47.932Z"
}

{
  "eventId": "EV-260306072647531",
  "entityId": "OR-2603060708437341394",
  "entityType": "order",
  "status": "expired",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060708437341394",
    "type": "sell",
    "depositCurrency": "USDC",
    "depositAmount": 47,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 37.71,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:08:55.340Z",
    "customerOrderId": "transfer-1234"
  },
  "createdAt": "2026-03-06T07:26:47.932Z"
}