iOS开发之网银在线支付快捷支付商户接口规范
iOS开发之网银在线支付快捷支付商户接口规范
IOS高级知识总结
&网银在线支付快捷支付商户接口规范
如果您在开发过程中遇到任何技术问题，可以咨询我们的技术支持人员：
联系邮箱：010-428630
(1)商户根据网银在线支付平台提供的接口规则，生成加密报文信息，将请求发送至网银在线快捷支付地址
(2)网银在线支付系统对请求数据进行处理，进行安全校验等验证，一系列验证通过后便会解密报文中的加密信息，处理这次发送过来的数据请求。
(4)返回处理的结果数据
&对于处理完成的交易会以两种方式把数据反馈给商户：
1)：前台通知： 交易结束后，网银在线实时发送给商户
2)：后台通知： 如果商户请求的数据中通知地址不为空，则服务器异步发起通知，按照商户在请求时上送的通知地址发送通知
(5)商户对获取的返回结果数据进行处理。
3　报文格式&& ·
在网银在线快捷支付的所有交易中，请求和响应报文格式均为XML格式。
使用快捷支付进行付款前，用户及银行卡信息须提交给银行进行验证，以保证信息的准确性。
签约完成后，即可进行快捷支付；每次支付前都必须进行签约。
Api访问地址
.cn/express.htm
3.3　响应机制
商户向API地址发送post请求，请求参数名称charset和req，charset是告诉快捷业务使用那种编码解码数据（具体查看字符编码表7.1），req是交易数据（具体数据格式看下文）。
商户发送交易数据至快捷业务，快捷业务处理请求，返回响应数据，resp=响应数据
有时可能由于商户网络原因没有接到同步响应结果，网银快捷支付、退款接口支持异步通知机制，异步通知机制推送3次响应数据，每次间隔为1分钟。
下文讲解如何发送和解析网银在线快捷支付数据。明文数据格式如：3.4请求/响应公共参数列表。注：各支付接口只有data不同；数据格式为XML形式。
由网银在线提供
由网银在线提供
持卡人数据和交易数据
按二级参数和三级参数组成XML格式数据，然后使用3DES加密。
MD5签名，签名数据为所有参数加签名密钥
格式如下：
请求/响应公共报文：
&?xml version=&1.0& encoding=&UTF-8&?&
&CHINABANK&
&VERSION&1.1.0&/VERSION&
&MERCHANT&&/MERCHANT&
&TERMINAL&&/TERMINAL&&& &DATA&N64mYYKJlowxXcDqdJsLqFz1EP1fxld0jgGVmKkabOFWxOlMNUXwApcJkn3j6NXMB7fOa1Q8TsVsWac5HuPDpbA0H23xFPJT3hEghwZoM9JIxoPVDbUeruH9bWu0s9V5wEbI77O42jv3dIs6yXc84SBRjzJoEawq7xQp7tli0P5tHkzfShJ+Y75zMj4mml4yNMTRJaFAYcGRpQ3LW7dZl36m9X2a/C8bAGZs/L3pi33tEc9/cFgpIt9cR8pLSAhxIvcUOv6ViCG1ShpeXZzovmxA/hloRGGXWXjbU+fbyjJ9aWlKkmUFg5b9pZ9xzOExUnRKrfHtzZg0xNEloUBhwamZp3eA1E5PRMLjn8LrEL5JjkGyCyoi9g4B3W73b37FU7NoYOKONaPNwyaxdcFZtKvgr1e65um6CYZ5jET5P7hDDKV3gXpJM9IHnY9A9rUBo0Kx+Q1Agn6dwx1UeI2wzX/D7mB+sUU/2LA/QTZzQUpnZYAoIUQ7LH/D7mB+sUU/gSyKNt+Ut/Fjp+aKsLzTlMndmxARgsrUf8PuYH6xRT/8E5iifJLJXwrawkW/KcRM9zgxMZgCdSV/w+5gfrFFP4Sj8WNP1q74Ejw0/MtF5MOELSmkHwKkxkyPimY9R8qSncMdVHiNsM154HXhN6O3fg==
&SIGN&9b54c90ecfb26fcde4198ec&/SIGN&
&/CHINABANK&
&DATA/&元素是交易过程中的主要数据需要用3DES加密，加密密钥需要在网银在线后台设置；
&SIGN/&元素是为了验证请求/响应的合法性，是&VERSION/&、&MERCHANT/&、&TERMINAL/&
&DATA/&元素一起用MD5加密之后的值，MD5加密密钥需要在网银在线后台设置；
发送请求时整个XML需要用BASE64编码之后发送
其中请求DATA元素格式如下
&?xml version=&1.0& encoding=&UTF-8&?&
&&& &CARD&
&&&&&&& &BANK&HXB&/BANK&
&&&&&&& &TYPE&D&/TYPE&
&&&&&&& &NO&3502&/NO&
&&&&&&& &EXP&&/EXP&
&&&&&&& &CVV2&&/CVV2&
&&&&&&& &NAME&测试三&/NAME&
&&&&&&& &IDTYPE&I&/IDTYPE&
&&&&&&& &IDNO&235731&/IDNO&
&&&&&&& &PHONE&&/PHONE&
&&& &/CARD&
&&& &TRADE&
&&&&&&& &TYPE&V&/TYPE&
&&&&&&& &ID&9&/ID&
&&&&&&& &AMOUNT&12345&/AMOUNT&
&&&&&&& &CURRENCY&CNY&/CURRENCY&
&&& &/TRADE&
响应DATA元素格式如下：
&?xml version=&1.0& encoding=&UTF-8&?&
&&& &TRADE&
&&&&&&& &TYPE&V&/TYPE&
&&&&&&& &ID&9&/ID&
&&&&&&& &AMOUNT&12345&/AMOUNT&
&&&&&&& &CURRENCY&CNY&/CURRENCY&
&&& &/TRADE&
&&& &RETURN&
&&&&&&& &CODE&0000&/CODE&
&&&&&&& &DESC&成功&/DESC&
&&& &/RETURN&
4　接入范例
网银在线提供快捷支付：快捷支付每次交易都要进行签约，每次签约时都需要输入验证码验证；
4.2　接入代码示例
1.XML中的&DATA/&元素用3DES加密.
2.&VERSION/&、&MERCHANT/&、&TERMINAL/&、&DATA/&(3DES加密之后)一起MD5加密形成签名&SIGN/&，签名用于校验请求的合法行.
3.整个XML最后用BASE64编码.
4.发送POST请求到网线在线快捷支付地址，参数为req（加密之后的XML）、charset为xml字符编码方式.
5.得到网银在线返回信息后，用同样的方法解析.
注：&DATA/&元素中的具体内容，需要根据具体的业务逻辑决定。
5　签约确认快捷支付
在进行支付前，收集持卡人的签约信息，提交至网银在线快捷支付地址，网银在线根据商户提供的持卡人的签约信息，完成签约的过程，每次交易之前都要进行签约。
5.2　签约请求DATA元素内容
交易请求接口DATA参数说明
持卡人支付卡号发卡行
持卡人支付卡号卡类型
信用卡：C / 借记卡：D
持卡人支付卡号
持卡人信用卡有效期
持卡人信用卡校验码
持卡人姓名
String/100
持卡人证件类型
持卡人证件号
持卡人手机号
数字或字母
人民币：CNY
5.3　签约响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
人民币：CNY
交易返回码
交易返回码信息
String/100
5.4　消费请求DATA元素内容
交易请求接口DATA参数说明
持卡人支付卡号发卡行
持卡人支付卡号卡类型
信用卡：C / 借记卡：D
持卡人支付卡号
持卡人信用卡有效期
持卡人信用卡校验码
持卡人姓名
String/100
持卡人证件类型
持卡人证件号
持卡人手机号
数字或字母
人民币：CNY
String/100
如果为空，交易结束后不主动向商户发送结果通知
String/100
交易验证码
由网银校验验证码时必填
5.5　消费响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
人民币：CNY
yyyyMMdd（订单支付完成日期）
HHmmss（订单支付完成时间）
String/100
交易返回状态
成功：0 / 处理中：6 / 失败：7
交易返回码
交易返回码信息
String/100
6　其他公共接口DATA元素内容
6.1　查询交易请求DATA元素内容
交易请求接口DATA参数说明
数字或字母
6.2　查询交易响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
人民币：CNY
yyyyMMdd（订单支付完成日期）
HHmmss（订单支付完成时间）
String/100
交易返回状态
成功：0 &退款：3& 失败：7
交易返回码
交易返回码信息
String/100
6.3　退款请求DATA元素内容
交易请求接口DATA参数说明
数字或字母
数字或字母
人民币：CNY
String/100
如果为空，交易结束后不主动向商户发送结果通知
String/100
6.4　退款响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
数字或字母
人民币：CNY
yyyyMMdd（退款请求发送日期）
HHmmss（退款请求发送时间）
String/100
交易返回状态
成功：0 / 退款：3 / 部分退款：4 / 处理中：6 / 失败：7
交易返回码
交易返回码信息
String/100
编码&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
数据库异常
报文解析异常
字符集不正确
版本号不正确
商户号不正确
终端号不正确
交易数据不正确
数据签名不正确
权限不正确
密钥不正确
发卡行不正确
卡类型不正确
交易卡号不正确
卡有效期不正确
卡安全码不正确
持卡人姓名不正确
持卡人证件类型不正确
持卡人证件号不正确
持卡人手机号不正确
交易类型不正确
交易号不正确
交易金额不正确
交易币种不正确
交易日期不正确
交易时间不正确
交易通知地址不正确
交易备注不正确
交易验证码不正确
交易卡号网银不受理
交易卡号商户不受理
交易受理银行繁忙
交易受理渠道繁忙
交易号重复
交易验证码申请不受理
交易验证码过期
交易不存在
原交易号不正确
原交易不允许此操作
原交易处理中
退款余额不足
查询银行列表错误
找不到相应的银行列表信息
卡号未签约
卡号未做签约申请
银行交易不支持
银行签约失败
银行解约失败
银行交易失败
银行签约姓名校验失败
银行签约手机号校验失败
银行签约证件号校验失败
银行签约卡有效期校验失败
银行签约卡安全码校验失败
银行不支持的卡类型
银行不支持的卡号
银行卡号状态异常
银行卡号未开通快捷业务
银行卡号余额不足
银行单笔金额超限
银行日交易金额超限
银行日交易次数超限
风险校验失败
我的热门文章
即使是一小步也想与你分享您所在位置： &
&nbsp&&nbsp&nbsp&&nbsp
“京东支付”手机网页即时到账接口文档.doc 20页
本文档一共被下载：
次 ,您可全文免费在线阅读后下载本文档。
下载提示
1.本站不保证该用户上传的文档完整性，不预览、不比对内容而直接下载产生的反悔问题本站不予受理。
2.该文档所得收入(下载+内容+预览三)归上传者、原创者。
3.登录后可充值，立即自动返金币，充值渠道很便利
需要金币：350 &&
你可能关注的文档：
··········
··········
京东支付手机网页即时到账接口版本(V1.0.0)网银在线（北京）科技有限公司目录1文档说明 31.1 功能描述 31.2 阅读对象 31.3 术语 32 京东支付流程 43 接口 43.1 支付请求接口参数 43.1.1 接口介绍 43.1.2 参数列表 53.1.3 参数特殊说明 53.1.4 敏感信息加密 63.1.5 样例 63.2 异步通知参数 73.2.1 说明 73.2.2 通知报文列表 73.2.3 通知报文特殊说明 83.2.4 样例 83.3 退款申请接口 93.3.1 说明 93.3.2 退款申请接口参数列表 103.3.3 退款申请返回参数列表 113.4 交易查询接口 123.4.1 说明 123.4.2 查询接口请求参数列表 123.4.3 查询接口返回参数列表 134 附录 144.1 交易返回状态编码表 144.2 交易返回信息编码表 144.3 交易类型编码表 164.4 京东支付退款/查询RSA公钥 161文档说明功能描述京东支付手机网页即时到帐接口为第三方手机网页应用提供发起支付请求,并引导用户完成支付过程。支付完成以后，通过同步、异步两种方式通知第三方网页应用服务器。它的优势是支付金额即时从消费者的银行账户扣除，用户支付过程简便、安全，界面新颖，再次支付更加便捷。同时，京东支付又提供了自动退款，以及交易结果查询接口。交易结果查询接口是为了防止商户长时间没有接收到同步、异步结果通知的情况而设计，在这种情况下，商户可以通过交易查询接口进行单笔或者批量查询交易结果，进而更新用户订单状态。阅读对象本文档面向商户系统设计人员、编程人员及测试人员。该人员需要具备一定的网站开发能力，了解ASP、PHP、JAVA、ASP.NET等开发语言中的一种及SQL数据库语言。术语名词 解释
商户 指已注册成为、并使用产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的企业或个人。
指在商户网站等系统购物的企业或个人。
通过HTTP/HTTPS协议把数据发送给接收方的过程。
通知 京东支付服务器异步通知。京东支付服务器根据接收到的数据处理完成后，会主动发起通知给商户的服务器，同时携带处理结果信息。
返回 页面跳转同步通知。京东支付服务器根据接收到的数据处理完成后，当前页面从京东支付的页面自动跳转回商户页面，同时携带处理结果信息。
支付失败 手机号被冻结、商户违约被冻结支付功能、余额不足、超额、订单已支付、订单金额和支付金额不一致等都会导致支付失败。
京东支付流程用户首先在商户系统的页面上选择商品并下单，点击支付按钮以后，商户系统向京东支付服务支付接口发起支付请求。商户要根据京东支付接口要求，通过程序得到签名结果以及要传给京东支付服务的订单信息以及商户信息数据集合。在支付请求的时候把数据集合发送到京东支付服务器。京东支付服务会首先验证商户的合法性，以及验证订单金额是否被篡改，如果商户非法，或者订单信息被篡改，京东支付服务会直接拒绝此支付请求；反之，则重定向到支付页面，引导用户填入支付的身份信息和银行卡信息，在用户确认之后，从用户的银行卡扣除相应的金额。如果支付完成以后，京东支付服务会跳转到商户支付请求的时候传入的url，并携带支付结果。并且，如果支付成功，京东支付服务后台会发送异步通知到商户传入的通知地址，把支付结果通知商户。接口支付请求接口参数接口介绍支付请求接口提供给商户向京东支付服务发送支付请求数据集合，京东支付服务会根据请求数据验证商户身份，以及验证支付信息是否被篡改。验证通过后，京东支付服务会把当前页面重定向到支付页面。如果验证未通过，京东支付服务会把当前页面重定向到商户系统传入的支付失败页面。调用地址：/wepay/web/pay编码格式:UTF-8调用方式：post数据格式：Form表单参数列表序号 参数名称 参数编码 必填 参数类型 描述
1 版本号 version 是 String 2.0（注：1.0版本不再支持）
2 用户交易令牌 token 否 String 识别用户信息,支付成功后会调用successCallbackUrl返回给商户。（注:商户可以记录这个token值，当用户再次支付的时候传该token，用户输入?，直接输入短息验证码进行支付。）
3 交易信息签名 merchantSign 是 String 用户交易信息签名后的值
4 商户号 merchantNum 是 String(50) 商户在网银登记的商户号
5 商户备注 merchantRemark 否 String(64) 商户备注信息
6 交易流水号 tradeNum 是 String(30) 商户提供的唯一交易流水号（字母和数字）
7 交易名称 tr
正在加载中，请稍后...IOS高级知识总结（102）
&网银在线支付快捷支付商户接口规范
如果您在开发过程中遇到任何技术问题，可以咨询我们的技术支持人员：
联系邮箱：010-428630
(1)商户根据网银在线支付平台提供的接口规则，生成加密报文信息，将请求发送至网银在线快捷支付地址
(2)网银在线支付系统对请求数据进行处理，进行安全校验等验证，一系列验证通过后便会解密报文中的加密信息，处理这次发送过来的数据请求。
(4)返回处理的结果数据
&对于处理完成的交易会以两种方式把数据反馈给商户：
1)：前台通知： 交易结束后，网银在线实时发送给商户
2)：后台通知： 如果商户请求的数据中通知地址不为空，则服务器异步发起通知，按照商户在请求时上送的通知地址发送通知
(5)商户对获取的返回结果数据进行处理。
3　报文格式&& ·
在网银在线快捷支付的所有交易中，请求和响应报文格式均为XML格式。
使用快捷支付进行付款前，用户及银行卡信息须提交给银行进行验证，以保证信息的准确性。
签约完成后，即可进行快捷支付；每次支付前都必须进行签约。
Api访问地址
.cn/express.htm
3.3　响应机制
商户向API地址发送post请求，请求参数名称charset和req，charset是告诉快捷业务使用那种编码解码数据（具体查看字符编码表7.1），req是交易数据（具体数据格式看下文）。
商户发送交易数据至快捷业务，快捷业务处理请求，返回响应数据，resp=响应数据
有时可能由于商户网络原因没有接到同步响应结果，网银快捷支付、退款接口支持异步通知机制，异步通知机制推送3次响应数据，每次间隔为1分钟。
下文讲解如何发送和解析网银在线快捷支付数据。明文数据格式如：3.4请求/响应公共参数列表。注：各支付接口只有data不同；数据格式为XML形式。
由网银在线提供
由网银在线提供
持卡人数据和交易数据
按二级参数和三级参数组成XML格式数据，然后使用3DES加密。
MD5签名，签名数据为所有参数加签名密钥
格式如下：
请求/响应公共报文：
&?xml version=&1.0& encoding=&UTF-8&?&
&CHINABANK&
&VERSION&1.1.0&/VERSION&
&MERCHANT&&/MERCHANT&
&TERMINAL&&/TERMINAL&&& &DATA&N64mYYKJlowxXcDqdJsLqFz1EP1fxld0jgGVmKkabOFWxOlMNUXwApcJkn3j6NXMB7fOa1Q8TsVsWac5HuPDpbA0H23xFPJT3hEghwZoM9JIxoPVDbUeruH9bWu0s9V5wEbI77O42jv3dIs6yXc84SBRjzJoEawq7xQp7tli0P5tHkzfShJ+Y75zMj4mml4yNMTRJaFAYcGRpQ3LW7dZl36m9X2a/C8bAGZs/L3pi33tEc9/cFgpIt9cR8pLSAhxIvcUOv6ViCG1ShpeXZzovmxA/hloRGGXWXjbU+fbyjJ9aWlKkmUFg5b9pZ9xzOExUnRKrfHtzZg0xNEloUBhwamZp3eA1E5PRMLjn8LrEL5JjkGyCyoi9g4B3W73b37FU7NoYOKONaPNwyaxdcFZtKvgr1e65um6CYZ5jET5P7hDDKV3gXpJM9IHnY9A9rUBo0Kx+Q1Agn6dwx1UeI2wzX/D7mB+sUU/2LA/QTZzQUpnZYAoIUQ7LH/D7mB+sUU/gSyKNt+Ut/Fjp+aKsLzTlMndmxARgsrUf8PuYH6xRT/8E5iifJLJXwrawkW/KcRM9zgxMZgCdSV/w+5gfrFFP4Sj8WNP1q74Ejw0/MtF5MOELSmkHwKkxkyPimY9R8qSncMdVHiNsM154HXhN6O3fg==
&SIGN&9b54c90ecfb26fcde4198ec&/SIGN&
&/CHINABANK&
&DATA/&元素是交易过程中的主要数据需要用3DES加密，加密密钥需要在网银在线后台设置；
&SIGN/&元素是为了验证请求/响应的合法性，是&VERSION/&、&MERCHANT/&、&TERMINAL/&
&DATA/&元素一起用MD5加密之后的值，MD5加密密钥需要在网银在线后台设置；
发送请求时整个XML需要用BASE64编码之后发送
其中请求DATA元素格式如下
&?xml version=&1.0& encoding=&UTF-8&?&
&&& &CARD&
&&&&&&& &BANK&HXB&/BANK&
&&&&&&& &TYPE&D&/TYPE&
&&&&&&& &NO&3502&/NO&
&&&&&&& &EXP&&/EXP&
&&&&&&& &CVV2&&/CVV2&
&&&&&&& &NAME&测试三&/NAME&
&&&&&&& &IDTYPE&I&/IDTYPE&
&&&&&&& &IDNO&235731&/IDNO&
&&&&&&& &PHONE&&/PHONE&
&&& &/CARD&
&&& &TRADE&
&&&&&&& &TYPE&V&/TYPE&
&&&&&&& &ID&9&/ID&
&&&&&&& &AMOUNT&12345&/AMOUNT&
&&&&&&& &CURRENCY&CNY&/CURRENCY&
&&& &/TRADE&
响应DATA元素格式如下：
&?xml version=&1.0& encoding=&UTF-8&?&
&&& &TRADE&
&&&&&&& &TYPE&V&/TYPE&
&&&&&&& &ID&9&/ID&
&&&&&&& &AMOUNT&12345&/AMOUNT&
&&&&&&& &CURRENCY&CNY&/CURRENCY&
&&& &/TRADE&
&&& &RETURN&
&&&&&&& &CODE&0000&/CODE&
&&&&&&& &DESC&成功&/DESC&
&&& &/RETURN&
4　接入范例
网银在线提供快捷支付：快捷支付每次交易都要进行签约，每次签约时都需要输入验证码验证；
4.2　接入代码示例
1.XML中的&DATA/&元素用3DES加密.
2.&VERSION/&、&MERCHANT/&、&TERMINAL/&、&DATA/&(3DES加密之后)一起MD5加密形成签名&SIGN/&，签名用于校验请求的合法行.
3.整个XML最后用BASE64编码.
4.发送POST请求到网线在线快捷支付地址，参数为req（加密之后的XML）、charset为xml字符编码方式.
5.得到网银在线返回信息后，用同样的方法解析.
注：&DATA/&元素中的具体内容，需要根据具体的业务逻辑决定。
5　签约确认快捷支付
在进行支付前，收集持卡人的签约信息，提交至网银在线快捷支付地址，网银在线根据商户提供的持卡人的签约信息，完成签约的过程，每次交易之前都要进行签约。
5.2　签约请求DATA元素内容
交易请求接口DATA参数说明
持卡人支付卡号发卡行
持卡人支付卡号卡类型
信用卡：C / 借记卡：D
持卡人支付卡号
持卡人信用卡有效期
持卡人信用卡校验码
持卡人姓名
String/100
持卡人证件类型
持卡人证件号
持卡人手机号
数字或字母
人民币：CNY
5.3　签约响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
人民币：CNY
交易返回码
交易返回码信息
String/100
5.4　消费请求DATA元素内容
交易请求接口DATA参数说明
持卡人支付卡号发卡行
持卡人支付卡号卡类型
信用卡：C / 借记卡：D
持卡人支付卡号
持卡人信用卡有效期
持卡人信用卡校验码
持卡人姓名
String/100
持卡人证件类型
持卡人证件号
持卡人手机号
数字或字母
人民币：CNY
String/100
如果为空，交易结束后不主动向商户发送结果通知
String/100
交易验证码
由网银校验验证码时必填
5.5　消费响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
人民币：CNY
yyyyMMdd（订单支付完成日期）
HHmmss（订单支付完成时间）
String/100
交易返回状态
成功：0 / 处理中：6 / 失败：7
交易返回码
交易返回码信息
String/100
6　其他公共接口DATA元素内容
6.1　查询交易请求DATA元素内容
交易请求接口DATA参数说明
数字或字母
6.2　查询交易响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
人民币：CNY
yyyyMMdd（订单支付完成日期）
HHmmss（订单支付完成时间）
String/100
交易返回状态
成功：0 &退款：3& 失败：7
交易返回码
交易返回码信息
String/100
6.3　退款请求DATA元素内容
交易请求接口DATA参数说明
数字或字母
数字或字母
人民币：CNY
String/100
如果为空，交易结束后不主动向商户发送结果通知
String/100
6.4　退款响应DATA元素内容
交易回复接口DATA参数说明
数字或字母
数字或字母
人民币：CNY
yyyyMMdd（退款请求发送日期）
HHmmss（退款请求发送时间）
String/100
交易返回状态
成功：0 / 退款：3 / 部分退款：4 / 处理中：6 / 失败：7
交易返回码
交易返回码信息
String/100
编码&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
数据库异常
报文解析异常
字符集不正确
版本号不正确
商户号不正确
终端号不正确
交易数据不正确
数据签名不正确
权限不正确
密钥不正确
发卡行不正确
卡类型不正确
交易卡号不正确
卡有效期不正确
卡安全码不正确
持卡人姓名不正确
持卡人证件类型不正确
持卡人证件号不正确
持卡人手机号不正确
交易类型不正确
交易号不正确
交易金额不正确
交易币种不正确
交易日期不正确
交易时间不正确
交易通知地址不正确
交易备注不正确
交易验证码不正确
交易卡号网银不受理
交易卡号商户不受理
交易受理银行繁忙
交易受理渠道繁忙
交易号重复
交易验证码申请不受理
交易验证码过期
交易不存在
原交易号不正确
原交易不允许此操作
原交易处理中
退款余额不足
查询银行列表错误
找不到相应的银行列表信息
卡号未签约
卡号未做签约申请
银行交易不支持
银行签约失败
银行解约失败
银行交易失败
银行签约姓名校验失败
银行签约手机号校验失败
银行签约证件号校验失败
银行签约卡有效期校验失败
银行签约卡安全码校验失败
银行不支持的卡类型
银行不支持的卡号
银行卡号状态异常
银行卡号未开通快捷业务
银行卡号余额不足
银行单笔金额超限
银行日交易金额超限
银行日交易次数超限
风险校验失败
参考知识库
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：284731次
积分：3911
积分：3911
排名：第6914名
原创：83篇
转载：134篇
评论：102条
(4)(2)(3)(6)(11)(4)(23)(14)(28)(26)(27)(12)(7)(14)(16)(18)(9)(3)(1)您所在位置： &
&nbsp&&nbsp&nbsp&&nbsp
“京东支付”手机网页即时到账接口文档总结.doc 20页
本文档一共被下载：
次 ,您可全文免费在线阅读后下载本文档。
下载提示
1.本站不保证该用户上传的文档完整性，不预览、不比对内容而直接下载产生的反悔问题本站不予受理。
2.该文档所得收入(下载+内容+预览三)归上传者、原创者。
3.登录后可充值，立即自动返金币，充值渠道很便利
需要金币：350 &&
你可能关注的文档：
··········
··········
京东支付手机网页即时到账接口版本(V1.0.0)网银在线（北京）科技有限公司目录1文档说明 31.1 功能描述 31.2 阅读对象 31.3 术语 32 京东支付流程 43 接口 43.1 支付请求接口参数 43.1.1 接口介绍 43.1.2 参数列表 53.1.3 参数特殊说明 53.1.4 敏感信息加密 63.1.5 样例 63.2 异步通知参数 73.2.1 说明 73.2.2 通知报文列表 73.2.3 通知报文特殊说明 83.2.4 样例 83.3 退款申请接口 93.3.1 说明 93.3.2 退款申请接口参数列表 103.3.3 退款申请返回参数列表 113.4 交易查询接口 123.4.1 说明 123.4.2 查询接口请求参数列表 123.4.3 查询接口返回参数列表 134 附录 144.1 交易返回状态编码表 144.2 交易返回信息编码表 144.3 交易类型编码表 164.4 京东支付退款/查询RSA公钥 161文档说明功能描述京东支付手机网页即时到帐接口为第三方手机网页应用提供发起支付请求,并引导用户完成支付过程。支付完成以后，通过同步、异步两种方式通知第三方网页应用服务器。它的优势是支付金额即时从消费者的银行账户扣除，用户支付过程简便、安全，界面新颖，再次支付更加便捷。同时，京东支付又提供了自动退款，以及交易结果查询接口。交易结果查询接口是为了防止商户长时间没有接收到同步、异步结果通知的情况而设计，在这种情况下，商户可以通过交易查询接口进行单笔或者批量查询交易结果，进而更新用户订单状态。阅读对象本文档面向商户系统设计人员、编程人员及测试人员。该人员需要具备一定的网站开发能力，了解ASP、PHP、JAVA、ASP.NET等开发语言中的一种及SQL数据库语言。术语名词 解释
商户 指已注册成为、并使用产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的企业或个人。
指在商户网站等系统购物的企业或个人。
通过HTTP/HTTPS协议把数据发送给接收方的过程。
通知 京东支付服务器异步通知。京东支付服务器根据接收到的数据处理完成后，会主动发起通知给商户的服务器，同时携带处理结果信息。
返回 页面跳转同步通知。京东支付服务器根据接收到的数据处理完成后，当前页面从京东支付的页面自动跳转回商户页面，同时携带处理结果信息。
支付失败 手机号被冻结、商户违约被冻结支付功能、余额不足、超额、订单已支付、订单金额和支付金额不一致等都会导致支付失败。
京东支付流程用户首先在商户系统的页面上选择商品并下单，点击支付按钮以后，商户系统向京东支付服务支付接口发起支付请求。商户要根据京东支付接口要求，通过程序得到签名结果以及要传给京东支付服务的订单信息以及商户信息数据集合。在支付请求的时候把数据集合发送到京东支付服务器。京东支付服务会首先验证商户的合法性，以及验证订单金额是否被篡改，如果商户非法，或者订单信息被篡改，京东支付服务会直接拒绝此支付请求；反之，则重定向到支付页面，引导用户填入支付的身份信息和银行卡信息，在用户确认之后，从用户的银行卡扣除相应的金额。如果支付完成以后，京东支付服务会跳转到商户支付请求的时候传入的url，并携带支付结果。并且，如果支付成功，京东支付服务后台会发送异步通知到商户传入的通知地址，把支付结果通知商户。接口支付请求接口参数接口介绍支付请求接口提供给商户向京东支付服务发送支付请求数据集合，京东支付服务会根据请求数据验证商户身份，以及验证支付信息是否被篡改。验证通过后，京东支付服务会把当前页面重定向到支付页面。如果验证未通过，京东支付服务会把当前页面重定向到商户系统传入的支付失败页面。调用地址：/wepay/web/pay编码格式:UTF-8调用方式：post数据格式：Form表单参数列表序号 参数名称 参数编码 必填 参数类型 描述
1 版本号 version 是 String 2.0（注：1.0版本不再支持）
2 用户交易令牌 token 否 String 识别用户信息,支付成功后会调用successCallbackUrl返回给商户。（注:商户可以记录这个token值，当用户再次支付的时候传该token，用户输入?，直接输入短息验证码进行支付。）
3 交易信息签名 merchantSign 是 String 用户交易信息签名后的值
4 商户号 merchantNum 是 String(50) 商户在网银登记的商户号
5 商户备注 merchantRemark 否 String(64) 商户备注信息
6 交易流水号 tradeNum 是 String(30) 商户提供的唯一交易流水号（字母和数字）
7 交易名称 tr
正在加载中，请稍后...