京东支付.docVIP

京东支付手机网页即时到账接口 版本 (V1.0.0) 网银在线（北京）科技有限公司  目录 1文档说明 3 1.1 功能描述 3 1.2 阅读对象 3 1.3 术语 3 2 京东支付流程 4 3 接口 4 3.1 支付请求接口参数 4 3.1.1 接口介绍 4 3.1.2 参数列表 5 3.1.3 参数特殊说明 5 3.1.4 敏感信息加密 6 3.1.5 样例 6 3.2 异步通知参数 7 3.2.1 说明 7 3.2.2 通知报文列表 7 3.2.3 通知报文特殊说明 8 3.2.4 样例 8 3.3 退款申请接口 9 3.3.1 说明 9 3.3.2 退款申请接口参数列表 10 3.3.3 退款申请返回参数列表 11 3.4 交易查询接口 12 3.4.1 说明 12 3.4.2 查询接口请求参数列表 12 3.4.3 查询接口返回参数列表 13 4 附录 14 4.1 交易返回状态编码表 14 4.2 交易返回信息编码表 14 4.3 交易类型编码表 16 4.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