Onramp
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 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 |
| Payment Authorised | Order | fund_deposited | User has submitted the payment details on the payment checkout page and the confirmation is received from the bank |
| Payment Unauthorised | Order | fund_deposit_failed | User has submitted the payment details on the payment checkout page and the payment is declined from the bank |
| Crypto Settled | Order | asset_settled | User has received the crypto |
| Crypto Settle Failed | Order | asset_settle_failed | User has failed received the crypto |
| Expired | Order | expired | Order expired due to inactivity |
Sample Event For Order:
{
"eventId": "EV-260824102620569",
"entityId": "OR-260824102617944714300543731",
"entityType": "order",
"status": "initiated",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824102617944714300543731",
"type": "buy",
"fiatTicker": "IDR",
"cryptoTicker": "USDCSOL",
"fiatAmount": 150000,
"cryptoAmount": 8.21245,
"paymentType": "ovo",
"txnHash": "",
"walletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"destinationWalletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"createdAt": "2026-08-24T10:26:18.570Z",
"customerOrderId": "OR-260824102617944714300543731",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"sendersWalletAddress": "",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "IDR",
"sourceAmount": 150000,
"sourceAmountInUsd": 8.47,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 8.21245,
"destinationAmountInUsd": 8.21,
"destinationCurrencyType": "crypto",
"conversionRate": 0.00005646342371501418,
"minLimit": 91226,
"maxLimit": 20000000,
"direction": "forward",
"processingFee": 4500,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "IDR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 4552.75,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-3e5e1290-063a-43f8-a81a-ea47e9bc861f",
"networkFee": 52.75
}
}
}
},
"createdAt": "2026-08-24T10:26:20.006Z"
}{
"eventId": "EV-260824102620569",
"entityId": "OR-260824102617944714300543731",
"entityType": "order",
"status": "fund_deposited",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824102617944714300543731",
"type": "buy",
"fiatTicker": "IDR",
"cryptoTicker": "USDCSOL",
"fiatAmount": 150000,
"cryptoAmount": 8.21245,
"paymentType": "ovo",
"txnHash": "",
"walletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"destinationWalletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"createdAt": "2026-08-24T10:26:18.570Z",
"customerOrderId": "OR-260824102617944714300543731",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"sendersWalletAddress": "",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "IDR",
"sourceAmount": 150000,
"sourceAmountInUsd": 8.47,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 8.21245,
"destinationAmountInUsd": 8.21,
"destinationCurrencyType": "crypto",
"conversionRate": 0.00005646342371501418,
"minLimit": 91226,
"maxLimit": 20000000,
"direction": "forward",
"processingFee": 4500,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "IDR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 4552.75,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-3e5e1290-063a-43f8-a81a-ea47e9bc861f",
"networkFee": 52.75
}
}
}
},
"createdAt": "2026-08-24T10:26:20.006Z"
}{
"eventId": "EV-260824102620569",
"entityId": "OR-260824102617944714300543731",
"entityType": "order",
"status": "fund_deposit_failed",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824102617944714300543731",
"type": "buy",
"fiatTicker": "IDR",
"cryptoTicker": "USDCSOL",
"fiatAmount": 150000,
"cryptoAmount": 8.21245,
"paymentType": "ovo",
"txnHash": "",
"walletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"destinationWalletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"createdAt": "2026-08-24T10:26:18.570Z",
"customerOrderId": "OR-260824102617944714300543731",
"failureCode": "PAYMENT_NOT_COMPLETED",
"failureMessage": "Payment was not completed. Please try again.",
"bankTxnId": [],
"sendersWalletAddress": "",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "IDR",
"sourceAmount": 150000,
"sourceAmountInUsd": 8.47,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 8.21245,
"destinationAmountInUsd": 8.21,
"destinationCurrencyType": "crypto",
"conversionRate": 0.00005646342371501418,
"minLimit": 91226,
"maxLimit": 20000000,
"direction": "forward",
"processingFee": 4500,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "IDR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 4552.75,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-3e5e1290-063a-43f8-a81a-ea47e9bc861f",
"networkFee": 52.75
}
}
}
},
"createdAt": "2026-08-24T10:26:20.006Z"
}{
"eventId": "EV-260824102620569",
"entityId": "OR-260824102617944714300543731",
"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-260824102617944714300543731",
"type": "buy",
"fiatTicker": "IDR",
"cryptoTicker": "USDCSOL",
"fiatAmount": 150000,
"cryptoAmount": 8.21245,
"paymentType": "ovo",
"txnHash": "",
"walletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"destinationWalletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"createdAt": "2026-08-24T10:26:18.570Z",
"customerOrderId": "OR-260824102617944714300543731",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"sendersWalletAddress": "",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "IDR",
"sourceAmount": 150000,
"sourceAmountInUsd": 8.47,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 8.21245,
"destinationAmountInUsd": 8.21,
"destinationCurrencyType": "crypto",
"conversionRate": 0.00005646342371501418,
"minLimit": 91226,
"maxLimit": 20000000,
"direction": "forward",
"processingFee": 4500,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "IDR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 4552.75,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-3e5e1290-063a-43f8-a81a-ea47e9bc861f",
"networkFee": 52.75
}
}
}
},
"createdAt": "2026-08-24T10:26:20.006Z"
}{
"eventId": "EV-260824102620569",
"entityId": "OR-260824102617944714300543731",
"entityType": "order",
"status": "asset_settled_failed",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824102617944714300543731",
"type": "buy",
"fiatTicker": "IDR",
"cryptoTicker": "USDCSOL",
"fiatAmount": 150000,
"cryptoAmount": 8.21245,
"paymentType": "ovo",
"txnHash": "",
"walletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"destinationWalletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"createdAt": "2026-08-24T10:26:18.570Z",
"customerOrderId": "OR-260824102617944714300543731",
"failureCode": "TRANSACTION_FAILED",
"failureMessage": "Crypto transaction failed.",
"bankTxnId": [],
"sendersWalletAddress": "",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "IDR",
"sourceAmount": 150000,
"sourceAmountInUsd": 8.47,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 8.21245,
"destinationAmountInUsd": 8.21,
"destinationCurrencyType": "crypto",
"conversionRate": 0.00005646342371501418,
"minLimit": 91226,
"maxLimit": 20000000,
"direction": "forward",
"processingFee": 4500,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "IDR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 4552.75,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-3e5e1290-063a-43f8-a81a-ea47e9bc861f",
"networkFee": 52.75
}
}
}
},
"createdAt": "2026-08-24T10:26:20.006Z"
}{
"eventId": "EV-260824102620569",
"entityId": "OR-260824102617944714300543731",
"entityType": "order",
"status": "expired",
"user": {
"userId": "UX-251207074635111",
"firstName": "sumanth",
"lastName": "dev",
"country": "IN",
"createdAt": "2025-12-07T07:46:36.062Z"
},
"order": {
"orderId": "OR-260824102617944714300543731",
"type": "buy",
"fiatTicker": "IDR",
"cryptoTicker": "USDCSOL",
"fiatAmount": 150000,
"cryptoAmount": 8.21245,
"paymentType": "ovo",
"txnHash": "",
"walletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"destinationWalletAddress": "sHFPykxqmKDLDusv1ceKswRkLzVL38pMEKRCWZr98ePB",
"createdAt": "2026-08-24T10:26:18.570Z",
"customerOrderId": "OR-260824102617944714300543731",
"bankTxnId": [],
"sendersWalletAddress": "",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "IDR",
"sourceAmount": 150000,
"sourceAmountInUsd": 8.47,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 8.21245,
"destinationAmountInUsd": 8.21,
"destinationCurrencyType": "crypto",
"conversionRate": 0.00005646342371501418,
"minLimit": 91226,
"maxLimit": 20000000,
"direction": "forward",
"processingFee": 4500,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "IDR",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 4552.75,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-3e5e1290-063a-43f8-a81a-ea47e9bc861f",
"networkFee": 52.75
}
}
}
},
"createdAt": "2026-08-24T10:26:20.006Z"
}Updated 7 days ago
Did this page help you?