"支付接口文档_v1.0.01"
本文档主要介绍了与支付相关的API接口规范,包括请求方式、签名机制、响应格式、接口地址以及具体的接口定义,适用于客户端与服务器之间的数据交互,确保交易的安全性和一致性。
1. 接口请求方式:
接口通常使用POST方法进行请求,请求数据以JSON格式传递。这意味着客户端需将数据结构化为JSON对象,然后发送到服务器。
2. 接口签名:
为了确保数据的安全性,接口采用了签名处理机制。所有参数按照key的字典顺序排序,空值的参数不参与签名。然后,这些排序后的参数与MD5KEY(由平台分配的密钥)通过&连接,形成待签名串。接下来,使用MD5算法对这个串进行摘要,并将结果放入报文的sign字段。MD5KEY应保密,不应在报文中暴露。
3. 响应数据格式:
默认情况下,请求和响应均以JSON格式进行,这使得数据交换更易于解析和处理。
4. 接口地址:
基础URL为`http://api.szcsjn.cn/grmApp/`,在此基础上添加具体的接口路径以完成请求。
5. 接口定义:
- 1wap支付下单:
接口路径:`createWapOrder.do`,用于生成wap支付的订单。
- 2扫码支付下单:
接口路径:`createScanOrder.do`,用于创建扫码支付订单。
- 3支付成功后台通知:
当支付成功时,服务器会发送通知,客户端需返回`success`确认已成功接收。未响应或响应错误,服务器会重试最多3次。
- 4订单查询:
接口路径:`queryOrder.do`,允许查询订单状态。
6. 版本与更新:
文档版本为1.0.0,更新日期为2017年12月18日,创建者未明确提及。
7. 字段说明:
例如,`version`表示版本号,`merId`代表商户编号,具有特定的长度和格式要求。
该文档详细规定了支付接口的交互流程,包括请求构建、签名验证、响应处理等关键步骤,旨在确保支付过程的稳定性和安全性。对于开发人员来说,理解和遵循这些规范是实现安全支付功能的关键。