Offramp
This section provides a list of possible events that can be received as webhooks for Collections.
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-260824111425459",
"entityId": "OR-260824111423413832397538943",
"entityType": "order",
"status": "initiated",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824111423413832397538943",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDC",
"cryptoNetwork": "",
"fiatAmount": 200,
"cryptoAmount": 61.754114,
"paymentType": "bank_transfer",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T11:14:23.730Z",
"customerOrderId": "OR-260824111423413832397538943",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 61.754114,
"sourceAmountInUsd": 61.74,
"sourceCurrencyType": "crypto",
"destinationCurrency": "AED",
"destinationAmount": 200,
"destinationAmountInUsd": 55.57,
"destinationCurrencyType": "fiat",
"conversionRate": 0.2778935667639294,
"processingFee": 22.22,
"processingFeeRate": 0.1,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 22.22,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-8b75217b-6b2c-422c-b808-500d4950cfb5",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T11:14:25.311Z"
}{
"eventId": "EV-260824111425459",
"entityId": "OR-260824111423413832397538943",
"entityType": "order",
"status": "asset_deposited",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824111423413832397538943",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDC",
"cryptoNetwork": "",
"fiatAmount": 200,
"cryptoAmount": 61.754114,
"paymentType": "bank_transfer",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T11:14:23.730Z",
"customerOrderId": "OR-260824111423413832397538943",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 61.754114,
"sourceAmountInUsd": 61.74,
"sourceCurrencyType": "crypto",
"destinationCurrency": "AED",
"destinationAmount": 200,
"destinationAmountInUsd": 55.57,
"destinationCurrencyType": "fiat",
"conversionRate": 0.2778935667639294,
"processingFee": 22.22,
"processingFeeRate": 0.1,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 22.22,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-8b75217b-6b2c-422c-b808-500d4950cfb5",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T11:14:25.311Z"
}{
"eventId": "EV-260824111425459",
"entityId": "OR-260824111423413832397538943",
"entityType": "order",
"status": "fund_settled",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824111423413832397538943",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDC",
"cryptoNetwork": "",
"fiatAmount": 200,
"cryptoAmount": 61.754114,
"paymentType": "bank_transfer",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T11:14:23.730Z",
"customerOrderId": "OR-260824111423413832397538943",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 61.754114,
"sourceAmountInUsd": 61.74,
"sourceCurrencyType": "crypto",
"destinationCurrency": "AED",
"destinationAmount": 200,
"destinationAmountInUsd": 55.57,
"destinationCurrencyType": "fiat",
"conversionRate": 0.2778935667639294,
"processingFee": 22.22,
"processingFeeRate": 0.1,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 22.22,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-8b75217b-6b2c-422c-b808-500d4950cfb5",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T11:14:25.311Z"
}{
"eventId": "EV-260824111425459",
"entityId": "OR-260824111423413832397538943",
"entityType": "order",
"status": "fund_failed",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824111423413832397538943",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDC",
"cryptoNetwork": "",
"fiatAmount": 200,
"cryptoAmount": 61.754114,
"paymentType": "bank_transfer",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T11:14:23.730Z",
"customerOrderId": "OR-260824111423413832397538943",
"customerOrderId": "transfer-1234",
"failureCode": "INVALID_ACCOUNT_DETAILS",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 61.754114,
"sourceAmountInUsd": 61.74,
"sourceCurrencyType": "crypto",
"destinationCurrency": "AED",
"destinationAmount": 200,
"destinationAmountInUsd": 55.57,
"destinationCurrencyType": "fiat",
"conversionRate": 0.2778935667639294,
"processingFee": 22.22,
"processingFeeRate": 0.1,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 22.22,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-8b75217b-6b2c-422c-b808-500d4950cfb5",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T11:14:25.311Z"
}{
"eventId": "EV-260824111425459",
"entityId": "OR-260824111423413832397538943",
"entityType": "order",
"status": "expired",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824111423413832397538943",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDC",
"cryptoNetwork": "",
"fiatAmount": 200,
"cryptoAmount": 61.754114,
"paymentType": "bank_transfer",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "",
"createdAt": "2026-08-24T11:14:23.730Z",
"customerOrderId": "OR-260824111423413832397538943",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 61.754114,
"sourceAmountInUsd": 61.74,
"sourceCurrencyType": "crypto",
"destinationCurrency": "AED",
"destinationAmount": 200,
"destinationAmountInUsd": 55.57,
"destinationCurrencyType": "fiat",
"conversionRate": 0.2778935667639294,
"processingFee": 22.22,
"processingFeeRate": 0.1,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 22.22,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-8b75217b-6b2c-422c-b808-500d4950cfb5",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T11:14:25.311Z"
}Updated 8 days ago
Did this page help you?