闪信互联商户对接文档V1.4课案.docx

PAGE9 / NUMPAGES24 闪信互联商户接口 技术集成文档 V1.3  修订记录 修订日期 修订人 动作 修订说明 版本号 2014-11-06 刘芳 创建 1.0 2015-04-27 刘芳 修改 增加非自营商户信息字段 1.1 2015-05-11 刘芳 修改 增加商户H5下单接口 1.2 2015-09-09 于江波 修改 合并商户下单接口，增加商户下单接口字段 1.3 2015-12-30 熊冬 修改 新版H5收银台提交URL 1.4  目录 TOC \o 1-3 \h \z \u HYPERLINK \l _Toc429730206 1 引言 PAGEREF _Toc429730206 \h 4 HYPERLINK \l _Toc429730207 1.1 文档概述 PAGEREF _Toc429730207 \h 4 HYPERLINK \l _Toc429730208 1.2 业务术语 PAGEREF _Toc429730208 \h 4 HYPERLINK \l _Toc429730209 1.3 通讯模式 PAGEREF _Toc429730209 \h 4 HYPERLINK \l _Toc429730213 1.3.1 后台通讯模式 PAGEREF _Toc429730213 \h 4 HYPERLINK \l _Toc429730214 1.3.2 如何验证是否闪信互联请求: PAGEREF _Toc429730214 \h 5 HYPERLINK \l _Toc429730215 1.4 安全规范 PAGEREF _Toc429730215 \h 5 HYPERLINK \l _Toc429730217 1.4.1 数字签名 PAGEREF _Toc429730217 \h 5 HYPERLINK \l _Toc429730218 1.4.2 提交URL PAGEREF _Toc429730218 \h 6 HYPERLINK \l _Toc429730219 2 商户接口 PAGEREF _Toc429730219 \h 7 HYPERLINK \l _Toc429730221 2.1 商户下单接口 PAGEREF _Toc429730221 \h 7 HYPERLINK \l _Toc429730222 2.2 商户订单查询接口 PAGEREF _Toc429730222 \h 12 HYPERLINK \l _Toc429730229 2.3 商户退款接口 PAGEREF _Toc429730229 \h 16 HYPERLINK \l _Toc429730230 2.4 商户后台结果通知接口 PAGEREF _Toc429730230 \h 20 HYPERLINK \l _Toc429730231 3 附录 PAGEREF _Toc429730231 \h 23 HYPERLINK \l _Toc429730232 3.1 错误码信息 PAGEREF _Toc429730232 \h 23 引言 文档概述 阅读对象：合作商户技术开发人员。。 业务术语 返回 页面跳转同步通知。闪信互联根据得到的数据处理完成后，当前页面从商户的页面自动跳转到闪信互联的收银台页面。 请求 通过HTTPS协议把需要传输的数据发送给接收方的过程。 通知 服务器异步通知。闪信互联根据得到的数据处理完成后，闪信互联的服务器主动发起通知给商户的网站，同时携带处理完成的结果信息反馈给商户网站。 请求参数 请求参数是商户在与闪信互联进行数据交互时,提供给闪信互联的请求数据,以便闪信互联根据这些数据进一步处理。 通讯模式 商户接口全部采用https协议通讯，保证通讯链路数据传输的安全，同时全部采用数字签名保证交易数据不被篡改。将整个串做一次加密保证数据不被窃取。 后台通讯模式 后台通讯模式指商户后台服务器与闪信互联系统后台服务器直接通讯的模式，主要用于非页面交互的交易，比如：商户订单查询。商户根据接口要求组织报文后直接向闪信互联系统服务器发起交易请求，闪信互联系统处理完成后返回结果报文。 如何验证是否闪信互联请求: 当商户获取到待签名字符串后，需要把私钥直接拼接到待签名字符串后面，形成新的字符串，利用MD5的签名函数对这个新的字符串进行签名运算，从而得到32位签名结果字符串。此时这个新的字符串需要与请求参数中的hmac的值进行验证是否相等，来判断签名是否验证通过。 安全规范 数字签名 为保证数据传输过程中的数据真实性，完整性和不可抵赖，我们需要对数据进行数字签名，在接收签名数据之后迚行签名校验。签名算法为MD5。 MD5签名算法：MD5 本是一种摘