文档中心 > API类目 > 度假&门票-交易管理API

taobao.travel.ticket.order.verify (飞猪门票核销通知)

系统商通过TOP接口调用通知飞猪门票核销情况

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
check_num Number 可选 1 核销次数
order_id Number 可选 12345678 下单订单ID
return_num Number 可选 0 门票取消数量
total_num Number 可选 1 门票总共允许核销次数
out_order_id String 可选 12345 外部订单ID
confirm_code String 可选 2516352 (新接入使用voucher_infos)用户短信会收到的确认号
voucher_infos VoucherInfoDto [] 可选
  • 最大列表长度:999
  • 使用凭证信息
    • └ confirm_code
    • String
    • 可选
    • 2516352
    • 用户短信会收到的确认号
    • └ used_quantity
    • Number
    • 可选
    • 1
    • 凭证使用次数
    • └ used_date
    • String
    • 可选
    • 2020-01-11 14:00:00
    • 凭证使用时间,格式:yyyy-MM-dd HH:mm:ss
    write_off_type Number 可选 0 供应商核销回调类型:0表示使用本次核销数量(常规),1表示使用总核销数量(已使用+本次)

    响应参数

    名称 类型 示例值 描述
    is_success Boolean true 成功状态true or false

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TravelTicketOrderVerifyRequest req = new TravelTicketOrderVerifyRequest();
    req.setCheckNum(1L);
    req.setOrderId(12345678L);
    req.setReturnNum(0L);
    req.setTotalNum(1L);
    req.setOutOrderId("12345");
    req.setConfirmCode("2516352");
    List<TravelTicketOrderVerifyRequest.VoucherInfoDto> list2 = new ArrayList<TravelTicketOrderVerifyRequest.VoucherInfoDto>();
    TravelTicketOrderVerifyRequest.VoucherInfoDto obj3 = new TravelTicketOrderVerifyRequest.VoucherInfoDto();
    list2.add(obj3);
    obj3.setConfirmCode("2516352");
    obj3.setUsedQuantity(1L);
    obj3.setUsedDate("2020-01-11 14:00:00");
    req.setVoucherInfos(list2);
    req.setWriteOffType(0L);
    TravelTicketOrderVerifyResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <travel_ticket_order_verify_response>
        <is_success>true</is_success>
    </travel_ticket_order_verify_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

    返回
    顶部