This section provides the list of webhook events that can be received for Payin (Collections) orders.

To enable real-time updates between TransFi and Customers, webhook notifications are triggered throughout the complete order lifecycle.

Fiat Payin Order Events

Order Statuses

Event	Entity Type	Status	Description
Payment Initiated	Order	`initiated`	After confirming the order details, wallet address, and payment method selection, the user is redirected to the payment checkout page
Payment Processing	Order	`fund_processing`	The user has submitted payment details and the payment is being processed/confirmed by the bank
Payment Authorised	Order	`fund_settled`	User has successfully submitted payment details and the payment has been confirmed by the bank
Payment Unauthorised	Order	`fund_failed`	User submitted payment details, but the payment was declined by the bank
Manual Review	Order	`manual_review`	The order has been placed on hold for manual review by the compliance team

Sample Webhook Payloads

{
  "eventId": "EV-260305125748417",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051257371591318",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T12:57:45.963Z",
    "customerOrderId": "OR-2603051257371591318"
  },
  "createdAt": "2026-03-05T12:57:48.300Z"
}

{
  "eventId": "EV-260305134150953",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "fund_settled",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051257371591318",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T12:57:45.963Z",
    "customerOrderId": "OR-2603051257371591318"
  },
  "createdAt": "2026-03-05T13:41:50.150Z"
}

{
  "eventId": "EV-260305134619934",
  "entityId": "OR-2603051342464057762",
  "entityType": "order",
  "status": "fund_failed",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051342464057762",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T13:42:55.268Z",
    "customerOrderId": "OR-2603051342464057762",
    "failureCode": "PAYMENT_NOT_COMPLETED",
    "failureMessage": "Payment was not completed. Please try again."
  },
  "createdAt": "2026-03-05T13:46:19.204Z"
}

{
  "eventId": "EV-260305135517882",
  "entityId": "OR-2603051354232446017",
  "entityType": "order",
  "status": "manual_review",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051354232446017",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T13:54:31.749Z",
    "customerOrderId": "OR-2603051354232446017",
    "failureCode": "NAME_NOT_MATCHED",
    "failureMessage": "Name verification failed. Please check the account details."
  },
  "createdAt": "2026-03-05T13:55:17.472Z"
}

{
  "eventId": "EV-260305125748417",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "fund_processing",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051257371591318",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T12:57:45.963Z",
    "customerOrderId": "OR-2603051257371591318"
  },
  "createdAt": "2026-03-05T12:58:30.300Z"
}

Crypto Payin Order Events

Order Statuses

Event	Entity Type	Status	Description
Payment Initiated	Order	`initiated`	After confirming the order details, wallet address, and payment method selection, the order is created and awaiting payment
Payment Authorised	Order	`asset_settled`	User has successfully completed the crypto payment
Payment Expired	Order	`expired`	The order expired before the user completed the payment

Sample Webhook Payloads

{
  "eventId": "EV-260305140224124",
  "entityId": "OR-2603051402100691567",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051402100691567",
    "type": "payin",
    "depositCurrency": "USDT",
    "depositAmount": 58,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 48.45,
    "walletAddress": "0x44E69A10637456E3ce4b5eCeb17b25a9127C1A82",
    "createdAt": "2026-03-05T14:02:19.931Z",
    "customerOrderId": "OR-2603051402100691567"
  },
  "createdAt": "2026-03-05T14:02:24.774Z"
}

{
  "eventId": "EV-260305141724379",
  "entityId": "OR-2603051402100691567",
  "entityType": "order",
  "status": "asset_settled",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051402100691567",
    "type": "payin",
    "depositCurrency": "USDT",
    "depositAmount": 58,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 48.45,
    "walletAddress": "0x44E69A10637456E3ce4b5eCeb17b25a9127C1A82",
    "createdAt": "2026-03-05T14:02:19.931Z",
    "customerOrderId": "OR-2603051402100691567"
  },
  "createdAt": "2026-03-05T14:17:24.172Z"
}

{
  "eventId": "EV-260305142000777",
  "entityId": "OR-2603051354232446017",
  "entityType": "order",
  "status": "expired",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051354232446017",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T13:54:31.749Z",
    "customerOrderId": "OR-2603051354232446017",
    "failureCode": "ORDER_EXPIRED",
    "failureMessage": "The order expired before payment was completed."
  },
  "createdAt": "2026-03-05T14:20:00.777Z"
}