智付3.0网银支付接口文档

网银网关支付接口规范
深圳市快汇宝信息技术有限公司
版权所有侵权必究
网银网关支付接口规范 (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. 错误码定义 (7)
2.2. 支付结果通知接口 (7)
2.2.1. 描述 (7)
2.2.2. 接口参数定义 (7)
2.3. 单笔交易查询接口 (9)
2.3.1. 描述 (9)
2.3.2. 接口参数定义 (9)
2.3.3. 响应参数定义 (9)
2.4.附录 (11)
2.4.1. 网关地址 (11)
2.4.2. 签名规则定义 (11)
2.4.3. 银行代码对照表 (11)
2.4.4. 点卡直连代码对照表 (12)
2.4.5. 错误码定义 (12)
2.4.6. 常见问题 (15)
1.概述
1.1.目的
本文档定义了如下接口：商户网站与智付支付平台间的B2C支付接口、商户网站与智付支付平台间的支付结果通知接口（包括：页面跳转同步通知接口、服务器后台异步通知接口）、商户网站与智付支付平台间的单笔交易查询接口。

1.2.术语与缩略语
商户号：商户在智付平台注册的唯一标识账号。

商户密钥：商户与智付合作，商户可在商户后台（https://）自行设定的密钥，初始值为空。

密钥由数字、字母和下划线组成，不少于20位字符。

密钥是商家使用智付提供的加密控件对订单信息进行加密和签名、智付返回支付结果给商家的密文进行解密和验证签名的钥匙。

网银直连：用户在使用网银直连时，根据商户提交的银行代码直接跳转到对应的银行页面，省去了中间跳到第三方支付收银台选择银行这一步。

页面通知：智付获取数据处理完成之后，会在几秒之后（或者用户手动点击）从智付支付页面跳转至商户指定的页面，同时会携带处理完成之后的反馈信息，包含的信息和后台通知地址信息一致。

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

例如：/Notify_Url.jsp
1.3.适用范围
本文档适用的支付类型包括：个人网银支付、点卡支付、快捷支付、智汇宝支付、代金券支付。

1.4.接口清单
1.5.典型业务流程
1.6.获取商户号和支付密钥
步骤一、商户资质审核通过之后，开户成功。

商户会收到智付支付平台下发的包括商户号、用户名和登录密码的邮件，登录智付支付平台https://的商户登录首页，输入商家号、用户名和登录密码；
步骤二、登录商户后台，打开支付管理->支付设置，设置支付密钥，点击修改密钥，初始值为空。

密钥格式：数字+字母+下划线20位以上，例如：123456789_abcdefgABC
2.接口定义
2.1.B2C支付交易接口
2.1.1.描述
定义商户网站与智付支付平台间的B2C支付交易接口，商户网站按照接口规范定义将交易订单数据提交到智付支付网关，以HTTPS POST方式提交数据。

2.1.2.接口参数定义
交易请求地址: https:///gateway?input_charset=参数编码字符集
例如：https:///gateway?input_charset=UTF-8
input_charset与请求参数中的参数编码字符集相一致，仅限于UTF-8和GBK两种
支付请求参数定义如下：
2.1.
3.错误码定义
详见附录中的错误码定义。

2.2.支付结果通知接口
2.2.1.描述
定义商户网站与智付支付平台间的支付结果通知接口，包括：页面跳转同步通知接口、服务器后台异步通知接口，用于消费者支付成功后，通过页面跳转方式和服务器后台通知方式通知商户网站该笔交易支付结果，默认情况下只有支付成功才会通知。

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

注：若商家后台未配置“页面通知地址”和“后台通知地址”，则以代码中提交的地址为准。

反之，以商家后台填写的地址为准。

商家后台配置通知地址的示例如下：（商家后台：支付管理—>支付设置）
2.2.2.接口参数定义
说明：当通知类型为offline_notify，商户系统在接收到通知后必须返回包含“SUCCESS”的字符串，如果没有返回或返回的处理结果未包含该字符串，支付平台随后会重发5次通知。

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

2.3.2.接口参数定义
请求地址: https:///query
2.3.3.响应参数定义
查询成功时返回的XML数据示例：
查询失败时返回的XML数据示例：
2.4.附录
2.4.1.网关地址
如果未做特殊说明，智付支付网关统一地址为：https:///gateway，查询网关统一地址为：https:///query。

2.4.2.签名规则定义
签名规则定义如下：
（1）参数列表中，除去sign_type、sign两个参数外，其它所有非空的参数都要参与签名，值为空的参数不用参与签名；
（2）签名顺序按照参数名a到z的顺序排序，若遇到相同首字母，则看第二个字母，以此类推，同时将商家支付密钥key放在最后参与签名，组成规则如下：
参数名1=参数值1&参数名2=参数值2&……&参数名n=参数值n & key=key值
2.4.
3.银行代码对照表
代码对照表仅供参考，实际支持的银行个数以支付网关页面中显示的为准。

获取准确的银行代码方法是：在支付网关选择银行的页面，将鼠标悬停在银行图标上面即可看到对应的银行代码提示。

B2C
2.4.4.点卡直连代码对照表
代码对照表仅供参考，实际支持的点卡个数以支付网关页面中显示的为准。

获取准确的点卡代码方法是：在支付网关选择点卡的页面，将鼠标悬停在点卡图标上面即可看到对应的点卡代码提示。

点卡代码对照表如下：
2.4.5.错误码定义
2.4.6.常见问题
2.4.6.1.商户如何返回SUCCESS
为了保证商户能及时接收到反馈数据，商户在处理完业务后，需要打印SUCCESS，只需后台接收地址中打印，页面接收地址不用打印。

[1]JSP打印方法：PrintWriter pw = resp.getWriter();
pw.print("SUCCESS");
[2]PHP打印方法：echo “SUCCESS”;
[3]ASP打印方法：Response.Write "SUCCESS"
注：后台接收地址需包含字符串“SUCCESS”，不允许跳转或者重定向操作。

2.4.6.2.时间格式不正确
时间格式必须是yyyy-MM-dd HH:mm:ss，例如：2014-01-01 12:13:23
PHP时间格式：
Echo date ("Y-m-d H:i:s" , mktime(gmdate('H')+8,gmdate('i'),gmdate('s'),gmdate('m'),gmdate('d'),gmdate('Y')));
ASP时间格式：
tempdate = year(Now()) & "-" & right("0"&month(Now()),2) & "-" & right("0"&day(Now()),2) & " " & right("0"&hour(Now()),2)& ":" & right("0"&minute(Now()),2)& ":" & right("0"&second(Now()),2)。