Swap
This section provides a list of possible events that can be received as webhooks for Onramp transactions.
To have the real-time updates between TransFi and Customers, we are configuring the webhook events to be sent to Customers.
Fiat swap
Events list
| Events | Status | Descriptions |
|---|---|---|
| Payment Initiated | initiated | Post confirming the order details and payment method selection, the user will be redirecting to the payment checkout page |
| Payment Authorised | fund_deposited | User has submitted the payment details on the payment checkout page and the confirmation is received from the bank |
| Payout Initiated | fund_processing | Fiat payment initiated |
| Payment Unauthorised | fund_failed | User has submitted the payment details on the payment checkout page and the payment is declined from the bank |
| Crypto Settled | fund_settled | User has received the crypto |
| Crypto Settle Failed | fund_settle_failed | User has failed received the crypto |
| Expired | expired | Order expired due to inactivity |
Sample Event For Order:
{
"eventId": "EV-260306081138371",
"entityId": "OR-2603060811261561282",
"entityType": "order",
"status": "initiated",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060811261561282",
"type": "swap",
"depositCurrency": "USD",
"depositAmount": 10,
"withdrawCurrency": "EUR",
"withdrawAmount": 8.44,
"walletAddress": "",
"createdAt": "2026-03-06T08:11:36.175Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T08:11:38.669Z"
}{
"eventId": "EV-260306081450658",
"entityId": "OR-2603060811261561282",
"entityType": "order",
"status": "fund_deposited",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060811261561282",
"type": "swap",
"depositCurrency": "USD",
"depositAmount": 10,
"withdrawCurrency": "EUR",
"withdrawAmount": 8.44,
"walletAddress": "",
"createdAt": "2026-03-06T08:11:36.175Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T08:14:50.270Z"
}{
"eventId": "EV-260306081848367",
"entityId": "OR-2603060814476369981",
"entityType": "order",
"status": "fund_deposit_failed",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060814476369981",
"type": "swap",
"depositCurrency": "USD",
"depositAmount": 10,
"withdrawCurrency": "EUR",
"withdrawAmount": 8.44,
"walletAddress": "",
"createdAt": "2026-03-06T08:14:59.379Z",
"customerOrderId": "abcd",
"failureCode": "PAYMENT_NOT_COMPLETED",
"failureMessage": "Payment was not completed. Please try again."
},
"createdAt": "2026-03-06T08:18:48.191Z"
}{
"eventId": "EV-260306081817962",
"entityId": "OR-2603060811261561282",
"entityType": "order",
"status": "fund_settled",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060811261561282",
"type": "swap",
"depositCurrency": "USD",
"depositAmount": 10,
"withdrawCurrency": "EUR",
"withdrawAmount": 8.44,
"walletAddress": "",
"createdAt": "2026-03-06T08:11:36.175Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T08:18:17.792Z"
}{
"eventId": "EV-260306082124601",
"entityId": "OR-2603060819550391209",
"entityType": "order",
"status": "fund_failed",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060819550391209",
"type": "swap",
"depositCurrency": "USD",
"depositAmount": 10,
"withdrawCurrency": "EUR",
"withdrawAmount": 8.44,
"walletAddress": "",
"createdAt": "2026-03-06T08:20:02.974Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T08:21:24.830Z"
}{
"eventId": "EV-260306081848367",
"entityId": "OR-2603060814476369981",
"entityType": "order",
"status": "expired",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060814476369981",
"type": "swap",
"depositCurrency": "USD",
"depositAmount": 10,
"withdrawCurrency": "EUR",
"withdrawAmount": 8.44,
"walletAddress": "",
"createdAt": "2026-03-06T08:14:59.379Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T08:18:48.191Z"
}Crypto swap
Events list
| Events | Status | Descriptions |
|---|---|---|
| Payment Initiated | initiated | Post confirming the order details and payment method selection, the user will be redirecting to the payment checkout page |
| Payment Authorised | asset_deposited | User has submitted the payment details on the payment checkout page and the confirmation is received from the bank |
| Payout Initiated | asset_processing | Fiat payment initiated |
| Payment Unauthorised | asset_deposit_failed | User has submitted the payment details on the payment checkout page and the payment is declined from the bank |
| Crypto Settled | asset_settled | User has received the crypto |
| Crypto Settle Failed | asset_settle_failed | User has failed received the crypto |
| Expired | expired | Order expired due to inactivity |
Sample Event For Order:
{
"eventId": "EV-260824112623575",
"entityId": "OR-260824112622050904850844331",
"entityType": "order",
"status": "initiated",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824112622050904850844331",
"type": "swap",
"depositCurrency": "USDTPOLYGON",
"depositAmount": 42,
"withdrawCurrency": "USDCSOL",
"withdrawAmount": 39.88783,
"walletAddress": "",
"createdAt": "2026-08-24T11:26:22.385Z",
"customerOrderId": "OR-260824112622050904850844331",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDTPOLYGON",
"sourceAmount": 42,
"sourceAmountInUsd": 41.99,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDCSOL",
"destinationAmountInUsd": 39.88,
"destinationCurrencyType": "crypto",
"conversionRate": 0.9999103871091857,
"processingFee": 2.1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 2.108595,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f649a1f9-1457-41e5-af88-2430b821ab11",
"networkFee": 0.008595
}
}
}
},
"createdAt": "2026-08-24T11:26:23.865Z"
}
{
"eventId": "EV-260824112623575",
"entityId": "OR-260824112622050904850844331",
"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-260824112622050904850844331",
"type": "swap",
"depositCurrency": "USDTPOLYGON",
"depositAmount": 42,
"withdrawCurrency": "USDCSOL",
"withdrawAmount": 39.88783,
"walletAddress": "",
"createdAt": "2026-08-24T11:26:22.385Z",
"customerOrderId": "OR-260824112622050904850844331",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDTPOLYGON",
"sourceAmount": 42,
"sourceAmountInUsd": 41.99,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDCSOL",
"destinationAmountInUsd": 39.88,
"destinationCurrencyType": "crypto",
"conversionRate": 0.9999103871091857,
"processingFee": 2.1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 2.108595,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f649a1f9-1457-41e5-af88-2430b821ab11",
"networkFee": 0.008595
}
}
}
},
"createdAt": "2026-08-24T11:26:23.865Z"
}
{
"eventId": "EV-260824112623575",
"entityId": "OR-260824112622050904850844331",
"entityType": "order",
"status": "asset_processing",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824112622050904850844331",
"type": "swap",
"depositCurrency": "USDTPOLYGON",
"depositAmount": 42,
"withdrawCurrency": "USDCSOL",
"withdrawAmount": 39.88783,
"walletAddress": "",
"createdAt": "2026-08-24T11:26:22.385Z",
"customerOrderId": "OR-260824112622050904850844331",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDTPOLYGON",
"sourceAmount": 42,
"sourceAmountInUsd": 41.99,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDCSOL",
"destinationAmountInUsd": 39.88,
"destinationCurrencyType": "crypto",
"conversionRate": 0.9999103871091857,
"processingFee": 2.1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 2.108595,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f649a1f9-1457-41e5-af88-2430b821ab11",
"networkFee": 0.008595
}
}
}
},
"createdAt": "2026-08-24T11:26:23.865Z"
}
{
"eventId": "EV-260824112623575",
"entityId": "OR-260824112622050904850844331",
"entityType": "order",
"status": "asset_settled",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824112622050904850844331",
"type": "swap",
"depositCurrency": "USDTPOLYGON",
"depositAmount": 42,
"withdrawCurrency": "USDCSOL",
"withdrawAmount": 39.88783,
"walletAddress": "",
"createdAt": "2026-08-24T11:26:22.385Z",
"customerOrderId": "OR-260824112622050904850844331",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDTPOLYGON",
"sourceAmount": 42,
"sourceAmountInUsd": 41.99,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDCSOL",
"destinationAmountInUsd": 39.88,
"destinationCurrencyType": "crypto",
"conversionRate": 0.9999103871091857,
"processingFee": 2.1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 2.108595,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f649a1f9-1457-41e5-af88-2430b821ab11",
"networkFee": 0.008595
}
}
}
},
"createdAt": "2026-08-24T11:26:23.865Z"
}
{
"eventId": "EV-260824112623575",
"entityId": "OR-260824112622050904850844331",
"entityType": "order",
"status": "asset_settle_failed",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824112622050904850844331",
"type": "swap",
"depositCurrency": "USDTPOLYGON",
"depositAmount": 42,
"withdrawCurrency": "USDCSOL",
"withdrawAmount": 39.88783,
"walletAddress": "",
"createdAt": "2026-08-24T11:26:22.385Z",
"customerOrderId": "OR-260824112622050904850844331",
"failureCode": "TRANSACTION_FAILED",
"failureMessage": "Crypto transaction failed.",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDTPOLYGON",
"sourceAmount": 42,
"sourceAmountInUsd": 41.99,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDCSOL",
"destinationAmountInUsd": 39.88,
"destinationCurrencyType": "crypto",
"conversionRate": 0.9999103871091857,
"processingFee": 2.1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 2.108595,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f649a1f9-1457-41e5-af88-2430b821ab11",
"networkFee": 0.008595
}
}
}
},
"createdAt": "2026-08-24T11:26:23.865Z"
}
{
"eventId": "EV-260824112623575",
"entityId": "OR-260824112622050904850844331",
"entityType": "order",
"status": "expired",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824112622050904850844331",
"type": "swap",
"depositCurrency": "USDTPOLYGON",
"depositAmount": 42,
"withdrawCurrency": "USDCSOL",
"withdrawAmount": 39.88783,
"walletAddress": "",
"createdAt": "2026-08-24T11:26:22.385Z",
"customerOrderId": "OR-260824112622050904850844331",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDTPOLYGON",
"sourceAmount": 42,
"sourceAmountInUsd": 41.99,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDCSOL",
"destinationAmountInUsd": 39.88,
"destinationCurrencyType": "crypto",
"conversionRate": 0.9999103871091857,
"processingFee": 2.1,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 2.108595,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-f649a1f9-1457-41e5-af88-2430b821ab11",
"networkFee": 0.008595
}
}
}
},
"createdAt": "2026-08-24T11:26:23.865Z"
}
Updated 8 days ago
Did this page help you?