淘宝开放平台

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

交易API

qimen.taobao.life.booking.ticket.trade.query (本地生活预订门票订单查询)

1、在出票接口返回出票中，退款接口返回退款中，这两种情况我方会用该接口主动同步订单状态 2、请注意该接口需要把门票凭证码也同意返回

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_order_no String 可选 12321321 外部订单号
trade_no String 必须 12321321 订单号

响应参数

名称 类型 示例值 描述
biz_success Boolean true 是否成功
biz_error_code String SYSTEM_ERROR 错误代码，只有success=false需要
biz_error_message String 系统错误 错误信息，用来描述具体错误原因
out_order_no String 12321321 外部订单号
trade_no String 12321 订单号
ticket_total_count Number 2 总数量
ticket_used_count Number 2 使用数量
ticket_refund_count Number 0 退款数量
order_status String WAIT_PAY 订单状态，WAIT_PAY:待支付 WAIT_DELIVERY:待发货 WAIT_CONSUME:待消费 CONSUMED:已消费 REFUNDING:退款中 REFUND:已退款 EXPIRED:已过期
voucher_type String 1 凭证码类型：0为不需要码核销，1为需要码核销。 0时可以不用传vouchers，后续核销也直接按照数量进行核销 1时必须传vouchers，后续核销请按照码进行核销（目前只有整单核，一个码核了会全部订单都核销）
voucher_list Voucher [] 凭证集合
  • └ voucher
  • String
  • 1232131
  • 凭证码
  • └ voucher_change_time
  • String
  • 2020-09-08 12:00:00
  • 凭证变化时间
  • └ status
  • String
  • USED
  • 凭证状态，WAIT_USE：待使用 USED：已使用 PART_USED：部分使用 REFUNDED：已退款 INVALID：已作废
  • └ voucher_url
  • String
  • https://www.taobao.com/1.png
  • 凭证url
success Boolean true 是否成功（废弃，使用biz_开头的）
error_code String SYSTEM_ERROR 错误代码，只有success=false需要（废弃，使用biz_开头的）
error_message String 系统错误 错误信息，用来描述具体错误原因（废弃，使用biz_开头的）

请求示例

{"out_order_no":"12321321","trade_no":"12321321"}

响应示例

{
    "biz_success":true,
    "biz_error_code":"SYSTEM_ERROR",
    "biz_error_message":"系统错误",
    "out_order_no":"12321321",
    "trade_no":"12321",
    "ticket_total_count":2,
    "ticket_used_count":2,
    "ticket_refund_count":0,
    "order_status":"WAIT_PAY",
    "voucher_type":"1",
    "voucher_list":[
        {
                "voucher":"1232131",
                "voucher_change_time":"2020-09-08 12:00:00",
                "status":"USED",
                "voucher_url":"https:\/\/www.taobao.com\/1.png"
        }
    ],
    "success":true,
    "error_code":"SYSTEM_ERROR",
    "error_message":"系统错误"
}

验签示例

{"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部