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_settled | 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 |
{
"entityId": "OR-260325085255805859",
"orgId": "OG-230224045316557",
"entityType": "order",
"createdAt": {
"$date": "2026-03-25T05:17:31.366Z"
},
"eventId": "EV-260325051731799",
"order": {
"orderId": "OR-260325085255805859",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDT",
"cryptoNetwork": "Ethereum",
"fiatAmount": 301.145,
"cryptoAmount": 82,
"paymentType": "AE_BANK_TRANSFER",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "0x45665Ba0c0018926d68DeeEd10b108C8863cef09",
"createdAt": {
"$date": "2026-03-25T04:52:56.808Z"
},
"customerOrderId": "",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"paymentCode": "bank_transfer",
"networkFee": 0,
"tfFee": 0,
"totalFee": 0,
"processingFee": 0
},
"partnerContext": "01KMHNCRT14MG2NRMHSY4NXJ26",
"status": "initiated",
"user": {
"userId": "UX-260322014126135",
"firstName": "John",
"lastName": "Bilbao",
"country": "PH",
"createdAt": {
"$date": "2026-03-22T01:41:26.661Z"
}
},
"history": [
{
"responseStatus": null,
"responseMessage": null,
"status": "initiated",
"updatedAt": null
},
],
"responseMessage": null,
"responseStatus": 200,
"updatedAt": {
"$date": "2026-03-25T05:17:32.244Z"
}
}{
"entityId": "OR-260325085255805859",
"orgId": "OG-230224045316557",
"entityType": "order",
"createdAt": {
"$date": "2026-03-25T05:17:31.366Z"
},
"eventId": "EV-260325051731799",
"order": {
"orderId": "OR-260325085255805859",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDT",
"cryptoNetwork": "Ethereum",
"fiatAmount": 301.145,
"cryptoAmount": 82,
"paymentType": "AE_BANK_TRANSFER",
"txnHash": "",
"walletAddress": "",
"destinationWalletAddress": "0x45665Ba0c0018926d68DeeEd10b108C8863cef09",
"createdAt": {
"$date": "2026-03-25T04:52:56.808Z"
},
"customerOrderId": "",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"paymentCode": "bank_transfer",
"networkFee": 0,
"tfFee": 0,
"totalFee": 0,
"processingFee": 0
},
"partnerContext": "01KMHNCRT14MG2NRMHSY4NXJ26",
"status": "asset_settled",
"user": {
"userId": "UX-260322014126135",
"firstName": "John",
"lastName": "Bilbao",
"country": "PH",
"createdAt": {
"$date": "2026-03-22T01:41:26.661Z"
}
},
"history": [
{
"responseStatus": null,
"responseMessage": null,
"status": "initiated",
"updatedAt": null
},
{
"responseStatus": 200,
"responseMessage": null,
"status": "asset_settled",
"updatedAt": {
"$date": "2026-03-25T04:52:59.080Z"
}
},
],
"responseMessage": null,
"responseStatus": 200,
"updatedAt": {
"$date": "2026-03-25T05:17:32.244Z"
}
}{
"entityId": "OR-260325085255805859",
"orgId": "OG-230224045316557",
"entityType": "order",
"createdAt": {
"$date": "2026-03-25T05:17:31.366Z"
},
"eventId": "EV-260325051731799",
"order": {
"orderId": "OR-260325085255805859",
"type": "sell",
"fiatTicker": "AED",
"cryptoTicker": "USDT",
"cryptoNetwork": "Ethereum",
"fiatAmount": 301.145,
"cryptoAmount": 82,
"paymentType": "AE_BANK_TRANSFER",
"txnHash": "0x87d28c15a44381286205926b9246aa04cc0b9acf1e6acfb5f57",
"walletAddress": "",
"destinationWalletAddress": "0x45665Ba0c0018926d68DeeEd10b108C8863cef09",
"createdAt": {
"$date": "2026-03-25T04:52:56.808Z"
},
"customerOrderId": "",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"paymentCode": "bank_transfer",
"networkFee": 0,
"tfFee": 0,
"totalFee": 0,
"processingFee": 0
},
"partnerContext": "01KMHNCRT14MG2NRMHSY4NXJ26",
"status": "fund_settled",
"user": {
"userId": "UX-260322014126135",
"firstName": "John",
"lastName": "Bilbao",
"country": "PH",
"createdAt": {
"$date": "2026-03-22T01:41:26.661Z"
}
},
"history": [
{
"responseStatus": null,
"responseMessage": null,
"status": "initiated",
"updatedAt": null
},
{
"responseStatus": 200,
"responseMessage": null,
"status": "asset_settled",
"updatedAt": {
"$date": "2026-03-25T04:52:59.080Z"
}
},
{
"responseStatus": 200,
"responseMessage": null,
"status": "fund_settled",
"updatedAt": {
"$date": "2026-03-25T05:15:02.297Z"
}
}
],
"responseMessage": null,
"responseStatus": 200,
"updatedAt": {
"$date": "2026-03-25T05:17:32.244Z"
}
}{
"entityId": "OR-260323093246320227",
"orgId": "OG-230224045316557",
"entityType": "order",
"createdAt": {
"$date": "2026-03-23T17:09:01.374Z"
},
"eventId": "EV-260323170901255",
"order": {
"orderId": "OR-260323093246320227",
"type": "sell",
"fiatTicker": "COP",
"cryptoTicker": "WLDWLC",
"cryptoNetwork": "Worldchain",
"fiatAmount": 153882.94251847424,
"cryptoAmount": 44.043704,
"paymentType": "CO_BANK_TRANSFER",
"txnHash": "0x5d3f80d807561f01529f70b561fdaa3b51c00d3b88a33a934c11b37f40",
"walletAddress": "0x3215b4a5f7bebdaeb3ada3d48de52cfa532d",
"destinationWalletAddress": "0x7a4833d421B1d89646b368333716e204df98e",
"createdAt": {
"$date": "2026-03-23T05:32:46.493Z"
},
"customerOrderId": "",
"failureCode": "TRANSACTION_CANCELLED",
"failureMessage": "TRANSACTION_CANCELLED",
"bankTxnId": [],
"paymentCode": "nequi",
"networkFee": 0,
"tfFee": 1917.82,
"totalFee": 4017.84,
"processingFee": 5935.663009301594
},
"partnerContext": "01KMCJVVTPWJ1N7SWDVTVT4CYJ",
"status": "fund_failed",
"user": {
"userId": "UX-260321223834270",
"firstName": "Alex",
"lastName": "Quintero",
"country": "CO",
"createdAt": {
"$date": "2026-03-21T22:38:34.986Z"
}
},
"history": [
{
"responseStatus": null,
"responseMessage": null,
"status": "initiated",
"updatedAt": null
},
{
"responseStatus": 200,
"responseMessage": null,
"status": "asset_settled",
"updatedAt": {
"$date": "2026-03-23T05:32:49.568Z"
}
},
{
"responseStatus": 200,
"responseMessage": null,
"status": "fund_failed",
"updatedAt": {
"$date": "2026-03-23T06:14:37.362Z"
}
}
],
"responseMessage": null,
"responseStatus": 200,
"updatedAt": {
"$date": "2026-03-23T17:09:02.262Z"
}
}{
"entityId": "OR-260323093246320227",
"orgId": "OG-230224045316557",
"entityType": "order",
"createdAt": {
"$date": "2026-03-23T17:09:01.374Z"
},
"eventId": "EV-260323170901255",
"order": {
"orderId": "OR-260323093246320227",
"type": "sell",
"fiatTicker": "COP",
"cryptoTicker": "WLDWLC",
"cryptoNetwork": "Worldchain",
"fiatAmount": 153882.94251847424,
"cryptoAmount": 44.043704,
"paymentType": "CO_BANK_TRANSFER",
"txnHash": "",
"walletAddress": "0x3215b4a5f7bebdaeb3ada3d48de52cfa532d",
"destinationWalletAddress": "0x7a4833d421B1d89646b368333716e204df98e",
"createdAt": {
"$date": "2026-03-23T05:32:46.493Z"
},
"customerOrderId": "",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"paymentCode": "nequi",
"networkFee": 0,
"tfFee": 1917.82,
"totalFee": 4017.84,
"processingFee": 5935.663009301594
},
"partnerContext": "01KMCJVVTPWJ1N7SWDVTVT4CYJ",
"status": "expired",
"user": {
"userId": "UX-260321223834270",
"firstName": "Alex",
"lastName": "Quintero",
"country": "CO",
"createdAt": {
"$date": "2026-03-21T22:38:34.986Z"
}
},
"history": [
{
"responseStatus": null,
"responseMessage": null,
"status": "initiated",
"updatedAt": null
},
{
"responseStatus": 200,
"responseMessage": null,
"status": "expired",
"updatedAt": {
"$date": "2026-03-23T05:32:49.568Z"
}
},
],
"responseMessage": null,
"responseStatus": 200,
"updatedAt": {
"$date": "2026-03-23T17:09:02.262Z"
}
}
Updated 4 days ago