查看账户实时余额

一般账号

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

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

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,
        "currency": "BRL"
    }
}

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

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

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

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

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"
  }
}

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

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