Payin with wallet (gaming)
This section provides a list of possible events that can be received as webhooks for Gaming 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_settled | User has submitted the payment details on the payment checkout page and the confirmation is received from the bank |
| Payment Unauthorised | Order | fund_failed | User has submitted the payment details on the payment checkout page and the payment is declined from the bank |
| Balance Top Up | Order | completed | The order is successfully completed and this should trigger the balance top-up on the end user's gaming platform. |
| Expired | Order | expired | The order is expired due to transaction not completed by user. |
| Manual Review | Order | manual_review | The order is hold for manual review by our compliance team. |
Sample Event For Order:
{
"eventId": "EV-260824091400863",
"entityId": "OR-260824091358200944985216772",
"entityType": "order",
"status": "initiated",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-260724045356263622",
"firstName": "sumanth",
"lastName": "devadiga",
"country": "IN",
"createdAt": "2026-07-24T04:53:56.631Z"
},
"order": {
"orderId": "OR-260824091358200944985216772",
"type": "gaming",
"depositCurrency": "MXN",
"depositAmount": 200,
"withdrawCurrency": "USDC",
"withdrawAmount": "",
"walletAddress": "",
"createdAt": "2026-08-24T09:13:58.611Z",
"customerOrderId": "OR-260824091358200944985216772",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "MXN",
"sourceAmount": 200,
"sourceAmountInUsd": 11.81,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 11.461487,
"destinationAmountInUsd": 11.46,
"destinationCurrencyType": "crypto",
"conversionRate": 0.05907982813205358,
"minLimit": 88,
"maxLimit": 1693044.02,
"direction": "forward",
"processingFee": 6,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 6,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-32481339-1a38-04d44a5c3"
}
}
}
},
"createdAt": "2026-08-24T09:14:00.136Z"
}{
"eventId": "EV-260824091400863",
"entityId": "OR-260824091358200944985216772",
"entityType": "order",
"status": "fund_settled",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-260724045356263622",
"firstName": "sumanth",
"lastName": "devadiga",
"country": "IN",
"createdAt": "2026-07-24T04:53:56.631Z"
},
"order": {
"orderId": "OR-260824091358200944985216772",
"type": "gaming",
"depositCurrency": "MXN",
"depositAmount": 200,
"withdrawCurrency": "USDC",
"withdrawAmount": "",
"walletAddress": "",
"createdAt": "2026-08-24T09:13:58.611Z",
"customerOrderId": "OR-260824091358200944985216772",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "MXN",
"sourceAmount": 200,
"sourceAmountInUsd": 11.81,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 11.461487,
"destinationAmountInUsd": 11.46,
"destinationCurrencyType": "crypto",
"conversionRate": 0.05907982813205358,
"minLimit": 88,
"maxLimit": 1693044.02,
"direction": "forward",
"processingFee": 6,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 6,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-32481339-1a38-04d44a5c3"
}
}
}
},
"createdAt": "2026-08-24T09:14:00.136Z"
}{
"eventId": "EV-260824091400863",
"entityId": "OR-260824091358200944985216772",
"entityType": "order",
"status": "fund_failed",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-260724045356263622",
"firstName": "sumanth",
"lastName": "devadiga",
"country": "IN",
"createdAt": "2026-07-24T04:53:56.631Z"
},
"order": {
"orderId": "OR-260824091358200944985216772",
"type": "gaming",
"depositCurrency": "MXN",
"depositAmount": 200,
"withdrawCurrency": "USDC",
"withdrawAmount": "",
"walletAddress": "",
"createdAt": "2026-08-24T09:13:58.611Z",
"customerOrderId": "OR-260824091358200944985216772",
"failureCode": "PAYMENT_NOT_COMPLETED",
"failureMessage": "Payment was not completed. Please try again.",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "MXN",
"sourceAmount": 200,
"sourceAmountInUsd": 11.81,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 11.461487,
"destinationAmountInUsd": 11.46,
"destinationCurrencyType": "crypto",
"conversionRate": 0.05907982813205358,
"minLimit": 88,
"maxLimit": 1693044.02,
"direction": "forward",
"processingFee": 6,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 6,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-32481339-1a38-04d44a5c3"
}
}
}
},
"createdAt": "2026-08-24T09:14:00.136Z"
}{
"eventId": "EV-260824091400863",
"entityId": "OR-260824091358200944985216772",
"entityType": "order",
"status": "completed",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-260724045356263622",
"firstName": "sumanth",
"lastName": "devadiga",
"country": "IN",
"createdAt": "2026-07-24T04:53:56.631Z"
},
"order": {
"orderId": "OR-260824091358200944985216772",
"type": "gaming",
"depositCurrency": "MXN",
"depositAmount": 200,
"withdrawCurrency": "USDC",
"withdrawAmount": "",
"walletAddress": "",
"createdAt": "2026-08-24T09:13:58.611Z",
"customerOrderId": "OR-260824091358200944985216772",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "MXN",
"sourceAmount": 200,
"sourceAmountInUsd": 11.81,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 11.461487,
"destinationAmountInUsd": 11.46,
"destinationCurrencyType": "crypto",
"conversionRate": 0.05907982813205358,
"minLimit": 88,
"maxLimit": 1693044.02,
"direction": "forward",
"processingFee": 6,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 6,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-32481339-1a38-04d44a5c3"
}
}
}
},
"createdAt": "2026-08-24T09:14:00.136Z"
}{
"eventId": "EV-260824091400863",
"entityId": "OR-260824091358200944985216772",
"entityType": "order",
"status": "expired",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-260724045356263622",
"firstName": "sumanth",
"lastName": "devadiga",
"country": "IN",
"createdAt": "2026-07-24T04:53:56.631Z"
},
"order": {
"orderId": "OR-260824091358200944985216772",
"type": "gaming",
"depositCurrency": "MXN",
"depositAmount": 200,
"withdrawCurrency": "USDC",
"withdrawAmount": "",
"walletAddress": "",
"createdAt": "2026-08-24T09:13:58.611Z",
"customerOrderId": "OR-260824091358200944985216772",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "MXN",
"sourceAmount": 200,
"sourceAmountInUsd": 11.81,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 11.461487,
"destinationAmountInUsd": 11.46,
"destinationCurrencyType": "crypto",
"conversionRate": 0.05907982813205358,
"minLimit": 88,
"maxLimit": 1693044.02,
"direction": "forward",
"processingFee": 6,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 6,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-32481339-1a38-04d44a5c3"
}
}
}
},
"createdAt": "2026-08-24T09:14:00.136Z"
}{
"eventId": "EV-260824091400863",
"entityId": "OR-260824091358200944985216772",
"entityType": "order",
"status": "manual_review",
"mid": "ABCDEF_NA_NA",
"user": {
"userId": "UX-260724045356263622",
"firstName": "sumanth",
"lastName": "devadiga",
"country": "IN",
"createdAt": "2026-07-24T04:53:56.631Z"
},
"order": {
"orderId": "OR-260824091358200944985216772",
"type": "gaming",
"depositCurrency": "MXN",
"depositAmount": 200,
"withdrawCurrency": "USDC",
"withdrawAmount": "",
"walletAddress": "",
"createdAt": "2026-08-24T09:13:58.611Z",
"customerOrderId": "OR-260824091358200944985216772",
"failureCode": "NAME_NOT_MATCHED",
"failureMessage": "Name verification failed. Please check the account details.",
"quoteHistory": {
"refreshCount": 0,
"orderCreationQuote": {
"isRefreshed": false,
"usedQuotes": {
"sourceCurrency": "MXN",
"sourceAmount": 200,
"sourceAmountInUsd": 11.81,
"sourceCurrencyType": "fiat",
"destinationCurrency": "USDCSOL",
"destinationAmount": 11.461487,
"destinationAmountInUsd": 11.46,
"destinationCurrencyType": "crypto",
"conversionRate": 0.05907982813205358,
"minLimit": 88,
"maxLimit": 1693044.02,
"direction": "forward",
"processingFee": 6,
"processingFeeRate": 0.03,
"customerFee": 0,
"customerFeeRate": 0,
"rrFeeRate": 0,
"discount": 0,
"discountRate": 0,
"additionalFee": 0,
"fixedFee": {
"totalFixedFees": 0,
"totalFixedTfFees": 0,
"totalFixedCxFees": 0,
"fixedFeesCurrency": "",
"fixedFeeDetails": {
"baseFeeFixedRate": 0,
"tfFeeFixedRate": 0,
"cxFeeFixedRate": 0,
"currency": ""
}
},
"totalFee": 6,
"feeMode": "percentage",
"rateType": "live",
"quoteId": "QUOTE-32481339-1a38-04d44a5c3"
}
}
}
},
"createdAt": "2026-08-24T09:14:00.136Z"
}Updated 8 days ago
Did this page help you?