2.2-直付正向下单
提供方:合作方
接口描述:京东侧选择直付卡支付购买商品,向合作方进行下单操作,合作方需要通过该接口进行下单扣费等操作,返回正确结果后京东侧真实给用户下单购买商品
特别注意:
1.如果入参的直付金额estimatedAmount不能满足时,请抛异常码阻断,不要部分扣款!!!
2.返回参数的直付金额partnerAmount代表实际扣款金额,必须和入参保持一致,不一致时,京东认为扣款失败,且不会触发退款!!!
3.积分场景同上
入参参数:
参数名 | 类型 | 描述 |
---|---|---|
jdhRecordId | String | JDH直付订单记录ID |
jdhUserId | String | 京东用户唯一标识(加密) |
cardNo | String | 合作方卡号 |
voucher | String | 凭证信息(支付密码)(加密)(免密/短信验证码/外部收银台模式则下单无该字段) |
estimatedAmount | Integer | 预计直付扣款金额(单位分) |
estimatedAmountPoints | Integer | 预计直付扣款积分(单位分) |
catalogueDiscountAmount | Integer | 目录商品优惠后总金额(单位分) |
catalogueDiscountAmountPoints | Integer | 目录商品优惠后总积分(单位分) |
allDiscountAmount | Integer | 全部商品优惠后总金额(单位分) |
allDiscountAmountPoints | Integer | 全部商品优惠后总积分(单位分) |
partnerUserId | String | 合作方用户唯一标识 |
province | String | 省(例如:北京) |
city | String | 市(例如:北京市) |
county | String | 区县(例如:大兴区) |
address | String | 收货地址信息 |
skuList | List | 直付sku集合 |
policyNo | String | 保单号 |
insuredPersonCardNo | String | 被保人证件号(密文加密) |
extParam | Map<String,Object> | 扩展参数 |
扩展参数 extParam:
参数名 | 类型 | 描述 |
---|---|---|
thirdRxIdList | List<String> | 三方处方Id列表 |
直付sku集合 List:
参数名 | 类型 | 描述 |
---|---|---|
buyNum | Integer | 数量 |
catalogueTag | Integer | 是否理赔目录标识,1是,0否 |
categoryLevel3Id | String | SKU三级分类ID |
categoryLevel2Id | String | SKU二级分类ID |
categoryLevel1Id | String | SKU一级分类ID |
discountAmount | Integer | 优惠后总价(单位分) |
discountAmountPoints | Integer | 优惠后积分总价(单位分) |
discountPrice | Integer | 优惠后单价(单位分)≈ 优惠后总价➗数量 (注意:若优惠后总价无法除尽,则不保留小数点) |
discountPricePoints | Integer | 优惠后积分单价(单位分) |
skuId | String | SKUID |
skuName | String | SKU名称 |
spec | String | 规格 |
thumbnailUrl | String | 商品缩略图 |
unit | String | 单位 |
skuDiscount | Integer | sku优惠金额 = sku优惠前总价-优惠后总价 (单位分) |
skuDiscountPoints | Integer | sku优惠积分 |
skuAmountBeforeDiscount | Integer | sku优惠前总价(单位分) |
skuAmountBeforeDiscountPoints | Integer | sku优惠前积分总价(单位分) |
skuPriceBeforeDiscount | Integer | sku优惠前单价 = sku优惠前总价➗数量 (单位分) |
skuPriceBeforeDiscountPoints | Integer | sku优惠前积分单价 |
出参参数:返回参数名response,当包含不可直付的sku集合时,excludeSkuList返回具体sku的集合
参数名 | 类型 | 描述 |
---|---|---|
code | String | 0000 代表调用成功 |
uuid | String | 日志查询用 |
data | Map | 直付提单结果 |
errMsg | String | 错误描述 |
直付提单结果(data) :
参数名 | 类型 | 描述 |
---|---|---|
partnerAmount | Integer | 直付金额(单位分) |
partnerAmountPoints | Integer | 直付积分(单位分) |
excludeSkuList | List | 不支持直付的sku集合 |
partnerOrderId | String | 合作方订单id |
不支持直付的sku集合(excludeSkuList):
参数名 | 类型 | 描述 |
---|---|---|
skuId | String | 不支持的skuId |
code | String | 错误码 |
入参示例
接口参数基础对接详见 2-服务端接口对接说明
{ "address": "京东总部2号楼C北12层", "city": "北京市", "county":"大兴区", "province": "北京", "allDiscountAmount": 11144, "cardNo": "99011630023332", "catalogueDiscountAmount": 11144, "estimatedAmount": 11144, "jdhRecordId": "2244677237490095106", "jdhUserId": "jd_7fc22bc4bd5c6", "partnerUserId": "99011630023332", "skuList": [ { "buyNum": 4, "categoryLevel3": "1", "skuDiscount": 0, "discountPrice": 2786, "skuAmountBeforeDiscount": 11144, "discountAmount": 11144, "spec": "1盒", "skuName": "益泰 胃管固定鼻贴 导管固定贴鼻饲管鼻贴医用鼻梁贴胃管胶带鼻饲胶布 L型鼻贴10片+酒精棉片10片", "unit": "盒", "catalogueTag": 1, "skuPriceBeforeDiscount": 2786, "skuId": "100024447229", "thumbnailUrl": "https://m.360buyimg.com/babel/jfs/t1/217565/39/18657/365708/627ce13fE382a5c33/498f3ab6197d035c.jpg" } ], "voucher": "543532"}
出参示例:
{"response":{"code":"0000","errMsg":"","uuid":"1ded1b62-c60f-4e4f-9620-a78a16b8f284","data":{"jdhCardId":"1","partnerOrderId":"1","partnerAmount":100}}}