PC支付-京东支付
专用API
【更新时间: 2024.01.30】
京东支付PC端收银台支持钱包余额、快捷支付、网关支付等多种支付渠道。支付流程全部在商户页面内完成，商户改动较小，同时又能轻松享受更全面、更安全的支付服务。
咨询
去服务商官网采购>
|
服务星级：5星
调用次数
0
次
集成人数
0
人
商用人数
0
人
SLA: N/A
响应: N/A
适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
|
- API详情
- 关于我们
- 相关推荐
什么是京东支付的PC支付?
产品介绍
京东支付PC端收银台支持钱包余额、快捷支付、网关支付等多种支付渠道。支付流程全部在商户页面内完成，商户改动较小，同时又能轻松享受更全面、更安全的支付服务。
产品特色
应用场景
适用于拥有自己平台网站的商户，且有线上支付的场景。
使用流程
准入条件
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接口文档
请点击下载：京东支付-V2.0.0
API接口Demo
API接口调用流程
1. 用户在商户系统中选择商品下单、并确认购买。支付环节选择京东支付。
2. 商户系统核对信息并组装参数，调用京东支付的支付请求接口。
3. 从商户系统页面跳转到京东支付页面，用户确认支付成功后页面跳转到商户的支付成功页。
4. 商户系统接收支付结果的异步通知并处理订单。
什么是京东支付的PC支付？
