Payin

To enable real-time updates between TransFi and customers, we send a series of events throughout the order lifecycle.

Fiat Payin order events

Order statuses

Events	Event Type	Status	Descriptions
Payment Initiated	Order	`initiated`	Post confirming the order details, wallet address, and payment method selection, the user will be redirecting to the payment checkout page
Payment Authorised	Order	`fund_settled`	User has submitted the payment details on the payment checkout page and the confirmation is received from the bank
Payment Unauthorised	Order	`fund_failed`	User has submitted the payment details on the payment checkout page and the payment is declined from the bank
Manual Review	Order	`manual_review`	The order is hold for manual review by our compliance team.

Sample Events

{
  "eventId": "EV-260305125748417",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "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": "sumanth",
    "lastName": "d",
    "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": "sumanth",
    "lastName": "d",
    "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": "sumanth",
    "lastName": "d",
    "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"
}

Crypto Payin order events

Order statuses

Events	Event Type	Status	Descriptions
Payment Initiated	Order	`initiated`	Post confirming the order details, wallet address, and payment method selection, the user will be redirecting to the payment checkout page
Payment Authorised	Order	`asset_settled`	User has mad e the payment

Sample Event For Order:

{
  "eventId": "EV-260305140224124",
  "entityId": "OR-2603051402100691567",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "sumanth",
    "lastName": "d",
    "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": "sumanth",
    "lastName": "d",
    "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"
}