Create Fiat Pay-in Order
Developing
POST
/v2/fiat/pay-in
What This API Does
fiat_payment_url. Redirect the end user to this URL to complete payment.Request Data Structure
{
"txid": "Ixxxxxxxxxxxxxxxxxxxx",
"token": "USDT",
"token_amount": 100,
"fiat_kyc_id": "KYC_xxx",
"fiat_payment_type": "bank_transfer",
"fiat_purpose_code": "service_charges",
"fiat_currency": "USD",
"fiat_redirect_url": "https://merchant.example/success",
"fiat_source_url": "https://merchant.example/checkout",
"payment_code": "sepa_bank"
}| Field | Type | Required / Nullable | Conditions / Notes |
|---|---|---|---|
txid | string | Required, cannot be null | AIO pay-in transaction ID from the normal pay-in transaction. |
token | string | Optional, can be null/omitted | Must match the linked transaction if provided. |
token_amount | float | Conditional | Required for long-time pay-ins. Ignored for one-time pay-ins. |
fiat_kyc_id | string | Required, cannot be null | KYC profile ID returned by POST /v2/fiat/kyc. |
fiat_payment_type | string | Required, cannot be null | Allowed values: bank_transfer, local_wallet. Controls which payment options appear on the payment page. |
fiat_purpose_code | string | Required, cannot be null | Purpose code. Use supported enum values from the Enum Values section. |
fiat_currency | string | Required, cannot be null | Fiat currency code, for example USD, PHP, EUR. |
fiat_redirect_url | string | Required, cannot be null | URL where the user is redirected after payment. |
fiat_source_url | string | Optional, can be null/omitted | URL of the originating checkout page. |
payment_code | string | Optional, can be null/omitted | Specific payment method code such as sepa_bank or gcash. If omitted, the user can choose from all available methods within fiat_payment_type. |
Response Structure
{
"txid": "Ixxxxxxxxxxxxxxxxxxxx",
"fiat_order_id": "OR-xxxx",
"fiat_payment_url": "https://..."
}| Field | Type | Nullable | Description |
|---|---|---|---|
txid | string | No | Linked AIO pay-in transaction ID. |
fiat_order_id | string | No | Fiat order ID. Store it for reconciliation and support. |
fiat_payment_url | string | No | Hosted payment page URL. Redirect the user here. |
Logic in a Nutshell
fiat_payment_url.Request
None
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.aio.cash/v2/v2/fiat/pay-in'Response Response Example
{
"success": true,
"msg": "ok",
"data": {}
}Modified at 2026-05-18 08:39:10