淘宝开放平台

登录
文档中心 > API类目 > 交易API

交易API

taobao.life.booking.trade.consume.notice (订单消费通知)

1、目前支持全部消费，后续会进行迭代更新 2、对应的凭证码状态需要在voucherList中传递对应的状态 3、接口使用成功会返回成功结果，否则会返回错误信息 4、合作方应在订单消费后第一时间通知我方，推进我方订单状态变更

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ticket_refund_count Number 可选 0
  • 默认值：0
    		•  票退款数量
    trade_no String 可选 12321 订单id
    ticket_use_count Number 可选 1
  • 默认值：0
    		•  票使用数量
    voucher_list VoucherDto [] 可选
  • 最大列表长度：999
    		•  凭证集合
    • └ voucher_change_time
    • String
    • 可选
    • 2020-09-07 12:12:12
    • 凭证变化时间（如核销状态就放核销时间）
    • └ status
    • String
    • 可选
    • USED
    • 凭证状态
    • └ voucher
    • String
    • 可选
    • 1231
    • 凭证码
    ticket_total_count Number 可选 1
  • 默认值：0
    		•  票总数
    out_order_no String 可选 131231 外部订单号

    响应参数

    名称 类型 示例值 描述
    result Result {"success":false,"error":{"code":"SYSTEM_ERROR","message":"系统错误"}} 接口返回model
    • └ trace_id
    • String
    • asd12df1
    • traceId
    • └ success
    • Boolean
    • false
    • 是否成功
    • error
    • TribeError
    • {"code":"SYSTEM_ERROR","message":"系统错误"}
    • 错误
    • └ view
    • String
    • 系统错误，请稍后再试
    • 错误可读性描述
    • └ code
    • String
    • SYSTEM_ERROR
    • 错误代码
    • └ message
    • String
    • 系统错误
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LifeBookingTradeConsumeNoticeRequest req = new LifeBookingTradeConsumeNoticeRequest();
    req.setTicketRefundCount(0L);
    req.setTradeNo("12321");
    req.setTicketUseCount(1L);
    List<LifeBookingTradeConsumeNoticeRequest.VoucherDto> list2 = new ArrayList<LifeBookingTradeConsumeNoticeRequest.VoucherDto>();
    LifeBookingTradeConsumeNoticeRequest.VoucherDto obj3 = new LifeBookingTradeConsumeNoticeRequest.VoucherDto();
    list2.add(obj3);
    obj3.setVoucherChangeTime("2020-09-07 12:12:12");
    obj3.setStatus("USED");
    obj3.setVoucher("1231");
    req.setVoucherList(list2);
    req.setTicketTotalCount(1L);
    req.setOutOrderNo("131231");
    LifeBookingTradeConsumeNoticeResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    <life_booking_trade_consume_notice_response>
        <result>
            <trace_id>asd12df1</trace_id>
            <success>false</success>
            <error>
                <view>系统错误，请稍后再试</view>
                <code>SYSTEM_ERROR</code>
                <message>系统错误</message>
            </error>
        </result>
    </life_booking_trade_consume_notice_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <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测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部