1. 2、平台规范
  • 1、接入指引
    • 1.1 阅读人员与名词解释
    • 1.2版本发布说明
    • 1.3接入准备
    • 1.4接入指引
  • 2、平台规范
    • 2.1接口格式定义
    • 2.2 加签验签说明与代码示例
    • 2.3 参数说明
    • 2.4上线前检查清单
  • 3、业务指引
    • 3.1 商户入网业务接入指引
    • 3.2 余额分账业务接入指引
    • 3.3 支付订单对账业务接入指引
  • 4、API列表
    • 4.1商户入网类接口
      • 4.1.1 图片上传接口
        • 4.1.1.1 公共文件上传（进件用上传临时文件）
      • 4.1.2 商户入网与配置
        • 4.1.2.1 商户添加
        • 4.1.2.2 商户更新
        • 4.1.2.3 收单商户入网
        • 4.1.2.4 收单商户更新
        • 4.1.2.5 通道添加
        • 4.1.2.6 通道变更
        • 4.1.2.7 商户详情查询
        • 4.1.2.8 收单商户更新详情查询
        • 4.1.2.9 分账开通
        • 4.1.2.10 分账变更
        • 4.1.2.11 分账开通结果查询
        • 4.1.2.12 分账关系绑定
        • 4.1.2.13 分账关系解绑
        • 4.1.2.14 微信关注配置
        • 4.1.2.15 微信关注配置查询
        • 4.1.2.16 实名认证申请
        • 4.1.2.17 实名认证申请状态查询
        • 4.1.2.18 实名认证授权状态结果查询
        • 4.1.2.19 商户入网通知
      • 4.1.3 门店管理
        • 4.1.3.1 门店添加
        • 4.1.3.2 门店更新
    • 4.2聚合支付交易类接口
      • 4.2.1 支付订单对账下载
        • 4.2.1.1 对账单下载任务创建
        • 4.2.1.2 对账单下载任务查询
        • 4.2.1.3 对账单下载任务分页查询
    • 4.3订单分账类接口
    • 4.4余额分账类接口
      • 4.4.2 余额查询接口
        • 4.4.2.1 余额查询
      • 4.4.1 余额分账相关接口
        • 4.4.1.1 B2B转账
        • 4.4.1.2 转账查询
      • 4.4.3 提现相关接口
        • 4.4.3.1 提现
        • 4.4.3.2 提现查询
        • 4.4.3.3 查询提现银行卡
    • 4.5信用付（先享后付）类接口
    • 4.6大额支付类接口
    • 4.7 资产营销类接口
      • 4.7.1 营销资产核销开放接口
        • 4.7.1.1 资产预查核验
        • 4.7.1.2 资产交易（核销）
        • 4.7.1.3 资产交易（核销）查询
        • 4.7.1.4 资产交易（核销）撤销
        • 4.7.1.5 资产交易（核销）撤销查询
        • 4.7.1.6 资产余额查询
        • 4.7.1.7 资产交易对账单拉取
        • 4.7.1.8 付款码订单轮询查询
        • 4.7.1.9 付款码订单结果通知
      • 4.7.2 品牌商户专用营销资产核销接口
        • 4.7.2.1 资产预查核验（品牌商户）
        • 4.7.2.2 资产交易（核销）（品牌商户）
        • 4.7.2.3 资产交易（核销）查询（品牌商户）
        • 4.7.2.4 资产交易（核销）撤销（品牌商户）
        • 4.7.2.5 资产交易（核销）撤销查询（品牌商户）
        • 4.7.2.6 资产余额查询（品牌商户）
        • 4.7.2.7 资产交易对账单拉取（品牌商户）
        • 4.7.2.8 付款码订单轮询查询（品牌商户）
        • 4.7.2.9 付款码订单结果通知（品牌商户）
    • 4.8辅助类接口
      • 4.8.1 开放平台API示例控制器
        • 4.8.1.1 参数加密示例
      • 4.8.2 配置获取类接口
        • 4.8.2.1 获取MCC行业类目树
        • 4.8.2.2 获取区域列表（三级联动查询）
        • 4.8.2.3 获取银行总行列表
        • 4.8.2.4 获取银行支行列表
        • 4.8.2.5 获取易宝MCC行业类目树
        • 4.8.2.6 获取易生MCC行业类目树
        • 4.8.2.7 获取易生支付宝微信MCC映射关系列表
        • 4.8.2.8 获取平安银行MCC映射关系列表
      • 4.8.3 交易投诉处理类接口
        • 4.8.3.1 投诉单分页查询
        • 4.8.3.2 投诉单详情查询
        • 4.8.3.3 回复投诉用户
        • 4.8.3.4 完结投诉处理
        • 4.8.3.5 投诉凭证图片上传
        • 4.8.3.6 投诉凭证图片查看
    • 4.9银行账户与分账类接口
      • 4.9.1 EBK账户类
        • 4.9.1.1 EBK账户注册
        • 4.9.1.2 EBK账户基本信息查询
        • 4.9.1.3 EBK账户绑定提现账户
        • 4.9.1.4 EBK账户解绑提现账户
      • 4.9.2 EBK动账交易类
        • 4.9.2.1 账户转账
        • 4.9.2.2 EBK账户提现
        • 4.9.2.3 批量清分
      • 4.9.3 EBK交易查询类
        • 4.9.3.1 转账状态查询
        • 4.9.3.2 EBK账户余额查询
        • 4.9.3.3 提现状态查询
        • 4.9.3.4 清分状态查询
  • F.附录
  • FAQ
  • 回收站
    • 平台公用信息接口
      • 获取省市区信息
      • 获取行业类目信息
      • 获取银行信息
      • 商户图片上传
    • 商户开放接口
      • 更新商户接口
      • 查询商户审核信息接口
      • 简单商户创建接口
      • 创建商户接口
    • 开放支付交易订单控制器
      • 批量更新订单业务类型
  1. 2、平台规范

2.2 加签验签说明与代码示例

加签验签说明#

提示#

双向认证
商户、合作方与收呗交易报文双向认证。
1.
商户、合作方保存自己的私钥证书和收呗支付公钥证书。
2.
收呗保存自己的私钥证书和商户、合作方的公钥证书。
3.
商户、合作方向收呗发起请求时，商户、合作方使用自己的私钥签名。
4.
收呗接收商户、合作的请求时，收呗使用商户、合作方公钥进行验签。
5.
收呗返回商户、合作方应答时，收呗使用自己的私钥签名。
6.
商户、合作方接收收呗交易应答时，商户、合作方使用收呗的公钥验签

公钥私钥#

测试环境
收呗平台公钥：
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA7hyx4CAbEA1BWUqdpLNeAA2QZ+/VtMpxmgR3iHE5qgMIkCJ7oQmzTgMiGv37gbFD2PRWL9raPwWEhqCor3Ga+bbhr94ozUn/Q/A+shBqxfbtKjYUpHXOD2O4dcaJ2XBzO8wHDwQKaBw8P21A/UgF1vcCHs3qHExaiWFswgF4Pb7Nt8D9nqa1FI9jRjcpRcO3ouqxWRJMoqCVsjyQsqXYSsFHw/0ysyd07a2gDVymZlHaGTQREjCme6FR5hq8noZ2CrTyrsNE5OXo7YylkfAdHEZP4b7YC5ExN01vps3Zg0YbuCJCLTWHJD7a+3cRJenR+KKou/glnZJxUZX+dTjYmwIDAQAB

代理商私钥：
-----BEGIN PRIVATE KEY-----
MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCj/jngLrcfYBDn
vPjNrOCZ/RhD19MBix2TyqzRDIuMAxwsuarvnFh7am0YjxnOEf5VhQoqPMwvYGSa
pDD1gU5ryR9RSEvtxcU76/QUa8E4IECOHjQ7tb6cuWzjIPA9uD80WUiIBWKAlLPv
puU5OIgD0JGB4kcSkIy6LRNLa5jjJ5AgfJo7+8GIqUldCbnWM2oMoNkjaPfnbOMR
QxI5CfLdVULuZmTZ5xEx6MDWPqDtJND0qpU2GCWxJAdi82o2nQbGNMmRqYHq1euy
PeZZdq0bcFSN45LH0qEiTCrgUVQ/dIdNhKowVesJX3OHrwggHsxv8OY9xcqysrsD
r72v54bXAgMBAAECggEACo2Wy24Ku3FcFSNMWhLPj0lB2moVKBzpnLPm0c1ZpvtF
rqpEUfScVVVlJpI4l9Hcv7FkgpDiTXFS5b8+bwYHrPQiIbi0XiZ+tz/LXB3pnLDw
WNTpdycOar3lZLQM2tY0YnU51Ciz+odE7LjmOKBdvqLQQkg9pC7WIvCm62wzfx1p
xNDiQtF1GAvCB1eeE80taYYt2+YsMPL6CTTaRjhwZU8MK3rZak+oO0zgJLNQrWM8
RGbeYS4tE9RUAFZO98b93GupDKQ1Ha6YPVm3DGITZLy4XFSDxUt2nMcJNdzmAU/6
B0lBCvH/Z76o4dlYmGwNFqXOZUvQgqwAAa99f4A3JQKBgQDSG8YR9DdojrHk6Ab/
RY1l5VGHV4K9i8WWrg4C2NI5sDZ8LNq9NH1b7FymG2o5y2KzElBXz8fkp3TYlCpW
s30hwBMCNnSIckyaW/oRUV0p7fz9iI2PQWiOj2InFWVSl8K5Rt8QkuzIdCHaw1Mm
GxNqpO1Le+/Sb+PIMk9U0toGhQKBgQDHz+gMD0wGb2cH7uYsb/VRhu9p83Crbcwi
7iaxO2Xd5g0EpfOBEtciDAsd+iBmYM1WTWDdgFRSn6Pgaiq43L6CCt2I4n/WqkyC
GvU/RmgVGRdfBY9y2ab7xkakSPLxcHUPlt6a1qdzLyiMGxv1ecGEKxoxB9RKYMFa
gaml2yY8qwKBgFg8x8MUgAyOGNGcTAv6prZLRyECtGpr/7AXKtUxP6Bwi4E8ySQ6
ngbzzbkIvGTHMI0pvMoT/cveM6kdGGbO/FcnNhRw0CHZdqhAxlVtiSWpx9yl82Vd
P87XEo59Ys774xAyXk20lnJcqzcXXp0bM91OpEVWKFKFIPEbh8uEvYGNAoGALxer
Ixx/2IxtBguiKBsDAIIC7z+28FBiamEisWbEbXYI322VZHhiR936yMfo1vg9rPdz
uwDB3u9NGlkrVIKCS/fvmpF3e8qLWaas4orfgQl23qha1MDDgFeM0q92wry0ekYe
lPO+Z4FX1x2Ui1h06YeXFrM3r4f6SjCBIVvzOR0CgYBCZej8pfc87pD/ALMvdy1k
0gnFYCVUv1z4hWf5Ruz/djWxdL5swgB13Bkj/zJcK5wWXvIOfDDqUlS/h9acYdfw
mbZuy2lEiil+YzatWr+IcB6jy8K61/z55nUDYk6N1NJNfGyDzxyvhNdLV1pEErsg
C+f+hwVNxFTyDGLA1M84kw==
-----END PRIVATE KEY-----
商用环境

签名#

【商户请求加签】 商户使用"商户自己的 RSA 私钥"对请求报文进行加签。
开发注意：
1、空字符串也参与签名
2、为了解决签名的效率问题，部分接口的请求体（reqBody）或者响应体（rspBody）是不参与签名的，具体参加具体接口的特殊签名说明
签名流程：
1、将请求报文（排除 sign 字段）按字段名的 ASCII 码从小到大排序（嵌套参数用点号 . 扁平化，如 reqBody.amount；值为 null 的字段不参与签名）
2、将排序后的参数拼接为字符串：key1=value1&key2=value2&...（参数名和值之间用 = 连接，参数之间用 & 连接）
3、对拼接后的字符串计算 MD5（hex 小写，32 位）
4、对 MD5 值进行 RSA2 签名（SHA256withRSA，密钥位数 2048），得到 Base64 编码的签名串 sign
待签名串 = key1=value1&key2=value2&...（ASCII升序，排除sign，null值不参与）
md5值 = MD5小写(待签名串)
sign = SHA256withRSA_SIGN(md5值, 商户私钥)
请求报文
------------加签前-------------------------

{
    "requestId": "51",
    "timestamp": "1786106107116",
    "nonce": "7898bn800789890000",
    "reqBody": {
        "mccType": "01"
    }
}


------------加签后-------------------------
注意: 
1. 空字符串也参与签名
2. 数据类型如果不一致，也会导致验签失败
3. 比如 transAmount 必须是数值类型，不能是字符串

{
    "requestId": "51",
    "timestamp": "1786106107116",
    "nonce": "7898bn800789890000",
    "sign": "k4dAJ1htyty72LCOMMBVBFBh5UaQ3U25TtnBfMAVeCy85G6ff3IQKsrO7bGHEBJOpKgSrMKi5wkX3U6RLtnEWRxEwCVmRtlpCHqKg9aSYF+L9cwz2bfqdVCb3rTU0YO3oUl/bUXUfwmLJ8QaESJC7/a9eojHwUjLcMXDMfUwVVt3g9FspB7c2fxkd+xe0MndimSylF+YRhP1N/BMlwj/iKjvgYHs4YXgPvsS9c6U8stY2JuCTWqqvMIIHCxPRCcfzf5YfkAtbSzEBeXHPn2KUswE7Rht5YzXeTHTmVZSQ/QMyZwf0HMZuOTQQcLVcL4pcPBPptQZOutbiwjXl8C8Lw==",
    "reqBody": {
        "mccType": "01"
    }
}

验签#



【商户验签】  商户使用 "收呗的RSA公钥" 对收呗的响应报文 进行验签
待签名串 = key1=value1&key2=value2&...（ASCII升序，排除sign，null值不参与）
md5值 = MD5小写(待签名串)
验签结果 = RSA公钥验签(待签名串, 响应返回的sign, 收呗公钥)

【重要】通过验签确定响应的报文是否合法，是保障通信安全的保障手段，建议每个接口都需要验签
响应报文
{
    "code": 200,
    "msg": "成功",
    "timestamp": "1786106107116",
    "nonce": "789rrtr8999000",
    "rspBody": {
        "playType": "MemberApply",
        "applyNo": "318516039568",
        "merTrace": "631000000005575"
    },
    "sign": "k5QtbtHLjvCTd3eiRHPI+hoFd8TizvuwQ443r7K/yjUDeCOWflJryPbsBlEonRc/2mm43s+x/f3h1pAa5swuHODoYDo6dYFHa5PjH3bD2Fnds5IjeYcdQxbcDCQugXm5m3eoR+jWUrX28XnL63qdgdnaYDM4SlF7QC+59XxA8xBwAsPGwq9tOOFTYNuv4f2XKB8UH3tSjj0o31RUix3XtEr8TDsvFrk3znaWo0Vue2JrKhvJzfrHeeisMZlhYckvlJqDQdOXwtz1hxoo8DMGuZl08gXpEeYOZBtoW0sX+MJnYcEQ4VpoBzgxP5YSOaGg56rM7x8I34WX8xqglSX7Wg=="
}

java版本的加签、验签工具类#

修改于 2026-08-10 11:10:42
上一页
2.1接口格式定义
下一页
2.3 参数说明
Built with