网银网关支付接口规范
深圳市快汇宝信息技术有限公司
版权所有侵权必究
网银网关支付接口规范 (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.术语与缩略语
商户号:商户在智付平台注册的唯一标识账号。
商户密钥:商户与智付合作,商户可在商户后台(merchants.dinpay)自行设定的密钥,初始值为空。密钥由数字、字母和下划线组成,不少于20位字符。密钥是商家使用智付提供的加密控件对订单信息进行加密和签名、智付返回支付结果给商家的密文进行解密和验证签名的钥匙。
网银直连:用户在使用网银直连时,根据商户提交的银行代码直接跳转到对应的银行页面,省去了中间跳到第三方支付收银台选择银行这一步。
页面通知:智付获取数据处理完成之后,会在几秒之后(或者用户手动点击)从智付支付页面跳转至商户指定的页面,同时会携带处理完成之后的反馈信息,包含的信息和后台通知地址信息一致。例如:www.dinpay/Return_Url.jsp
后台通知:服务器异步通知,智付获取数据处理完成之后,智付服务器会主动向商户网站指定的地址发送通知,携带处理完的订单信息,正确的做法是在这里进行网站订单的管理操作,包含的信息和页面通知信息一致。例如:www.dinpay/Notify_Url.jsp
1.3.适用范围
本文档适用的支付类型包括:个人网银支付、点卡支付、快捷支付、智汇宝支付、代金券支付。
1.4.接口清单
1.5.典型业务流程
1.6.获取商户号和支付密钥
步骤一、商户资质审核通过之后,开户成功。商户会收到智付支付平台下发的包括商户号、用户名和登录密码的邮件,登录智付支付平台merchants.dinpay的商户登录首页,输入商家号、用户名和登录密码;
步骤二、登录商户后台,打开支付管理->支付设置,设置支付密钥,点击修改密钥,初始值为空。
密钥格式:数字+字母+下划线20位以上,例如:123456789_abcdefgABC
2.接口定义
2.1.B2C支付交易接口
2.1.1.描述
定义商户网站与智付支付平台间的B2C支付交易接口,商户网站按照接口规范定义将交易订单数据提交到智付支付网关,以HTTPS POST方式提交数据。
2.1.2.接口参数定义
jsp帮助文档交易请求地址: pay.dinpay/gateway?input_charset=参数编码字符集
例如:pay.dinpay/gateway?input_charset=UTF-8
input_charset与请求参数中的参数编码字符集相一致,仅限于UTF-8和GBK两种
支付请求参数定义如下:
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论