产品介绍

H5支付是适用于商户H5在线支付集成京东支付H5端收银台的功能，同时支持钱包余额、快捷支付、网关支付等多种支付渠道。支付流程全部在商户页面内完成，商户改动较小，同时又能轻松享受更全面、更安全的支付服务。采用T+1定期结算方式，财务记录独立、账务清晰，满足用户多种的对账需求。

产品特色

应用场景

适用于一切可线上支付的场景。

使用流程

准入条件

1.  申请前必须拥有经过实名认证的京东金融企业版账户；

2.  企业可申请；

3.  需提供真实有效的五证或三证；

4.  网站/APP/公众号能正常访问且页面显示完整，需要明确经营内容且有完整的商品信息；APP应用要求已上架，并需提供应用名称和下载链接；

5.  网站/APP/公众号必须通过ICP备案。备案主体需要与签约主体名称一致；若不一致请提供授权书；

6.  凡涉政治类、军警器材治安类、黄赌毒及相关、非法医疗器械类、国家保护动植物类、电信欺诈非法服务类、违法违规虚拟货币类、假冒伪劣产品类等不予合作；

计费模式和规则

单笔计费0.5%，详询请联系网银在线请 400-0988-500 或jdpay-bd@jd.com

接入步骤

联系销售团队：拨打 400-0988-500 或 发邮件到jdpay-bd@jd.com，会有专业人员为您服务；

签署协议：按照要求提交商户资料，并签订协议；

研发联调：前述流程无误后，会安排专业研发团队配合商户接入；

上线使用：联调测试无误后，即可上线使用。

常见问题

Q：userId是什么？
A：userId为商户平台的用户userId（相当于token，用于唯一标示用户），需通过接口参数传给京东。首次支付成功后userId会和用户登陆的手机号做绑定，下次用户再发起支付时，无需再次登录即可完成支付。

Q：appId是什么？
A：appid是京东支付应用的唯一标识，京东支付会自动分配对应的appid，用于标识该应用。登录 https://www.jdpay.com, 商户后台-->商户中心-->商户服务-->我的应用。

Q：怎么获取正确的正式商户号，使用到程序中？
A:程序中使用的是12位的商户账户号，也就是二级商户号。登录 https://www.jdpay.com商户后台-->商户中心-->资金账户-->12位账户代码（按账户名称对应）。

Q：正式商户号秘钥去哪里设置？
A：登录 https://www.jdpay.com商户后台-->商户中心-->支付产品-->签约管理-->京东支付秘钥-->点击创建/查询秘钥，设置md5、des、rsa公钥。

Q：京东支付付款码轮训扣款顺序是什么？
A：京东支付支持轮训扣款方式，支付多种支付方式包括：银行卡、小金库、余额、白条（后续会支持钢镚，小白卡等）。默认的轮训扣款方式为：银行卡 > 余额 > 小金库 > 白条。

Q：异步通知的通知机制是什么？
A：当订单支付成功之后，京东服务器调用参数notifyUrl（异步通知地址一定是外网能够访问的地址）中的地址，post订单详细参数给商户，商户接受到参数后对订单进行处理。
为防止掉单，异步通知提供了通知机制。商户接受到异步通知后，返回字符串“ok”或者“success”给京东。 3. 如异步通知服务器未收到商户接受成功标志。会重复发送异步通知，最多发送5次，时间点分别为支付完成后、支付完成后1分钟、支付完成后3分钟、支付完成后10分钟、支付完成后120分钟。

Q：支付请求和异步返回的加密规则是什么？
A：支付请求用pkcs8的RSA私钥进行签名，des加密； 同步返回使用京东支付统一对外rsa公钥验签； 异步返回用3DES解密，京东支付统一对外rsa公钥验签。

Q：短信验证码有效时长为多少，当首次输入错误后是否允许再次使用该验证码？
A：短信验证码有效时长为5分钟。首次输入验证码错误，允许再次使用正确验证码。

Q：退款申请提交时，提示“RFND100008：可用余额不足”是什么意思？
A：当时商户账户收单进来的资金不足够退款，退款默认扣除的是商户后台“不可用余额”中的资金。不可用余额即为收单未结算金额。该错误码为终态，如需重新发起退款申请，请先确认“不可用余额”中资金是否充足，然后再更换订单号重新请求。

Q:  商户提交参数中已传USERID，第二次支付时仍然需要用户用手机号登录。

A:   检查提交数据要采用post提交，不要用HttpClient来提交。

Q:  PHP语言接受异步通知内容为空。

A：改为全局接受，$GLOBALS['HTTP_RAW_POST_DATA']。

Q:  PHP语言因版本问题报错，报错信息为Fatal error:Connot use object of type DOMNodeList as array in /var/www/html/…. /XMLUtil.php

A:  因php版本问题，可将原demo代码改为以下截图形式后即可解决问题。

Q:  异步通知解密失败，报错信息： data decrypt failed

A:  des秘钥使用错误，请核实des秘钥后重试。

Q:  异步通知验签失败，报错信息：验证商户签名失败Decryption error

A:  京东统一对外rsa公钥不正确会导致这个错误。京东统一对外rsa公钥：MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCKE5N2xm3NIrXON8Zj19GNtLZ8xwEQ6uDIyrS3S03UhgBJMkGl4msfq4Xuxv6XUAN7oU1XhV3/xtabr9rXto4Ke

3d6WwNbxwXnK5LSgsQc1BhT5NcXHXpGBdt7P8NMez5qGieOKqHGvT0qvjyYnYA29a8Z4wzNR7vAVHp36uD5RwIDAQAB。

Q:  支付申请提交时，提示CASH000004：支付验签失败，请核对签名后重新支付。

A:  签名信息sign不正确，请参照京东支付接口文档4.1签名算法。

Q:  支付申请提交时，提示CASH000005：支付金额有误，请核对金额后重新支付。

A:  amount参数以分为单位，必须为整数。请核实后重新支付。

Q:  支付申请提交时，提示CASH000006：支付解密异常，请核对加密参数后重新支付。

A：des解密失败，检查提交参数并核实des秘钥是否正确（登录https://biz.jdpay.com商户后台-->安全中心-->秘钥设置-->京东支付秘钥）。

Q:  支付申请提交时，提示CASH000007：系统校验支付签名异常，请核对签名后重新支付。

A:   rsa验签失败，检查签名信息并核实rsa秘钥是否正确（登录https://biz.jdpay.com商户后台-->安全中心-->秘钥设置-->京东支付秘钥）。

Q:  支付申请提交时，提示CASH000014：支付提交参数异常，请核对后重新支付。

A:  参照接口说明文档检查提交参数 1. 必填项必须提交，并且不能为空 2. 金额是以分为单位 3. 检查日期格式是否正确。

Q:  支付申请提交时，提示CASH000018：商户信息不存在，请核对后重新支付。

A:  merchant参数值为12位商户账户代码（登录https://biz.jdpay.com商户后台--》资金管理--》账户查询--》账户余额--》账户代码（按账户名称对应）)。

Q:  支付申请提交时，提示CASH000019：商户加密秘钥不存在，请核对后重新支付。

A:  des秘钥不正确，检查des秘钥是否设置（登录https://biz.jdpay.com商户后台-->安全中心-->秘钥设置-->京东支付秘钥）。

Q:  支付申请提交时，提示CASH000022：商户限制身份信息为空，请核对后重新支付。

A:  指定实名时，specId和specName必须同时传并且specCardNo为空。请检查参数后重新支付。

Q:  支付申请提交时，提示CASH000023：商户限制卡号为空，请核对后重新支付。

A: 指定银行卡号，specCardNo不能为空。请检查参数后重新支付。

Q:  支付申请提交时，提示CASH000024：商户号为空，请核对后重新支付。

A:  商户号merchant不能为空，请核实后重新支付。

Q:  退款申请提交时，提示RFND009000： 参数错误.

A:  参数信息有误，根据描述信息判断具体哪个参数有误。

Q:  退款申请提交时，提示RFND000003：原交易流水号不存在。

A:  退款原支付订单不存在，请核实交易号oTradeNum。

Q:   退款申请提交时，提示RFND100002：退款金额超出可退额度

A:退款金额超过可退款金额，请核实原订单金额和已退款金额。

Q: 退款申请提交时，提示RFND100003：原交易的状态不能退款

A:请核实原支付订单状态，是否为支付成功。

Q: 退款申请提交时，提示RFND100004：与已存在的相同的商户订单号的退款的金额不一致.

A:于已提交的订单金额不一致，修改金额或者更换订单号。

API接口调用流程

1.  用户在商户系统中选择商品下单、并确认购买。支付环节选择京东支付。

2.  商户系统核对信息并组装参数，调用京东支付的支付请求接口。

3.  从商户系统页面跳转到京东支付页面，用户确认支付成功后页面跳转到商户的支付成功页。

4.  商户系统接收支付结果的异步通知并处理订单。

API接口文档

请点击下载：京东支付-V2.0.0

接口调试请查看：在线调试

API接口Demo

点击下载接口demo