可用余额查询
此接口用于查询商户的可用余额,包括总余额、可用余额、冻结余额等信息。建议在发起转账前先查询可用余额。
请求信息
请求URL |
/api/transfer/balance |
请求方式 |
POST |
请求参数
参数名 |
类型 |
必填 |
示例值 |
说明 |
pid |
Int |
是 |
1001 |
商户ID |
timestamp |
String |
是 |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
是 |
|
签名字符串,详见签名规则 |
sign_type |
String |
是 |
RSA |
签名类型,默认为RSA |
返回参数
参数名 |
类型 |
示例值 |
说明 |
code |
Int |
0 |
返回状态码,0为成功,其它值为失败 |
msg |
String |
|
返回信息,失败或成功时返回提示 |
money |
String |
1000.00 |
总余额,单位:元 |
available_money |
String |
900.00 |
可用余额,单位:元 |
frozen_money |
String |
100.00 |
冻结余额,单位:元 |
settle_money |
String |
50.00 |
待结算余额,单位:元 |
timestamp |
String |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
|
签名字符串,详见签名规则 |
sign_type |
String |
RSA |
签名类型,默认为RSA |
返回示例
成功示例:
{
"code": 0,
"msg": "查询成功",
"money": "1000.00",
"available_money": "900.00",
"frozen_money": "100.00",
"settle_money": "50.00",
"timestamp": "1721206072",
"sign": "xxxxx",
"sign_type": "RSA"
}
失败示例:
{
"code": -1,
"msg": "商户不存在"
}
其他说明
注意事项
- 接口访问频率限制:每分钟最多10次。
- 返回的金额数据均保留2位小数。
- 可用余额 = 总余额 - 冻结余额 - 待结算余额。
- 发起转账时将从可用余额中扣除相应金额。
- 建议在每次转账前查询可用余额,避免转账失败。