淘宝开放平台

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

交易API

qimen.taobao.life.booking.ticket.trade.sync (本地生活预订门票订单同步)

1、我方在门票过期时，会通知第三方门票状态都变更，请第三方接到通知后及时变更门票信息 2、注意，目前只支持整单核，整单退，因此，如果订单过期是调用接口返回的更改后凭证列表又一个是核销的，则全部核销

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_order_no String 可选 12321321 外部订单号
trade_no String 必须 12321321 订单号
ticket_total_count Number 必须 2 总数量
ticket_used_count Number 必须 2 使用的数量
ticket_refund_count Number 必须 0 退款的数量
voucher_list Voucher [] 必须
  • 最大列表长度：999999
    		•  凭证列表
    • └ voucher
    • String
    • 必须
    • 1232131
    • 凭证码
    • └ voucher_change_time
    • String
    • 必须
    • 2020-09-08 12:00:00
    • 凭证变化时间
    • └ status
    • String
    • 必须
    • USED
    • 凭证状态，WAIT_USE：待使用 USED：已使用 PART_USED：部分使用 REFUNDED：已退款 INVALID：已作废
    trade_status String 必须 EXPIRED 订单状态 WAIT_PAY:待支付 WAIT_DELIVERY:待发货 WAIT_CONSUME:待消费 CONSUMED:已消费 REFUNDING:退款中 REFUND:已退款 EXPIRED:已过期 WAIT_PAY_CLOSE:支付关闭
    sync_reason String 必须 EXPIRED 同步原因，如因为过期退需要同步订单状态，设置原因为过期

    响应参数

    名称 类型 示例值 描述
    biz_success Boolean true 业务是否成功
    biz_error_code String SYSTEM_ERROR 错误代码，只有success=false需要是否成功
    biz_error_message String 系统错误 错误信息，用来描述具体错误原因是否成功
    after_change_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：已作废
    success Boolean true 是否成功（废弃，优先使用biz_开头的）
    error_code String SYSTEM_ERROR 错误代码，只有success=false需要（废弃，优先使用biz_开头的）
    error_message String 系统错误 错误信息，用来描述具体错误原因（废弃，优先使用biz_开头的）

    请求示例

    {"ticket_used_count":2,"ticket_total_count":2,"voucher_list":[{"voucher":"1232131","voucher_change_time":"2020-09-08 12:00:00","status":"USED"}],"trade_status":"EXPIRED","out_order_no":"12321321","trade_no":"12321321","sync_reason":"EXPIRED","ticket_refund_count":0}

    响应示例

    {
    "biz_success":true,
    "biz_error_code":"SYSTEM_ERROR",
    "biz_error_message":"系统错误",
    "after_change_voucher_list":[
        {
                "voucher":"1232131",
                "voucher_change_time":"2020-09-08 12:00:00",
                "status":"USED"
        }
    ],
    "success":true,
    "error_code":"SYSTEM_ERROR",
    "error_message":"系统错误"
}

    验签示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

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