Skip to main content

QueryBalance API

Endpoints

Live POST https://pay.onlinepay.ai/balance/query

Sandbox POST https://testpay.onlinepay.ai/balance/query

Request Parameters

ParameterTypeRequiredDescription
merNointegerYesMerchant Number, Unique identifier assigned to the merchant by the onlinepay payment platform when registering with onlinepay
signstringYessignature, MD5(merNo+version+PrivateKey) or RSA(merNo=123&version=V3.0.0)
versionstringYesV3.0.0
currencystringNoIf currency is null, query all currency, which unit is USDC

Example Request

{
"merNo": 111111,
"version": "V3.0.0",
"sing": "9D6FDF4880B00B002B1F2AB61AE9A721",
"currency": "USD"
}

Responses Body

ParameterTypeRequiredDescription
codestringYesIf the value is 00000, it will return success, other please refer to Error Code
messagestringYesInterface returns description
dataobjectYesRequest response data
-currencyintegerYes
-balancestringYesthe amount can be withdrawn from the account
-unCheckedBalancestringYesthe unsettled amount from the account
-totalBalancestringYesthe sum of balance and unCheckedBalance

Example Responses

{
"code":"00000",
"message":"SUCCESS",
"data":{
"currency": "USD",
"balance": "111111.11"
}
}