通讯模式

接口如无特殊要求均采用HTTP POST方式提交。

符号约定

符号 含义
M 必须填写的域，不允许为null或者空字符串
C 某条件成立时必须填写的域，不允许null或者空字符串
O 自选填写的域，不允许null或者空字符串
R 返回时原样返回请求报文上送的值

参数说明

参数类型 简称 参数说明
整数 I 整数，十亿以内，简称是大写INT的首字母
字符串 S 任意合法的字符串，如S(16)，表示字符串长度不超过16位
S[x]：表示定长x个字节的数字、字母、可见字符，如特殊说明支持数字或者字母
枚举值 E 见具体参数描述
浮点数 F 不超过10亿，小数点后最多7位
复合类型 C JSON数组内部嵌套键值对
布尔类型 B 值：true \ false

签名和验签

  • 所有请求和返回报文都包含签名参数，接收方务必检查签名的正确性，以保证业务数据合法安全。
  • 签名和验签支持国密（SM2）和RSA两种方式，签名结果需要转换成16进制字符串。
  • RSA签名使用标准签名算法”SHA256withRSA”，密钥长度2048位。
  • RSA签名步骤：明文转json字符串->RSA->HEX(16)->密文(signStr)

幂等支持

本文档中部分接口支持幂等，当同一个商户订单号outTradeNo多次调用时，遵循如下：

  • 同一个outTradeNo代表同一笔交易，outTradeNo需保证全局唯一
  • 如之前已经返回成功，再次调用仍然会返回成功，不会重复处理交易
  • outTradeNo只能包含字母、数字、下划线 _
作者：admin  创建时间：2025-03-21 18:41
最后编辑：admin  更新时间：2025-06-17 14:16