汇财支付api支付程序接口开发文档-v2.0

汇财支付Api支付网关技术接口规范
一、引言 (1)
1.目的 (1)
2.范围 (1)
二、基本流程 (1)
三．接口描述 (2)
1.概述 (2)
2.订单支付请求 (2)
3.订单支付结果通知 (5)
4.商户页面/服务器底层接受支付通知 (5)
附录一：支付渠道代码表............................................................................. 错误！未定义书签。

一、引言
中国目前电子商务发展日趋成熟，电子商务网站越来越多，但是统一的支付平台还不是很成熟，基于这种环境，有必要建立一套完整的支付体系。

本支付系统集成各个大银行的支持，提供给商家一个统一的平台，方便商户使用，能够及时的反应支付结果信息。

遵循“专业、安全、高效、便捷”式的设计原则，汇财支付网系统为开展电子商务的商户提供了统一的网上交易支付平台。

该网系统定义了一个和商户系统的开放接口，商户系统通过这一接口就可以使用众多现有流行的银行支付系统完成网上交易，而不必针对每家银行的支付系统进行设计。

同时系统还提供了完善的商家后台管理功能。

1.目的
本手册的主要目的是帮助汇财支付商户熟练掌握支付网的交易流程、网关技术接口。

2.范围
本文档适用于商户了解开发接口和接口流程
二、基本流程
汇财支付接口使用HTTP POST方式连接并发送信息，信息放在HTTP的消息体中。

每个HTTP POST请求发送后，接收端在接收并处理请求时提取商户提供的订单信息，订单信息经过MD5加密，然后再进行提交。

之后经过后台处理，汇财支付网关获取结果参数进行MD5加密并与系统Md5签名字段进行比较，如果校验一致，则把订单结果信息通知给商户或用户。

当发送端接收到确认信息后，进行支付结果逻辑处理。

在某些要求务必送达的请求中，上述通知-确认流程必须由接收端确保，如果发送端不能成功请求地址的，将进行重复几次通知。

目前的协议中，订单支付结果通知是必须送达商户的信息。

三．接口描述
1.概述
接口包括以下几个部分：
●商户订单支付请求
提交订单支付请求
通知商户及用户订单支付有关信息
●商户后台管理网站
查询历史交易，查询对账信息
2.订单支付商户
●商户号：xxxxxxxxx
●终端号：xxxxxxxxx
●商户密钥：xxxxxxxxxxxxxxxxxxxxxxxxxxxx
●汇财支付请求地址为：/payindex
注意：
请勿在测试时候进行大额支付，请使用1分钱或1角支付测试。

支付请求域名需咨询汇财支付商务确认。

对接接口请参照附件对应开发语言案例进行接入。

签名字段的验证
目的：测试商户端的订单信息是否能被汇财支付网系统正确接收；
说明：商户端需要提供以下信息：MemberID、TerminalID、PayID、InterfaceVersion、TradeDate、TransID、OrderMoney、ProductName、Amount、ProductLogo、Username、AdditionalInfo、PageUrl、ReturnUrl、NoticeType、Signature（各项具体含义详见下文相关参数表），这些字符串按以下格式及顺序将请求字段组合成为待验证的一个无间隔字符串，待验证字符串的生成过程，也就是进行MD5加密的过程：
Md5签名格式（利用附件案例的MD5算法类）
Md5Sign= MemberID + “~|~” + PayID + “~|~”+ TradeDate + “~|~” + TransID + “~|~”+ OrderMoney + “~|~” + PageUrl + “~|~” + ReturnUrl + “~|~” + NoticeType + “~|~”+ Md5Key;
将参数值经过MD5加密成为结果串字符，然后再进行提交，提交后的地址栏变为例如：
/payindex?OrderMoney=1&TradeDate=20140115162903&PageUrl=h ttp:///recv/baofoo4/page.html&InterfaceVersion=4.0&ReturnUrl=htt p:///recv/baofoo4/result.html&MemberID=100000178&TransID=1309235 8&KeyType=1&NoticeType=1&TerminalID=10000001&Signature=d77b11a69e7c8a105dd42e5 ac897b7bf&PayID=
订单支付请求由商户发起，当用户在商户网站选择商品，并确认使用汇财支付平台支付后，商户通过HTTP POST方式到汇财支付服务接口。

支付请求中TransID（订单号）作为主键，如果有重复的交易请求存在，以第一个成功交易为准，后续重复交易不被受理。

相关参数表：
注：1.请注意必填字段，必须给定值，不允许空字符串;
2.其他非必填的字段也是必填字段，但是可以赋值空字符串；
3.如果提交的参数中有中文请将url编码设为utf-8
●商户订单号重复的处理
汇财支付不支持商户提交重复订单号，对重复订单号将直接提示订单已经提交。

3.订单支付结果通知
商户提交订单支付请求后，用户通过正常的支付流程支付成功或者支付失败后，支付接口将支付结果通知给商户。

通知逻辑处理接入方自己考虑在前台通知处理或底层处理或前后共同处理。

●前台跳转通知。

●底层无动作通知。

4.商户页面通知/服务器底层支付通知
汇财支付网关采用post方法将参数按照预定顺序发给商户返回的URL地址，传回相关参数：
●传回值页面中待验证字符串的生成过程，按以下格式及顺序将请求字段组合成为待
验证字符串。

待验证字符串大小写敏感：
Md5Sign= “MemberID=”+ MemberID +“~|~”+“TerminalID=”+ TerminalID +“~|~”+“TransID=”+ TransID +“~|~”+“Result=”+ Result +“~|~”+“ResultDesc=”+ ResultDesc +“~|~”+“FactMoney=”+ FactMoney +“~|~”+“AdditionalInfo=”+ AdditionalInfo +“~|~”+“SuccTime=”+ SuccTime +“~|~”+“Md5Sign=”+ md5key;
●该字符串经过md5加密后与系统生成的Md5签名字段进行比较。

校验一致才把订单结果信息显示给用户。

●注意：支付可能存在卡的真实面额与用户提交的订单金额不一致的情况，从而导
致实际成交金额与用户提交金额不一致，请接收到支付结果后仔细核对实际成交
金额，以免造成订单金额处理差错。

●通知底层（ReturnUrl）的参数
●通知的md5签名格式
Md5Sign= “MemberID=”+ MemberID +“~|~”+“TerminalID=”+ TerminalID +“~|~”+“TransID=”+ TransID +“~|~”+“Result=”+ Result +“~|~”+“ResultDesc=”+ ResultDesc +“~|~”+“FactMoney=”+ FactMoney +“~|~”+“AdditionalInfo=”+ AdditionalInfo +“~|~”+“SuccTime=”+ SuccTime +“~|~”+“Md5Sign=”+ md5key;。