Prefunds
This section provides a list of possible events that can be received as webhooks for Prefund orders.
Fiat Prefund order events
Order statuses
| Events | Event Type | Status | Descriptions |
|---|---|---|---|
| Payment Initiated | Order | initiated | Prefund order initiated |
| Payment Authorised | Order | fund_settled | Transfi has received the funds |
| Manual Review | Order | manual_review | The order is hold for manual review by our compliance team. |
| Completed | Order | 'completed` | Order is completed. Corresponding balance will be updated. |
Sample Events
{
"eventId": "EV-260824093653273",
"entityId": "PF-260824093651609422834241208",
"entityType": "prefund",
"status": "initiated",
"mid": "ABCDEF_NA_NA",
"customer": {
"name": "sumanth",
"mid": "SAH1N3_NA_NA",
"createdAt": "2025-02-04T13:57:43.582Z"
},
"order": {
"orderId": "",
"type": "fiat_prefund",
"depositCurrency": "AED",
"withdrawCurrency": "USD",
"depositAmount": 10000,
"withdrawAmount": 2586.79,
"paymentType": "bank_transfer",
"createdAt": "2026-08-24T09:36:51.858Z",
"customerOrderId": "PF-260824093651609422834241208",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "AED",
"sourceAmount": 10000,
"sourceAmountInUsd": 2722.94,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USD",
"destinationAmount": 2586.7937372362153,
"destinationAmountInUsd": 2586.79,
"destinationCurrencyType": "fiat",
"conversionRate": 0.27229407760381213,
"minLimit": 20,
"maxLimit": 367250,
"direction": "forward",
"processingFee": 500,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "AED",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 500,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-53f58a7e-2806d5427548df17"
}
}
}
},
"createdAt": "2026-08-24T09:36:53.296Z"
}{
"eventId": "EV-260824093653273",
"entityId": "PF-260824093651609422834241208",
"entityType": "prefund",
"status": "fund_settled",
"mid": "ABCDEF_NA_NA",
"customer": {
"name": "sumanth",
"mid": "SAH1N3_NA_NA",
"createdAt": "2025-02-04T13:57:43.582Z"
},
"order": {
"orderId": "",
"type": "fiat_prefund",
"depositCurrency": "AED",
"withdrawCurrency": "USD",
"depositAmount": 10000,
"withdrawAmount": 2586.79,
"paymentType": "bank_transfer",
"createdAt": "2026-08-24T09:36:51.858Z",
"customerOrderId": "PF-260824093651609422834241208",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "AED",
"sourceAmount": 10000,
"sourceAmountInUsd": 2722.94,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USD",
"destinationAmount": 2586.7937372362153,
"destinationAmountInUsd": 2586.79,
"destinationCurrencyType": "fiat",
"conversionRate": 0.27229407760381213,
"minLimit": 20,
"maxLimit": 367250,
"direction": "forward",
"processingFee": 500,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "AED",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 500,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-53f58a7e-2806-40bc-8570-d5427548df17"
}
}
}
},
"createdAt": "2026-08-24T09:36:53.296Z"
}{
"eventId": "EV-260824093653273",
"entityId": "PF-260824093651609422834241208",
"entityType": "prefund",
"status": "completed",
"mid": "ABCDEF_NA_NA",
"customer": {
"name": "sumanth",
"mid": "SAH1N3_NA_NA",
"createdAt": "2025-02-04T13:57:43.582Z"
},
"order": {
"orderId": "",
"type": "fiat_prefund",
"depositCurrency": "AED",
"withdrawCurrency": "USD",
"depositAmount": 10000,
"withdrawAmount": 2586.79,
"paymentType": "bank_transfer",
"createdAt": "2026-08-24T09:36:51.858Z",
"customerOrderId": "PF-260824093651609422834241208",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "AED",
"sourceAmount": 10000,
"sourceAmountInUsd": 2722.94,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USD",
"destinationAmount": 2586.7937372362153,
"destinationAmountInUsd": 2586.79,
"destinationCurrencyType": "fiat",
"conversionRate": 0.27229407760381213,
"minLimit": 20,
"maxLimit": 367250,
"direction": "forward",
"processingFee": 500,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "AED",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 500,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-53f58a7e-2806-40bc-8570-d5427548df17"
}
}
}
},
"createdAt": "2026-08-24T09:36:53.296Z"
}Crypto Prefund order events
Order statuses
| Events | Event Type | Status | Descriptions |
|---|---|---|---|
| Payment Initiated | Order | initiated | Prefund order initiated |
| Payment Authorised | Order | completed | Transfi has received the funds |
Sample Event For Order:
{
"eventId": "EV-260824094024454",
"entityId": "PF-260824094022775289122604598",
"entityType": "prefund",
"status": "initiated",
"customer": {
"name": "sumanth",
"mid": "SAH1N3_NA_NA",
"createdAt": "2025-02-04T13:57:43.582Z"
},
"order": {
"orderId": "",
"type": "crypto_prefund",
"depositCurrency": "USDC",
"withdrawCurrency": "USDT",
"depositAmount": 200000,
"withdrawAmount": 190012.434381,
"paymentType": "crypto",
"createdAt": "2026-08-24T09:40:22.927Z",
"customerOrderId": "PF-260824094022775289122604598",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"network": "ethereum",
"sendersWalletAddress": "",
"destinationWalletAddress": "0x172b7207a35d7845eB26E95A9c51A6117b693cb3",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 200000,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDT",
"destinationCurrencyType": "crypto",
"conversionRate": 1.0000654441130228,
"processingFee": 10000,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 10000,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-d7d22025-b69e-4c74-a517-5735ae301cf3",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T09:40:24.450Z"
}{
"eventId": "EV-260824094026618",
"entityId": "PF-260824094022775289122604598",
"entityType": "prefund",
"status": "asset_processing",
"customer": {
"name": "sumanth",
"mid": "SAH1N3_NA_NA",
"createdAt": "2025-02-04T13:57:43.582Z"
},
"order": {
"orderId": "",
"type": "crypto_prefund",
"depositCurrency": "USDC",
"withdrawCurrency": "USDT",
"depositAmount": 200000,
"withdrawAmount": 190012.434381,
"paymentType": "crypto",
"createdAt": "2026-08-24T09:40:22.927Z",
"customerOrderId": "PF-260824094022775289122604598",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"network": "ethereum",
"sendersWalletAddress": "",
"destinationWalletAddress": "0x172b7207a35d7845eB26E95A9c51A6117b693cb3",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 200000,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDT",
"destinationCurrencyType": "crypto",
"conversionRate": 1.0000654441130228,
"processingFee": 10000,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 10000,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-d7d22025-b69e-4c74-a517-5735ae301cf3",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T09:40:26.571Z"
}{
"eventId": "EV-260824094024454",
"entityId": "PF-260824094022775289122604598",
"entityType": "prefund",
"status": "completed",
"customer": {
"name": "sumanth",
"mid": "SAH1N3_NA_NA",
"createdAt": "2025-02-04T13:57:43.582Z"
},
"order": {
"orderId": "",
"type": "crypto_prefund",
"depositCurrency": "USDC",
"withdrawCurrency": "USDT",
"depositAmount": 200000,
"withdrawAmount": 190012.434381,
"paymentType": "crypto",
"createdAt": "2026-08-24T09:40:22.927Z",
"customerOrderId": "PF-260824094022775289122604598",
"failureCode": "",
"failureMessage": "",
"bankTxnId": [],
"network": "ethereum",
"sendersWalletAddress": "",
"destinationWalletAddress": "0x172b7207a35d7845eB26E95A9c51A6117b693cb3",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "USDC",
"sourceAmount": 200000,
"sourceCurrencyType": "crypto",
"destinationCurrency": "USDT",
"destinationCurrencyType": "crypto",
"conversionRate": 1.0000654441130228,
"processingFee": 10000,
"processingFeeRate": 0.05,
"customerFee": 0,
"customerFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"additionalFeeRate": 0,
"totalFee": 10000,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-d7d22025-b69e-4c74-a517-5735ae301cf3",
"networkFee": 0
}
}
}
},
"createdAt": "2026-08-24T09:40:24.450Z"
}Updated 8 days ago
Did this page help you?