通讯模式
接口如无特殊要求均采用HTTP POST方式提交。
接口地址
- 测试请求地址:https://mch-juhe.baofoo.com/api
- 生产请求地址:https://juhe.baofoo.com/api
- 生产备用入口地址:https://juhe-backup.baofoo.com/api
备用入口说明
系统目前已支持双机房多活。
主域名:juhe.baofoo.com
备用域名:juhe-backup.baofoo.com
当机房出现异常情况主路径业务不可用时,我们内部会自动切换,但切换后客户端可能存在dns缓存解析未及时生效情况。因此建议贵司评估考虑增加下备用域名,当系统监测到主域名服务异常不可用时,可以自动切换至备用域名,以保证服务的可持续性。
主域名:juhe.baofoo.com
备用域名:juhe-backup.baofoo.com
当机房出现异常情况主路径业务不可用时,我们内部会自动切换,但切换后客户端可能存在dns缓存解析未及时生效情况。因此建议贵司评估考虑增加下备用域名,当系统监测到主域名服务异常不可用时,可以自动切换至备用域名,以保证服务的可持续性。
参数说明
参数类型 | 简称 | 参数说明 |
---|---|---|
整数 | I | 整数,十亿以内,简称是大写INT的首字母 |
日期 | D | 使用yyyyMMdd(如20210315)的格式 |
日期时间 | T | 使用yyyyMMddHHmmss(如20210315155012)的格式 |
字符串 | S | 任意合法的字符串,如S(16),表示字符串长度不超过16位 |
枚举值 | E | 见具体参数描述 |
浮点数 | F | 不超过10亿,小数点后最多7位 |
复合类型 | C | 数组内部嵌套键值对 |
签名和验签
- 所有请求和返回报文都包含签名参数,接收方务必检查签名的正确性,以保证业务数据合法安全。
- 签名和验签支持国密(SM2)和RSA两种方式,签名结果需要转换成16进制字符串。
- RSA签名使用标准签名算法”SHA256withRSA”,密钥长度2048位。
- RSA签名步骤:明文转json字符串->RSA->HEX(16)->密文(signStr)
幂等支持
本文档中部分接口支持幂等,当同一个商户订单号outTradeNo多次调用时,遵循如下:
- 同一个outTradeNo代表同一笔交易,outTradeNo需保证全局唯一
- 如之前已经返回成功,再次调用仍然会返回成功,不会重复处理交易
- outTradeNo只能包含字母、数字、下划线 _
特殊说明
本文档中部分接口字段名前包含中划线(-),当出现中划线时,表示该字段为上一级字段的叶子字段,即代表父字段为一个集合字段(JSON数组或JSON格式)
作者:xiaofeng 创建时间:2025-03-25 15:52
最后编辑:xiaofeng 更新时间:2025-06-05 10:43
最后编辑:xiaofeng 更新时间:2025-06-05 10:43