智付3.0网银支付接口文档V3.0.5

网银网关支付接口规范

深圳市快汇宝信息技术有限公司

版权所有 侵权必究

网银网关支付接口规范 (1)

1. 概述 (3)

1.1. 目的 (3)

1.2. 术语与缩略语 (3)

1.3. 文档约束 (3)

1.4. 接口清单 (3)

1.5. 典型业务流程 (4)

1.6. 获取商户号和支付密钥 (4)

2. 接口定义 (5)

2.1. B2C支付交易接口 (5)

2.1.1. 描述 (5)

2.1.2. 接口参数定义 (5)

2.1.3. 错误码定义 (8)

2.2. B2B支付交易接口 (8)

2.2.1. 描述 (8)

2.2.2. 接口参数定义 (8)

2.2.3. 错误码定义 (10)

2.3. 支付结果通知接口 (10)

2.3.1. 描述 (10)

2.3.2. 接口参数定义 (11)

2.4. 单笔交易查询接口 (12)

2.4.1. 描述 (12)

2.4.2. 接口参数定义 (12)

2.4.3. 响应参数定义 (13)

2.5.附录 (16)

2.5.1. 网关地址 (16)

2.5.2. 签名规则定义 (16)

2.5.3. B2C银行代码对照表 (16)

2.5.4. B2B银行代码对照表 (17)

2.5.5. 错误码定义 (18)

2.5.6. 常见问题 (21)

1.概述

1.1.目的

本文档定义了如下接口：商户网站与智付支付平台间的B2C与B2B支付接口、商户网站与智付支付平台间的支付结果通知接口（包括：页面跳转同步通知接口、服务器异步通知接口）、商户网站与智付支付平台间的交易查询接口。

1.2.术语与缩略语

商户号：商户注册的智付平台的唯一标识账号。

商户密钥：商户与智付合作，商户可在商户后台（https://https://www.360docs.net/doc/f75228336.html,）自行设定的密串，初始值是空的，密钥由数字、字母和下划线组成，不少于20位，密钥是商家使用智付提供的加密控件对订单信息进行加密和签名、智付返回支付结果给商家的密文进行解密和验证签名的钥匙。

页面通知：页面跳转同步通知，智付获取数据处理完成之后，会在几秒之后（或者用户手动点击）从智付支付页面跳转至商户指定的页面，同时会携带处理完成之后的反馈信息，包含的信息和后台通知地址信息一致。比如：https://www.360docs.net/doc/f75228336.html,/demo_page.jsp

后台通知：服务器异步通知，智付获取数据处理完成之后，智付服务器会主动向商户网站指定的地址发送通知，携带处理完的订单信息，正确的做法是在这里进行网站订单的管理操作，包含的信息和页面通知信息一致。比如：https://www.360docs.net/doc/f75228336.html,/demo_notify.jsp

1.3.文档约束

1.4.接口清单

1.5.典型业务流程

1.6.获取商户号和支付密钥

步骤一、商户资质审核通过之后，开户成功，商户会收到智付支付平台下发的包括商户号、用户名和登录密码的邮件，登录智付支付平台https://https://www.360docs.net/doc/f75228336.html, 的商户登录首页，输入商家号、用户名和登录密码；

步骤二、登录商户后台，打开支付管理->支付设置，设置支付密钥，点击修改密钥，修改即可；

密钥格式：数字+字母+下划线20位以上，例如：123abc456efg789hmn_kdsc

2.接口定义

2.1.B2C支付交易接口

2.1.1.描述

定义商户网站与智付支付平台间的B2C支付交易接口，商户网站按照接口规范定义将交易订单数据提交到智付支付网关，以HTTPS POST方式提交数据。

2.1.2.接口参数定义

交易请求地址: https://https://www.360docs.net/doc/f75228336.html,/gateway?input_charset={参数编码字符集}

例如：https://https://www.360docs.net/doc/f75228336.html,/gateway?input_charset=UTF-8

input_charset与请求参数中的参数编码字符集相一致，仅限于UTF-8、GBK、GB2312。

2.1.

3.错误码定义

参见附录中的错误码定义

2.2.B2B支付交易接口

2.2.1.描述

定义商户网站与智付支付平台间的B2B支付交易接口，商户网站按照接口规范定义将交易订单数据提交到智付支付网关，以HTTPS POST方式提交数据。

2.2.2.接口参数定义

交易请求地址: https://https://www.360docs.net/doc/f75228336.html,/gateway?input_charset={参数编码字符集}

例如：https://https://www.360docs.net/doc/f75228336.html,/gateway?input_charset=UTF-8

input_charset与请求参数中的参数编码字符集相一致，仅限于UTF-8、GBK。

支付请求参数定义如下：

公用业务扩展参数定义如下（extend_param）：

2.2.

3.错误码定义

参见附录中的错误码定义

2.3.支付结果通知接口

2.3.1.描述

定义商户网站与智付支付平台间的支付结果通知接口，包括：页面跳转同步通知接口、服务器异步通知接口，用于消费者支付成功后，通过页面跳转方式和服务器异步通知方式通知商户网站该笔交易支付

成功，默认情况下只有支付成功才会通知。

当通知方式为服务器异步通知时，商户系统在收到后台通知并处理完成后必须打印输出SUCCESS，如果不是这7个字符，智付支付系统会在随后的一段时间内，以递增的时间间隔重发5次通知,时间间隔(5m/10m/20m/30m)。

2.3.2.接口参数定义

说明：当通知类型为offline_notify，商户系统接收到通知后必须返回处理结果SUCCESS，如果不是这7个字符，支付平台会重发5次通知，如果通知成功（即收到SUCCESS响应），通知ID参数失效，重发5次通知后，通知ID参数也会失效。

2.4.单笔交易查询接口

2.4.1.描述

定义商户网站与智付支付平台间的单笔交易查询接口。

2.4.2.接口参数定义

请求地址: https://https://www.360docs.net/doc/f75228336.html,/query

参数定义如下：

2.4.

3.响应参数定义以

当查询成功时，返回XML数据如下：

当查询失败时，返回XML数据如下：

2.5.附录

2.5.1.网关地址

如果未做特殊说明，智付支付网关统一地址为：https://https://www.360docs.net/doc/f75228336.html,/gateway，查询网关统一地址为：https://https://www.360docs.net/doc/f75228336.html,/query。

2.5.2.签名规则定义

签名规则定义如下：

参数列表中，除去sign_type、sign两个参数外，其它所有不为空的参数都要参与签名，值为空的参数不用参与签名；

签名顺序按照参数名a到z的顺序排序，若遇到相同首字母，则看第二个字母，以此类推，同时将商家支付密钥key放在最后参与签名，组成规则如下：

参数名1=参数值1&参数名2=参数值2&……&参数名n=参数值n&key={key值}

2.5.

3.B2C银行代码对照表

2.5.4.B2B银行代码对照表

2.5.5.错误码定义