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",
"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",
"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",
"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",
"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",
"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",
"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-260306091643732",
"entityId": "OR-2603060916323456191",
"entityType": "order",
"status": "initiated",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060916323456191",
"type": "swap",
"depositCurrency": "USDT",
"depositAmount": 42,
"withdrawCurrency": "USDC",
"withdrawAmount": 41.99907,
"walletAddress": "",
"createdAt": "2026-03-06T09:16:40.848Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T09:16:43.350Z"
}{
"eventId": "EV-260306091949362",
"entityId": "OR-2603030919052085505",
"entityType": "order",
"status": "asset_deposited",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603030919052085505",
"type": "swap",
"depositCurrency": "USDT",
"depositAmount": 42,
"withdrawCurrency": "USDC",
"withdrawAmount": 41.99907,
"walletAddress": "",
"createdAt": "2026-03-03T09:19:09.877Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T09:19:49.965Z"
}{
"eventId": "EV-260306091953808",
"entityId": "OR-2603030919052085505",
"entityType": "order",
"status": "asset_processing",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603030919052085505",
"type": "swap",
"depositCurrency": "USDT",
"depositAmount": 42,
"withdrawCurrency": "USDC",
"withdrawAmount": 41.99907,
"walletAddress": "",
"createdAt": "2026-03-03T09:19:09.877Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T09:19:53.684Z"
}{
"eventId": "EV-260306092416429",
"entityId": "OR-2603060923223503586",
"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-2603060923223503586",
"type": "swap",
"depositCurrency": "USDT",
"depositAmount": 42,
"withdrawCurrency": "USDC",
"withdrawAmount": 41.99907,
"walletAddress": "",
"createdAt": "2026-03-06T09:23:30.316Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T09:24:16.981Z"
}{
"eventId": "EV-260306092116229",
"entityId": "OR-2603060916323456191",
"entityType": "order",
"status": "asset_settle_failed",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603060916323456191",
"type": "swap",
"depositCurrency": "USDT",
"depositAmount": 42,
"withdrawCurrency": "USDC",
"withdrawAmount": 41.99907,
"walletAddress": "",
"createdAt": "2026-03-06T09:16:40.848Z",
"customerOrderId": "abcd",
"failureCode": "TRANSACTION_FAILED",
"failureMessage": "Crypto transaction failed."
},
"createdAt": "2026-03-06T09:21:16.983Z"
}{
"eventId": "EV-260306091953808",
"entityId": "OR-2603030919052085505",
"entityType": "order",
"status": "expired",
"user": {
"userId": "UX-250910053447199",
"firstName": "sumanth",
"lastName": "d",
"country": "IN",
"createdAt": "2025-09-10T05:34:47.983Z"
},
"order": {
"orderId": "OR-2603030919052085505",
"type": "swap",
"depositCurrency": "USDT",
"depositAmount": 42,
"withdrawCurrency": "USDC",
"withdrawAmount": 41.99907,
"walletAddress": "",
"createdAt": "2026-03-03T09:19:09.877Z",
"customerOrderId": "abcd"
},
"createdAt": "2026-03-06T09:19:53.684Z"
}Updated 5 days ago