总览 - 乾帐通

协议规则

传输方式：采用HTTP传输

提交方式：POST

内容类型：application/json 或 application/x-www-form-urlencoded

字符编码：UTF-8

签名算法：RSA2

参数规范

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

时间参数：所有涉及时间参数均使用精确到毫秒的13位数值，如：1622016572190。

时间戳具体- 是指从格林尼治时间1970年01月01日00时00分00秒起至现在的毫秒数。

签名算法

!>采用RSA2签名算法，具体步骤如下：

步骤 1：参数筛选与排序。

获取所有请求参数（公共参数 + 业务参数）。

排除：

a. sign、signType 字段。

b. 值为空(包括空白字符和 null )的参数。

c. 文件流、字节流等二进制数据。

按参数名 ASCII 升序排序

示例参数

{
"mchNo":"M8888888888888",
"appId":"A8888888888888",
"mchOrderNo":"P001",
"wayCode":"BANK",
"amount":"100",
"currency":"cny",
"clientIp":"127.0.0.1",
"subject":"商品标题",
"body":"商品描述",
"notifyUrl":"http://www.ab.com",
"returnUrl":"",
"expiredTime":"7200",
"channelExtra":"",
"extParam":"",
"reqTime":1769573297033,
"version":"1.0",
"sign":"",
"signType":"RSA2"
}

步骤 2：拼接签名原文

将排序后的参数按 key=value 格式拼接，并用 & 连接。

示例：

amount=100&appId=A8888888888888&body=商品描述&clientIp=127.0.0.1&currency=cny&expiredTime=7200&mchNo=M8888888888888&mchOrderNo=P001&notifyUrl=http://www.ab.com&reqTime=1769573297033&subject=商品标题&version=1.0&wayCode=BANK

步骤 3：生成签名

使用商户私钥生成签名

最终发送的请求示例：

{
"mchNo":"M8888888888888",
"appId":"A8888888888888",
"mchOrderNo":"P001",
"wayCode":"BANK",
"amount":"100",
"currency":"cny",
"clientIp":"127.0.0.1",
"subject":"商品标题",
"body":"商品描述",
"notifyUrl":"http://www.ab.com",
"returnUrl":"",
"expiredTime":"7200",
"channelExtra":"",
"extParam":"",
"reqTime":1769573297033,
"version":"1.0",
"sign":"DCdYG+X7nJTYZvraxkttScsiZyuOSbB/zJTktC9YMQ4B6M85vR...",
"signType":"RSA2"
}
``

总览

协议规则#

参数规范#

签名算法#

步骤 1：参数筛选与排序。#