Onramp

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
Payment Authorised	Order	`fund_deposited`	User has submitted the payment details on the payment checkout page and the confirmation is received from the bank
Payment Unauthorised	Order	`fund_deposit_failed`	User has submitted the payment details on the payment checkout page and the payment is declined from the bank
Crypto Settled	Order	`asset_settled`	User has received the crypto
Crypto Settle Failed	Order	`asset_settle_failed`	User has failed received the crypto
Expired	Order	`expired`	Order expired due to inactivity

Sample Event For Order:

{
  "eventId": "EV-260306073123184",
  "entityId": "OR-2603060731092778452",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060731092778452",
    "type": "buy",
    "depositCurrency": "USD",
    "depositAmount": 50,
    "withdrawCurrency": "USDC",
    "withdrawAmount": 49.009901,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:31:20.310Z",
    "customerOrderId": "OR-2603060731092778452"
  },
  "createdAt": "2026-03-06T07:31:23.973Z"
}

{
  "eventId": "EV-260306073248939",
  "entityId": "OR-2603060731092778452",
  "entityType": "order",
  "status": "fund_deposited",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060731092778452",
    "type": "buy",
    "depositCurrency": "USD",
    "depositAmount": 50,
    "withdrawCurrency": "USDC",
    "withdrawAmount": 49.009901,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:31:20.310Z",
    "customerOrderId": "OR-2603060731092778452"
  },
  "createdAt": "2026-03-06T07:32:48.413Z"
}

{
  "eventId": "EV-260306073447146",
  "entityId": "OR-2603060733166489697",
  "entityType": "order",
  "status": "fund_deposit_failed",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060733166489697",
    "type": "buy",
    "depositCurrency": "USD",
    "depositAmount": 50,
    "withdrawCurrency": "USDC",
    "withdrawAmount": 49.009901,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:33:22.785Z",
    "customerOrderId": "OR-2603060733166489697",
    "failureCode": "PAYMENT_NOT_COMPLETED",
    "failureMessage": "Payment was not completed. Please try again."
  },
  "createdAt": "2026-03-06T07:34:47.296Z"
}

{
  "eventId": "EV-260306073347915",
  "entityId": "OR-2603060731092778452",
  "entityType": "order",
  "status": "asset_settled",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060731092778452",
    "type": "buy",
    "depositCurrency": "USD",
    "depositAmount": 50,
    "withdrawCurrency": "USDC",
    "withdrawAmount": 49.009901,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:31:20.310Z",
    "customerOrderId": "OR-2603060731092778452"
  },
  "createdAt": "2026-03-06T07:33:47.012Z"
}

{
  "eventId": "EV-260306073617460",
  "entityId": "OR-2603060734266872133",
  "entityType": "order",
  "status": "asset_settled_failed",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060734266872133",
    "type": "buy",
    "depositCurrency": "USD",
    "depositAmount": 50,
    "withdrawCurrency": "USDC",
    "withdrawAmount": 49.009901,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:34:33.564Z",
    "customerOrderId": "OR-2603060734266872133",
    "failureCode": "TRANSACTION_FAILED",
    "failureMessage": "Crypto transaction failed."
  },
  "createdAt": "2026-03-06T07:36:17.615Z"
}

{
  "eventId": "EV-260306073347915",
  "entityId": "OR-2603060731092778452",
  "entityType": "order",
  "status": "expired",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603060731092778452",
    "type": "buy",
    "depositCurrency": "USD",
    "depositAmount": 50,
    "withdrawCurrency": "USDC",
    "withdrawAmount": 49.009901,
    "walletAddress": "",
    "createdAt": "2026-03-06T07:31:20.310Z",
    "customerOrderId": "OR-2603060731092778452"
  },
  "createdAt": "2026-03-06T07:33:47.012Z"
}