alibaba.nlife.b2c.trade.pay (零售+平台支付订单)

零售+平台支付接口,外部商户调用此接口告知零售+支付结果,保持订单状态同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trade_no String 可选 10000400000000045678
  • 最大长度:64
  • 零售+平台订单号,和out_trade_no不能同时为空
    fund_bill_list FundBill [] 可选
  • 最大列表长度:100
  • 支付资金各渠道列表
    • └ id
    • String
    • 可选
    • 2017022837483658463
    • 1. type=CASH:为空; 2. type=UNIONPAY:银联流水号; 3. type=ALIPAY:支付宝订单号; 4. type=WECHAT_PAY:微信支付订单号; 5. type=PROMOTION:零售+平台中的优惠id。6. type=CUSTOM_PROMOTION:7. type=CUSTOM_PREPAY_CARD;8. type=OFFLINE_PREPAY_CARD; 9. type=MOLING;10. type=POINTS:为空
    • └ type
    • String
    • 必须
    • ALIPAY
    • 1. CASH:现金支付; 2. UNIONPAY:银联刷卡支付; 3. ALIPAY:支付宝支付; 4. WECHAT_PAY:微信支付; 5. PROMOTION: 零售+平台的优惠; 6. CUSTOM_PROMOTION:零售商自有优惠; 7. CUSTOM_PREPAY_CARD:ISV储值卡;8. OFFLINE_PREPAY_CARD: 线下储值卡(无ISV交互逻辑) 9. MOLING:支付时抹零;10. POINTS:积分抵扣
    • └ buyer_id
    • String
    • 可选
    • 294344535
    • 买家id
    • └ buyer_id_type
    • String
    • 可选
    • ALIPAY_OPENID
    • TAOBAO_OPENID 经阿里百川淘宝登录获取到的用户id; ALIPAY_OPENID 经蚂蚁金服开放平台支付宝App登录获取到的用户id ;WECHAT_OPENID 经微信开放平台微信App登录获取到的用户id ;PHONE_NUMBER 通过手机号登录 APP_USERID 商户自有的用户id; ANONYMOUS_USER 匿名用户
    • └ title
    • String
    • 必须
    • 支付宝支付
    • 资金渠道的名称。 1. type=CASH:现金支付; 2. type=UNIONPAY:银联刷卡支付; 3. type=ALIPAY:支付宝支付; 4. type=WECHAT_PAY:微信支付; 5. type=PROMOTION: 零售+平台的优惠名称; 6. type=CUSTOM_PROMOTION:零售商自有优惠名称; 7. type=CUSTOM_PREPAY_CARD:ISV储值卡;8. type=OFFLINE_PREPAY_CARD:线下储值卡; 9. type=MOLING:抹零;10. type=POINTS:积分抵扣
    • └ amount
    • Number
    • 必须
    • 180
    • 金额; 单位:分
    • └ currency
    • String
    • 必须
    • CNY
    • 货币类型
    • └ extend_params
    • String
    • 可选
    • {"k1":v1;"k2":v2}
    • 业务扩展参数,json格式
    • └ attachment
    • String
    • 可选
    • gender:female
    • 附加数据,在查询订单中原样返回
    picking_up String 必须 SELF_DELIVERY 提货方式: LOGISTICS("物流发货"), SELF_DELIVERY("门店自提");
    consignee String 可选 孙悟空
  • 最大长度:64
  • 收货人
    consignee_phone_num String 可选 0571-85022088
  • 最大长度:32
  • 收货人电话
    consignee_address String 可选 阿里巴巴西溪园区
  • 最大长度:256
  • 收货人地址
    gmt_payment Date 必须 2017-01-20 13:00:00 ISV处支付时间
    out_trade_no String 可选 OT4392057438956
  • 最大长度:64
  • 外部订单号,和trade_no不能同时为空
    actual_pay_fee Number 可选 5000 实付金额,单位人民币分;该字段实际为必选,为兼容已经接入的isv设置成可选
    store_id String 可选 10004 只传out_trade_no时候,零售+门店号一定要传

    响应参数

    名称 类型 示例值 描述
    gmt_payment Date 2017-01-01 12:00:00 gmtPayment
    extend_params String {"k1":v1} 扩展参数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaNlifeB2cTradePayRequest req = new AlibabaNlifeB2cTradePayRequest();
    req.setTradeNo("10000400000000045678");
    List<AlibabaNlifeB2cTradePayRequest.FundBill> list2 = new ArrayList<AlibabaNlifeB2cTradePayRequest.FundBill>();
    AlibabaNlifeB2cTradePayRequest.FundBill obj3 = new AlibabaNlifeB2cTradePayRequest.FundBill();
    list2.add(obj3);
    obj3.setId("2017022837483658463");
    obj3.setType("ALIPAY");
    obj3.setBuyerId("294344535");
    obj3.setBuyerIdType("ALIPAY_OPENID");
    obj3.setTitle("支付宝支付");
    obj3.setAmount(180L);
    obj3.setCurrency("CNY");
    obj3.setExtendParams("{\"k1\":v1;\"k2\":v2}");
    obj3.setAttachment("gender:female");
    req.setFundBillList(list2);
    req.setPickingUp("SELF_DELIVERY");
    req.setConsignee("孙悟空");
    req.setConsigneePhoneNum("0571-85022088");
    req.setConsigneeAddress("阿里巴巴西溪园区");
    req.setGmtPayment(StringUtils.parseDateTime("2017-01-20 13:00:00"));
    req.setOutTradeNo("OT4392057438956");
    req.setActualPayFee(5000L);
    req.setStoreId("10004");
    AlibabaNlifeB2cTradePayResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_nlife_b2c_trade_pay_response>
        <gmt_payment>2017-01-01 12:00:00</gmt_payment>
        <extend_params>{&quot;k1&quot;:v1}</extend_params>
    </alibaba_nlife_b2c_trade_pay_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部