业务系统订单查询通知服务
1. 通讯方式
平台和业务系统之间采用 http 或 https 的连接方式进行通讯
2. 报文格式
以 GET 方式请求,参数以 URL Param 的方式传递
响应为 JSON 格式数据
说明:
所有金额,如非特殊说明,都以分为单位
报文统一采用 utf-8 编码
3.1订单金额查询
请求参数
名称 | 说明 | 长度 | 是否需要 签名 | 限制 | 备注 |
---|---|---|---|---|---|
orderNo | 订单号(小票) | 是 | |||
sign | 签名 |
响应参数
名称 | 说明 | 长度 | 是否需要 签名 | 限制 | 备注 |
---|---|---|---|---|---|
status | 状态码 | 是 | 1:成功 | ||
msg | 返回信息 | 是 | |||
money | 订单金额 | 是 | |||
sign | 签名 | 是 |
3.2订单消费/退货通知
请求参数
名称 | 说明 | 长度 | 是否需要 签名 | 限制 | 备注 |
---|---|---|---|---|---|
orderNo | 订单号(小票) | 是 | |||
transRefNo | 交易参考号 | 是 | |||
transTime | 交易时间 | 是 | 格式:yyyyMMddHHmmss | ||
status | 状态 | 是 | 1:成功,0:失败 | ||
sign | 签名 |
响应参数
名称 | 说明 | 长度 | 是否需要 签名 | 限制 | 备注 |
---|---|---|---|---|---|
status | 状态码 | 是 | 1:成功 | ||
msg | 返回信息 | 是 | |||
sign | 签名 |
3.3签名算法
采用 MD5 加密
第一步,使用URL键值对的格式,按照接口文档中的字段顺序(即 key1=value1&key2=value2…) 拼接成字符串 stringA
第二步,在 stringA 最后拼接上&key={secret_key}得到 stringSignTemp 字符串进行 MD5 加密, 得到 sign 值
特别注意以下重要规则:
- 参数名按照接口文档中的字段顺序排序
- 如果参数的值为空不参与签名;
- 参数名区分大小写;
- 验证签名时,传送的 sign 参数不参与签名,将生成的签名与该 sign 值作校验;
- secret_key 双方事先约定