余额查询（埃及）

埃及地区 余额查询 接口（EGP）。

请求

POST/v2.0/inquiry-balance

请求地址：

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/inquiry-balance
production: https://gateway.smilepayz.com/v2.0/inquiry-balance

请求头参数

字段	必填	类型	说明
Content-Type	M	String	application/json 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。同币种有代收 / 代付两个账户号，查哪个传哪个。见 如何获取生产账户号。

---

示例请求体 – 余额查询请求：

Content-type: application/json
X-TIMESTAMP: 2020-12-18T15:06:00+02:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID: 20001

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

响应

HTTP 头参数

字段	必填	类型	说明
Content-Type	M	String	application/json JSON 内容。
X-TIMESTAMP	M	String	格式：yyyy-MM-ddTHH:mm:ss±HH:mm

响应体参数

字段	必填	类型	说明
code	M	String	00 成功，其余失败。
message	M	String	UTF-8 结果说明。
accountInfos	M	Object	包含 balanceType、amount、availableBalance。
balanceType	M	String	例如 BALANCE。
amount	M	Object	金额对象（含 currency / amount）。小数位见 金额 Money
currency	M	String	本笔币种代码。
value	M	String	余额字符串。
availableBalance	M	Object	可用余额，结构同 amount。
currency	M	String	本笔币种代码。
value	M	String	可用余额字符串。
accountNo	M	String	回显请求中的 accountNo。
name	O	String	账户显示名称（若返回）。
balanceTypes	O	Array	回显请求的余额类型。

示例响应体 – 余额查询响应：

Content-type: application/json 
X-TIMESTAMP: 2020-12-17T10:55:00+02:00

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