余额查询

信用卡维度 余额查询 API（USD / EUR）。

请求

POST/v2.0/inquiry-balance

请求地址：

沙盒：https://sandbox-gateway.smilepayz.com/v2.0/inquiry-balance
生产：https://gateway.smilepayz.com/v2.0/inquiry-balance

请求头

字段	必填	类型	说明
Content-Type	M	String	application/json
X-TIMESTAMP	M	String	格式：yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	请求体签名
X-PARTNER-ID	M	String	商户 merchantId

请求体

字段	必填	类型	说明
accountNo	M	String(128)	该币种商户结算账户号（代收 / Pay-in 或 代付 / Pay-out）。
balanceTypes	M	List(String)	如 ["BALANCE"]

accountNo

• 沙盒：任意非空字符串即可（≤128），可直接用下方示例中的值。
• 生产：商户后台 → Finance → Balance。同币种有代收 / 代付两个账户号，查哪个传哪个。见 如何获取生产账户号。

---

请求示例

{
    "accountNo": "21120030202403071031",
    "balanceTypes": [
        "BALANCE"
    ]
}

响应

字段	必填	类型	说明
code	M	String	00 成功
message	M	String	结果描述
accountInfos	M	Object	余额信息
amount.currency	M	String	USD 或 EUR
amount.value	M	String	余额字符串

响应示例

{
    "code": "00",
    "message": "Successful",
    "accountInfos": {
        "balanceType": "BALANCE",
        "amount": {
            "currency": "USD",
            "value": "250000"
        },
        "availableBalance": {
            "currency": "USD",
            "value": "250000"
        }
    },
    "accountNo": "21120030202403071031",
    "balanceTypes": ["BALANCE"],
    "name": "Sandbox Test"
}