Payin
This section provides a list of possible events that can be received as webhooks for Collections.
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-260824084512935",
"entityId": "OR-260824084510658599961753082",
"entityType": "order",
"status": "initiated",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250204210803110",
"firstName": "John",
"lastName": "Doe",
"country": "IN",
"createdAt": "2025-02-04T17:08:04.495Z"
},
"order": {
"orderId": "OR-260824084510658599961753082",
"type": "payin",
"fiatTicker": "EUR",
"cryptoTicker": "",
"cryptoNetwork": "",
"fiatAmount": 1000,
"cryptoAmount": 0,
"paymentType": "sepa_bank_va",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T08:45:10.864Z",
"customerOrderId": "OR-260824084510658599961753082",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"withdrawAmount": 19634515,
"withdrawCurrency": "IDR",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "EUR",
"sourceAmount": 1000,
"sourceAmountInUsd": 1166.39,
"sourceCurrencyType": "fiat",
"destinationCurrency": "IDR",
"destinationAmount": 19634514.654943354,
"destinationAmountInUsd": 1108.07,
"destinationCurrencyType": "fiat",
"conversionRate": 20667.91016309827,
"minLimit": 23,
"maxLimit": 85734.72,
"direction": "forward",
"processingFee": 50,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "EUR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 50,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-74fab7e7-43b-2e36582df483"
}
}
}
},
"createdAt": "2026-08-24T08:45:12.399Z"
}{
"eventId": "EV-260824084512935",
"entityId": "OR-260824084510658599961753082",
"entityType": "order",
"status": "fund_settled",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250204210803110",
"firstName": "John",
"lastName": "Doe",
"country": "IN",
"createdAt": "2025-02-04T17:08:04.495Z"
},
"order": {
"orderId": "OR-260824084510658599961753082",
"type": "payin",
"fiatTicker": "EUR",
"cryptoTicker": "",
"cryptoNetwork": "",
"fiatAmount": 1000,
"cryptoAmount": 0,
"paymentType": "sepa_bank_va",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T08:45:10.864Z",
"customerOrderId": "OR-260824084510658599961753082",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"withdrawAmount": 19634515,
"withdrawCurrency": "IDR",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "EUR",
"sourceAmount": 1000,
"sourceAmountInUsd": 1166.39,
"sourceCurrencyType": "fiat",
"destinationCurrency": "IDR",
"destinationAmount": 19634514.654943354,
"destinationAmountInUsd": 1108.07,
"destinationCurrencyType": "fiat",
"conversionRate": 20667.91016309827,
"minLimit": 23,
"maxLimit": 85734.72,
"direction": "forward",
"processingFee": 50,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "EUR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 50,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-74fab7e7-43b-2e36582df483"
}
}
}
},
"createdAt": "2026-08-24T08:45:12.399Z"
}{
"eventId": "EV-260824084512935",
"entityId": "OR-260824084510658599961753082",
"entityType": "order",
"status": "fund_failed",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250204210803110",
"firstName": "John",
"lastName": "Doe",
"country": "IN",
"createdAt": "2025-02-04T17:08:04.495Z"
},
"order": {
"orderId": "OR-260824084510658599961753082",
"type": "payin",
"fiatTicker": "EUR",
"cryptoTicker": "",
"cryptoNetwork": "",
"fiatAmount": 1000,
"cryptoAmount": 0,
"paymentType": "sepa_bank_va",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T08:45:10.864Z",
"customerOrderId": "OR-260824084510658599961753082",
"failureCode": "PAYMENT_NOT_COMPLETED",
"failureMessage": "Payment was not completed. Please try again.",
"bankTxnId": [],
"withdrawAmount": 19634515,
"withdrawCurrency": "IDR",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "EUR",
"sourceAmount": 1000,
"sourceAmountInUsd": 1166.39,
"sourceCurrencyType": "fiat",
"destinationCurrency": "IDR",
"destinationAmount": 19634514.654943354,
"destinationAmountInUsd": 1108.07,
"destinationCurrencyType": "fiat",
"conversionRate": 20667.91016309827,
"minLimit": 23,
"maxLimit": 85734.72,
"direction": "forward",
"processingFee": 50,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "EUR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 50,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-74fab7e7-43b-2e36582df483"
}
}
}
},
"createdAt": "2026-08-24T08:45:12.399Z"
}{
"eventId": "EV-260824084512935",
"entityId": "OR-260824084510658599961753082",
"entityType": "order",
"status": "initiated",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250204210803110",
"firstName": "Sumanth",
"lastName": "Devadiga",
"country": "IN",
"createdAt": "2025-02-04T17:08:04.495Z"
},
"order": {
"orderId": "OR-260824084510658599961753082",
"type": "payin",
"fiatTicker": "EUR",
"cryptoTicker": "",
"cryptoNetwork": "",
"fiatAmount": 1000,
"cryptoAmount": 0,
"paymentType": "sepa_bank_va",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T08:45:10.864Z",
"customerOrderId": "OR-260824084510658599961753082",
"failureCode": "NAME_NOT_MATCHED",
"failureMessage": "Name verification failed. Please check the account details.",
"bankTxnId": [],
"withdrawAmount": 19634515,
"withdrawCurrency": "IDR",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "EUR",
"sourceAmount": 1000,
"sourceAmountInUsd": 1166.39,
"sourceCurrencyType": "fiat",
"destinationCurrency": "IDR",
"destinationAmount": 19634514.654943354,
"destinationAmountInUsd": 1108.07,
"destinationCurrencyType": "fiat",
"conversionRate": 20667.91016309827,
"minLimit": 23,
"maxLimit": 85734.72,
"direction": "forward",
"processingFee": 50,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "EUR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 50,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-74fab7e7-43b-2e36582df483"
}
}
}
},
"createdAt": "2026-08-24T08:45:12.399Z"
}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-260824090624555",
"entityId": "OR-260824090621863756038529903",
"entityType": "order",
"status": "initiated",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250204210803110",
"firstName": "John",
"lastName": "Dev",
"country": "IN",
"createdAt": "2025-02-04T17:08:04.495Z"
},
"order": {
"orderId": "OR-260824090621863756038529903",
"type": "payin",
"depositCurrency": "SOL",
"depositAmount": 20,
"withdrawCurrency": "USDC",
"withdrawAmount": 1788.66,
"walletAddress": "BfxbAgniTmY9uqzWXSdSZ73QFseRyhbUSsZJXwK2QuEX",
"createdAt": "2026-08-24T09:06:22.995Z",
"customerOrderId": "OR-260824090621863756038529903",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "SOL",
"sourceAmount": 20,
"sourceAmountInUsd": 1882.33,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDC",
"destinationAmount": 1788.66,
"destinationAmountInUsd": 1788.22,
"destinationCurrencyType": "crypto",
"conversionRate": 94.14000000000001,
"processingFee": 1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 1,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f56f429d-d06b-408",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T09:06:24.541Z"
}{
"eventId": "EV-260824090624555",
"entityId": "OR-260824090621863756038529903",
"entityType": "order",
"status": "asset_settled",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250204210803110",
"firstName": "Sumanth",
"lastName": "Devadiga",
"country": "IN",
"createdAt": "2025-02-04T17:08:04.495Z"
},
"order": {
"orderId": "OR-260824090621863756038529903",
"type": "payin",
"depositCurrency": "SOL",
"depositAmount": 20,
"withdrawCurrency": "USDC",
"withdrawAmount": 1788.66,
"walletAddress": "BfxbAgniTmY9uqzWXSdSZ73QFseRyhbUSsZJXwK2QuEX",
"createdAt": "2026-08-24T09:06:22.995Z",
"customerOrderId": "OR-260824090621863756038529903",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "SOL",
"sourceAmount": 20,
"sourceAmountInUsd": 1882.33,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDC",
"destinationAmount": 1788.66,
"destinationAmountInUsd": 1788.22,
"destinationCurrencyType": "crypto",
"conversionRate": 94.14000000000001,
"processingFee": 1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 1,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f56f429d-d06b-408b-9623-",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T09:06:24.541Z"
}Updated 8 days ago
Did this page help you?