无忧支付网首页
站内搜索
您当前的位置:主页 > 支付接口申请相关知识 >

统一支付网关的商户接口设计

添加时间:2022-10-11

  根据统一接口设计原则以及网上交易支付的特征,所设计的商户接口应该具备订单规范、交易应答接受规范、日期规范、重复订单规范等。商户接口设计分为订单规范、交易应答接受规范支付接口设计、日期规范和重复订单规范。商户接口的设计是统一支付网关的关键设计,应该将其他银行的不同接口自动屏蔽掉。

  1、订单规范

  订单规范要求如下:

  (1)商户订单系统用订单号标识每一笔订单;

  (2)同一个商户在 1 个交易日之内,不应该出现重复的订单号;

  (3)在支付网关系统当中,通过商户号、日期等可以确保订单号的唯一性;

  (4)若商户已经在支付网关系统当中提交支付订单,则不会再次运行支付程序,以避免出现多次支付错误。

  订单主要参数如表1所示。

表1 订单主要参数

订单主要参数

  2、日期规范

  因为通常情况下,商户使用的订单系统主机时间会与支付网关主机时间有着一定的差异,再加之不同地区之间也会存在一定的时差,这就需要支付网关系统允许商户提交的订单日期与系统日期有 1 天的时差。当然,至于其他的商户清算以及统计数据日期等,就都需要与支付网关系统的日期保持一致,以避免出现贻误。

  3、交易应答接受规范

  具体的交易应答接受规范情况,应该包括有以下内容:当商户接收交易支付通知之后,需要验证数字签名信息,如果失败,则拒绝做出处理;针对后台返回方式而言,支付网关会定期重发五次交易应答信息给商户;针对页面返回方式而言,支付网关不会获取商户是否收到交易应答信息;

  支付网关交易应答通过页面和后台两种方式返回到商户那里,具体的应答数据都会通过表单的方式显示到商户页面当中;当商户接收订单应答之后,还需要进行签名验证,确保交易为合法交易。

  在后台返回过程当中,如果陆续接收了同一订单的多次交易应答,则需要严格遵循商户接收支付结果的处理规范来处理。具体的商户接收支付结果的处理规范情况可见表2所列。

表2 商户接收支付结果的处理规范

商户接收支付结果的处理规范

  4、支付接口设计

  为保障用户隐私权利,需要把用户浏览器转入银行支付网关的 Web 页面当中,如此才可以顺利完成交易。而在支付接口的设计上,则是采取的 web 方式,具体表单数据项说明如下:

  (1)商户提交到支付网关里面的表单

  表单里面应该包括的数据项可见表3所示。

表3 支付提交数据项

支付提交数据项

  表单说明:

  ①商家或企业在网页中的 Form 表单里根据规定格式来填写交易内容,然后通过 POST 方式将交易内容提交到 URL 那里;

  ②需要完成签名的数据串包括有版本号、商户号、订单号、交易日期、金额、交易类型、接收地址以及通知地址等。

  (2)支付网关返回到商户那里的表单

  支付网关返回到商户那里的表单数据项内容可见表4所示。

表4 支付结果返回表单数据项

支付结果返回表单数据项

  表单说明:

  ①支付结果需要通过 POST 的方式返回到商户的接受地址当中;

  ②需要签名的数据串包括有商户号、交易日期、订单号、金额、交易类型、实时状态以及交易流水号等。

  将上述数据使用标准 MD5 算法进行加密,加密结果全部转换成大写后即为校验码,把它和收到的 ChkValue 字段进行比较,相同的话即为交易结果数据验证成功。

关闭

1.点击下面按钮复制微信号

***********

2.打开微信→查找微信号

加为好友 开始支付接入