余额查询
接口说明
查询商户钱包余额,支持按支付方式查询对应钱包。
请求
- URL:
POST /api/alliesPay/queryBalance - Content-Type:
application/json
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| userCode | String | 是 | 商户编号,也可用 alliesNo |
| paymentMethod | String | 否 | 支付方式,传 tradeType 数字值:菲律宾 31(GCash)/32(Bank)/33(Maya)/34(QRPH),泰国 1001(Your泰)。不传时默认 31 |
| signType | String | 否 | 签名类型:RSA(默认)或 MD5 |
| sign | String | 是 | 签名值 |
paymentMethod 与钱包类型对应
- GCASH (31) → GCash 钱包
- BANK (32) → Bank 钱包(与 GCash 共享同一钱包)
- MAYA (33) → Maya 钱包
- QRPH (34) → QRPH 钱包
其中 BANK (32) 合并到 GCash (31) 的钱包。
请求示例
json
{
"userCode": "IG20260622001",
"paymentMethod": "31",
"signType": "RSA",
"sign": "签名值"
}响应
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 状态码,10000 表示成功 |
| msg | String | 状态描述 |
| userCode | String | 商户编号 |
| balance | String | 可用余额(已扣除冻结金额) |
| totalAmount | String | 钱包总额 |
| updateTime | String | 最后更新时间(yyyy-MM-dd HH:mm:ss) |
| sign | String | 响应签名 |
成功响应示例
json
{
"code": "10000",
"msg": "success",
"userCode": "IG20260622001",
"balance": "50000.00",
"totalAmount": "100000.00",
"updateTime": "2026-06-22 10:30:00",
"sign": "响应签名值"
}失败响应示例
json
{
"code": "1007",
"msg": "钱包信息不存在",
"data": null
}