通讯模式
接口如无特殊要求均采用HTTP POST方式提交。
接口地址
参数说明
参数类型 | 简称 | 参数说明 |
---|---|---|
整数 | I | 整数,十亿以内,简称是大写INT的首字母 |
日期 | D | 使用yyyyMMdd(如20210315)的格式 |
日期时间 | T | 使用yyyyMMddHHmmss(如20210315155012)的格式 |
字符串 | S | 任意合法的字符串,如S(16),表示字符串长度不超过16位 |
枚举值 | E | 见具体参数描述 |
浮点数 | F | 不超过10亿,小数点后最多7位 |
复合类型 | C | 数组内部嵌套键值对 |
布尔类型 | B | 布尔类型:true/false |
签名和验签
- 所有请求和返回报文都包含签名参数,接收方务必检查签名的正确性,以保证业务数据合法安全。
- 签名和验签支持SM2和RSA两种方式,签名结果需要转换成16进制字符串。
- RSA签名使用标准签名算法”SHA256withRSA”,密钥长度2048位。
- RSA签名步骤:明文转json字符串->RSA->HEX(16)->密文(signStr)
幂等支持
- 本文档中部分接口支持幂等,当同一个商户订单号requestNo多次调用时,遵循如下:
- 同一个requestNo代表同一笔交易,requestNo需保证全局唯一
- 如之前已经返回成功,再次调用仍然会返回成功,不会重复处理交易
- requestNo只能包含字母、数字、下划线 _
特殊说明
本文档中部分接口字段名前包含中划线(-),当出现中划线时,表示该字段为上一级字段的叶子字段,即代表父字段为一个集合字段(JSON数组或JSON格式)
作者:xiaofeng 创建时间:2025-03-25 16:13
最后编辑:xiaofeng 更新时间:2025-06-05 10:43
最后编辑:xiaofeng 更新时间:2025-06-05 10:43