接入说明
1 接入方式
2 环境区分
生产环境:生产环境域名,请联系平台运营提供(若曾经对接过本系统,仅需替换参数即可)
沙箱环境:沙箱环境域名,请联系技术支持提供(若曾未对接过本系统,务必在沙箱环境根据自身需求进行系列测试)
3 对接demo
Java开发Demo下载
PHP开发Demo下载
4 Header请求参数
参数名称 | 类型 | 参数说明 | 必填 |
---|---|---|---|
orderId | String | 每个 request 的 id,要求每次请求的 id 不一样,会在response 中原样返回 | 是 |
merchantNo | String | 商户编号 | 是 |
agreementId | String | 协议ID | 是 |
appKey | String | appKey | 是 |
requireTime | String | 请求时间格式(yyyy-MM-dd HH:mm:ss) | 是 |
sign | String | 签名 | 是 |
signType | String | 签名类型 MD5/RSA | 是 |
5 签名说明
MD5签名:demo中的SignEncryUtil为MD5签名工具类,有两个加密生成签名方法,GET请求方式时使用encrySignGet,POST请求方式时使用encrySignPost ,具体使用请参考“MD5签名规则”
RSA签名:demo中的SaasApiRsaUtil为RSA签名及数据传输加解密工具类,具体使用请参考“RSA签名规则”。
6 公共响应参数
参数名称 | 类型 | 参数说明 | 必填 |
---|---|---|---|
code | int | 状态码,200表示成功 | 是 |
msg | String | 信息 | 是 |
data | Object | 状态信息 | 否 |
7 异步通知
{"data":{"参数字段名":"参数值"},"tab":业务类型}
//回调使用同一个回调地址,根据类型判断回调业务和解析业务内容体,详见各接口示例。