欢迎使用商户接口文档中心

提供完整的API接口文档、协议规则和签名算法说明

接口列表

余额查询接口

查询商户账户余额信息

查看文档

代收下单接口

创建代收订单，获取支付链接

查看文档

代收订单查询接口

查询代收订单状态

查看文档

代付下单接口

创建代付订单，执行转账操作

查看文档

代付订单查询接口

查询代付订单状态

查看文档

协议规则

传输协议

传输方式：采用HTTP传输（生产环境建议HTTPS）

提交方式：POST 或 GET

内容类型：application/json

字符编码：UTF-8

签名算法：MD5

参数规范

交易金额：默认为卢比交易，单位为分，参数值不能带小数。

时间参数：所有涉及时间参数均使用精确到毫秒的13位数值，如：1622016572190。时间戳具体是指从格林尼治时间1970年01月01日00时00分00秒起至现在的毫秒数。

签名算法

签名秘钥请到"主页"右上方"商户信息"中查看

签名生成的通用步骤

  1. 设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
  2. 在stringA最后拼接上key，即 StringA +"&key=" + 私钥，得到stringSignTemp字符串。
  3. 对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

重要规则

参数名ASCII码从小到大排序（字典序）

如果参数的值为空字符串或null不参与签名

参数名区分大小写

验证调用返回或支付中心主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验

支付中心接口可能增加字段，验证签名时必须支持增加的扩展字段

签名示例

如请求支付系统参数如下：

{
    "mchNo": "1000",
    "mchOrderNo": "P0123456789101",
    "amount": "10000",
    "clientIp": "192.168.0.111",
    "returnUrl": "https://172.0.0.1",
    "notifyUrl": "https://172.0.0.1",
    "reqTime": "20190723141000",
    "version": "1.0"
}

排序后的参数字符串：

amount=10000&clientIp=192.168.0.111&mchNo=1000&mchOrderNo=P0123456789101¬ifyUrl=https://172.0.0.1&reqTime=20190723141000&returnUrl=https://172.0.0.1&version=1.0

拼接密钥后：

amount=10000&clientIp=192.168.0.111&mchNo=1000&mchOrderNo=P0123456789101¬ifyUrl=https://172.0.0.1&reqTime=20190723141000&returnUrl=https://172.0.0.1&version=1.0&key=your_secret_key

MD5加密后（大写）：

4A5078DABBCE0D9C4E7668DACB96FF7A

如有问题，请联系技术支持团队

© 2024 商户接口文档中心. All rights reserved.