Account Currency Query
API Information
- Path:
api/v1/acct/queryAcctCurrency - Method: POST
- Content-Type: application/json
Business Description
- Used to query all currencies supported by the merchant account and their corresponding balances.
- Typical use cases include: obtaining the list of supported currencies during system initialization, checking account balance sufficiency before submitting payments, and retrieving the balance of each currency during periodic reconciliation.
- The response provides the available balance for each currency.
Request Parameters
Request Headers
| Parameter | Value | Required | Description |
|---|---|---|---|
| Content-Type | application/json | Yes | Request body type |
Request Body
| Parameter | Type | Description | Required |
|---|---|---|---|
| merchantNo | string | Merchant number (provided by Onerway) | M |
| sign | string | Signature | M |
Request Example
json
{
"merchantNo": "800181",
"sign": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"
}Response Result
Response Headers
| Parameter | Value | Required | Description |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | Yes | Response body type |
Response Body
| Parameter | Type | Description |
|---|---|---|
| respCode | string | Response code |
| respMsg | string | Response message |
| data | object | Response data |
| └─accountCurrencyQueryDetailDTOList | array | Currency list |
| └─currency | string | Currency |
| └─balance | string | Balance |
Response Example
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"accountCurrencyQueryDetailDTOList": [
{
"currency": "USD",
"balance": "15000.50"
},
{
"currency": "EUR",
"balance": "8750.25"
},
{
"currency": "GBP",
"balance": "12300.75"
}
]
}
}