深圳市华融电子支付科技有限公司 -互联网支付商户支付接口说明V1.2.docVIP

互联网支付

接口说明

V1.2

目录

TOC\o1-3\h\z\u1. 概述 3

1.1. 业务术语 3

2. 交互模式 3

2.1. 请求/响应交互模式 3

2.2. 主动通知交互模式 3

3. 安全规范 4

3.1. 数字签名 4

3.1.1. 签名机制 4

3.1.2. 签名方式 4

4. 接口 4

4.1. 订单支付 4

4.1.1. 接口地址 4

4.1.2. 业务功能 4

4.1.3. 请求参数列表 4

4.2. 外部通知接口 5

4.2.1. 返回参数列表 6

4.2.2. 商城?华融支付) 6

4.2.3. 交易状态枚举表 7

5. 附录 7

5.1银行编码列表 7

5.2签名方法 7

5.3错误代码 8

文档修订

版本号

修改日期

编写

评审

批准

修改内容

1.1

2014-04-06

王晶宇

初稿

1.2

2014-06-20

邓文康

增加支付请求参数、更新银行编码

概述

阅读对象：商户系统（商户）的技术开发人员。

业务术语

名词

说明

备注

支付商户号

（merno）

商户互联网支付合作后产生的商户号

登录互联网支付-商户版

可获得相关信息。

商户密钥

（Key）

商户在开户时用MD5加密方式时生成的MD5密钥

接口名称

针对一些外部接口业务的名字。

交互模式

请求/响应交互模式

请求/响应模式是最常用的一种交互模式。在这种交互模式下，商户向互联网支付系统发送请求数据，并同步等待互联网支付系统处理完毕之后返回的响应数据。

请求/响应模式根据页面流程，可以分为系统调用和页面跳转，系统调用只需要调用相关接口文件就可以完成相关的业务操作，而页面跳转则需要进入互联网支付系统支付的页面，完成相关操作。

如果买家在跳转到互联网支付页面完成相关操作之后，需要互联网支付系统将处理结果立即返回给商户网站的下一步操作页面，让用户继续完成整个操作流程，必须传递参数Return_url（即进入商户系统的下一个操作页面）。

主动通知交互模式

买家从商户网站跳转到互联网支付系统完成最后操作，买家不用再回到商户网站。互联网支付系统会将交易结果采用主动通知的方式提交给商户系统。

这种交互模式如果需要异步返回结果，必须传递Notify_url参数，服务器点对点异步通知服务器主动发起通知，调用机构（商户）在请求时设定好的后台通知地址路径。

安全规范

数字签名

数据传输过程中的数据真实性和完整性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。

签名机制

待签名数据是请求参数按照以下方式组装成的字符串：

所有必输项的参数值用“”链接起来【最后要加上商户开户时的MD5密钥】，并转大写，作为待签名的数据:

签名方式

按照sign_type参数指定的签名算法对待签名数据进行签名。

暂时只支持MD5。

接口

订单支付

接口地址

/user/HC0001.tran

业务功能

调用此接口，根据商户传过来的参数创建交易，返回华融支付页面。

请求参数列表

输入项

输入项名称

属性

是否必输

注释

Merno

商户号

X（14）

是

接入方在互联网支付开户的商户号

Signtype

商户加密方式

X（1）

是

接入方在互联网开户时的加密方式：

M-MD5；

Prdordno

商户订单号

X（50）

是

接入方的商品订单号

bizType

商户业务类型

X（2）

是

10：普通交易

设置交易手续费

Prdordnam

商品名称

X（100）

是

Ordamt

订单金额

X（15）

是

单位：分

Orddate

下单日期

X(8)

是

日期格式：yyyymmdd

如TranType

交易类型

X（5）

是

B2C网银：固定为20102

华融支付：固定为2201

Paytype

支付方式

X(2)

是

固定值：01

与商户业务类型一起设定手续费

bankCode

银行编码

X(16)

否

“接口类型（tranType）为”20102时必填。参见附录中银行列表

custnam

买家姓名

X(100)

否

custmob

买家手机号

X(11)

否

custmail

买家邮箱

X(100)

否

custcardno

买家身份证号

X(18)

否

ThirdParty

第三方支付平台

X（8）

否

LTW联通沃支付平台

ZFB支付宝平台

PLA直连银行(默认)

Return_url

同步通知url

X（200）

是

用户支付成功后，互联网支付平台会组织结果通知、通过POST方式返回、以便商户接收支付结果、返回参数与异步参