Skip to content

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
ParameterValueRequiredDescription
Content-Typeapplication/jsonYesRequest body type

Request Body

ParameterTypeDescriptionRequired
merchantNostringMerchant number (provided by Onerway)M
signstringSignatureM
Request Example
json
{
  "merchantNo": "800181",
  "sign": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"
}

Response Result

Response Headers
ParameterValueRequiredDescription
content-typeapplication/json;charset=UTF-8YesResponse body type

Response Body

ParameterTypeDescription
respCodestringResponse code
respMsgstringResponse message
dataobjectResponse data
  └─accountCurrencyQueryDetailDTOListarrayCurrency list
    └─currencystringCurrency
    └─balancestringBalance
Response Example
json
{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "accountCurrencyQueryDetailDTOList": [
      {
        "currency": "USD",
        "balance": "15000.50"
      },
      {
        "currency": "EUR",
        "balance": "8750.25"
      },
      {
        "currency": "GBP",
        "balance": "12300.75"
      }
    ]
  }
}