查看账户实时余额

一般账号

一般而言，通过下面接口，可以根据账号的业务类型和所属国家，查询到账号的实时余额。

如果您的账号合并了收款和汇款的业务（T+0商户），那么您需要使用合并账号的接口来查询余额。

HTTP 请求

BaseURL https://open.merchant.liquido.com

GET /open-api/account/balance

请求响应

Request Headers

{ "Authorization": "Bearer {{access_token}}" }

Request Example

curl "https://open.merchant.liquido.com/open-api/account/balance?countryCode=BR&transactionTypeCode=PAY_IN"

Content-Type: application/json

{
    "code": 200,
    "msg": "success",
    "data": {
        "accountBalance": 9999,
        "availableBalance": 9999,
        "currency": "BRL"
    }
}

HTTP Headers 字段说明

Key	Value
Authorization	"Bearer" + " " + {{access_token}}

请求参数

参数	必填	类型	描述
countryCode		String	国家代码, 枚举: BR,MX,US,CO,CL
transactionTypeCode		String	业务类型代码, 枚举: PAY_IN,PAY_OUT

响应字段说明

参数	类型	描述
code	Int	状态码，如 200
msg	String	状态信息，如 "success"
data	JSON	返回数据

对象字段说明

Data

参数	类型	描述
accountBalance	Int	账号的实时余额(单位：分)
availableBalance	Int	账户可用余额（单位：分）
currency	String	货币种类, 如 BRL、 MXN

合并账号

仅用于查询合并了收款和汇款的账号（譬如墨西哥T+0的商户）的实时余额。不满足以上条件时，会出现：Feature is not supported的异常提示。

HTTP 请求

BaseURL https://open.merchant.liquido.com

GET /open-api/merchant/balance

请求响应

Request Headers

{ "Authorization": "Bearer {{access_token}}" }

Request Example

curl "https://open.merchant.liquido.com/open-api/merchant/balance?countryCode=BR"

Content-Type: application/json

{
  "code": 200,
  "msg": "success",
  "data": {
    "totalBalance": 40651021,
    "availableBalance": 40651021,
    "currency": "BRL"
  }
}

HTTP Headers 字段说明

Key	Value
Authorization	"Bearer" + " " + {{access_token}}

请求参数

参数	必填	类型	描述
countryCode		String	国家代码, 枚举: BR,MX,US,CO,CL

响应字段说明

参数	类型	描述
code	Int	状态码，如 200
msg	String	状态信息，如 "success"
data	JSON	返回数据

对象字段说明

Data

参数	类型	描述
totalBalance	Int	商户的实时余额（单位：分）
availableBalance	Int	商户可用余额（单位：分）
currency	String	货币种类, 如 BRL、 MXN