查询商户信息
此接口用于查询商户的基本信息、状态、余额、订单统计等数据。
请求信息
请求URL |
/api/merchant/info |
请求方式 |
POST |
请求参数
参数名 |
类型 |
必填 |
示例值 |
说明 |
pid |
Int |
是 |
1001 |
商户ID |
timestamp |
String |
是 |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
是 |
|
签名字符串,详见签名规则 |
sign_type |
String |
是 |
RSA |
签名类型,默认为RSA |
返回参数
参数名 |
类型 |
示例值 |
说明 |
code |
Int |
0 |
返回状态码,0为成功,其它值为失败 |
msg |
String |
|
返回信息,失败或成功时返回提示 |
pid |
Int |
1001 |
商户ID |
status |
Int |
1 |
商户状态,0:已封禁,1:正常,2:待审核 |
pay_status |
Int |
1 |
支付状态,0:关闭,1:开启 |
settle_status |
Int |
1 |
结算状态,0:关闭,1:开启 |
money |
String |
50.00 |
商户余额,单位:元 |
settle_type |
Int |
1 |
结算方式,详见下方结算方式列表 |
settle_account |
String |
alipay@alipay.com |
结算账户 |
settle_name |
String |
张三 |
结算账户姓名 |
order_num |
Int |
10 |
订单总数量 |
order_num_today |
Int |
3 |
今日订单数量 |
order_num_lastday |
Int |
2 |
昨日订单数量 |
order_money_today |
String |
45.00 |
今日订单收入,单位:元 |
order_money_lastday |
String |
35.00 |
昨日订单收入,单位:元 |
timestamp |
String |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
|
签名字符串,详见签名规则 |
sign_type |
String |
RSA |
签名类型,默认为RSA |
结算方式列表
状态值 |
描述 |
1 |
支付宝 |
2 |
微信 |
3 |
QQ钱包 |
4 |
银行卡 |
返回示例
成功示例:
{
"code": 0,
"msg": "查询成功",
"pid": 1001,
"status": 1,
"pay_status": 1,
"settle_status": 1,
"money": "50.00",
"settle_type": 1,
"settle_account": "alipay@alipay.com",
"settle_name": "张三",
"order_num": 10,
"order_num_today": 3,
"order_num_lastday": 2,
"order_money_today": "45.00",
"order_money_lastday": "35.00",
"timestamp": "1721206072",
"sign": "xxxxx",
"sign_type": "RSA"
}
失败示例:
{
"code": -1,
"msg": "商户不存在"
}
其他说明
注意事项
- 接口访问频率限制:每分钟最多10次。
- 返回的金额数据(余额、订单金额)均保留2位小数。
- 商户状态为"已封禁"时,支付状态和结算状态均会显示为"关闭"。
- 建议定期查询商户状态,及时处理状态异常的情况。