支付能力

产品简介

京东小程序平台提供京东支付能力，帮助开发者实现交易闭环，在小程序内用户可以选择商品下单并购买，唤起京东支付组件，用户确认收款方和金额后选择支付方式，支付方式支持打白条、银行卡、小金库、钱包余额、钢镚。

支付能力 - 图1

开放标准

  1. 对所有入驻小程序的企业开放；
  2. 需要开通京东金融企业商户号和京东支付服务。

接入流程

  1. 开通京东金融企业商户号与京东支付服务，京东金融企业版；
  2. 调用下单接口获得京东交易单号京东支付统一下单接口；
  3. 调用jd.requestPayment，唤起京东支付组件；
  4. 用户完成支付。

接口说明

jd.requestPayment(OBJECT)

OBJECT 参数说明：

参数类型必填说明
timeStampString否时间戳从 1970 年 1 月 1 日 00:00:00 至今的秒数,即当前的时间
nonceStrString否随机字符串，长度为 32 个字符以下
packageString是交易订单号（oderId），调用收单产生
signTypeString否签名算法，签名算法（默认MD5，可选MD5、HMAC-SHA256）
paySignString是校验签名,具体签名方案参见小程序支付接口文档
merchantString是商户号（商户号需要确认是否已开通京东支付功能）
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

paySign 交易签名规则：将获取到的merchant、orderId、md5key按照顺序拼接成字符串，进行md5签名并转小写后生成paySign签名值；例如，merchant=a，oderId=b，md5key=c，merchant=a&orderId=b&key=c，md5后得到paySign=fb489e17ac39b44a1df66f5bb7a2218f

了解更多信息，请查看京东支付接口文档

回调结果：

回调类型errMsg说明
success回调中data.payStatus查看支付结果
failrequestPayment:fail cancel用户取消支付
failrequestPayment:fail (detail message)调用支付失败，其中 detail message 为后台返回的详细失败原因

success 回调中 data.payStatus 有以下返回值：

名称说明
JDP_PAY_SUCCESS用户支付成功
JDP_PAY_CANCEL用户主动取消
JDP_PAY_FAIL用户调起收银台失败
JDP_PAY_PARTIAL_SUCCESS组合支付部分成功

调用示例代码：

  1. jd.requestPayment({
  2.    'timeStamp': '',
  3.    'nonceStr': '',
  4.    'package': '',
  5.    'signType': 'MD5',
  6.    'paySign': '',
  7.    'success':function(res){
  8.       console.log(res.data.payStatus);
  9.    },
  10.    'fail':function(res){
  11.    }
  12. })

常见问题

Q：京东支付手续费是什么时候扣除？退款是否将手续费退给商家侧？

A：结算时扣除手续费；如果用户退款完成，手续费不退还。

Q：资金是实时到账吗？

A：信息流实时返回，资金流T+1结算，京东金融商户平台查询金额延迟2小时。

Q：RSA秘钥出现空格是什么原因？

A：查询出现的空格请忽略，注意在java语言代码中， pkcs8私钥文件的内容中，要去掉空格。