淘宝开放平台

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

交易API

qimen.taobao.life.booking.ticket.trade.create (本地生活预订门票订单创建)

1、用户我平台下单之后，我方会异步调用该接口去合作方创建订单 2、合作方创建订单失败请返回TRADE_CREATE_FAIL/PRODUCT_INFO_ERROR/VISITOR_BUY_LIMIT，这些错误我方会识别订单创建实现，其他错误会重试 3、这个接口必须先调用成功才会调用后续出票接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_product_id String 必须 439302 外部产品id
trade_no String 必须 23432432 订单号
trade_amount Number 必须 100 订单金额，分为单位
quantity Number 必须 2 订单购买数量（注意，此处数量非票数量，是购买该产品的数量）
product_rule ProductRule 可选 门票规则
  • └ refund_rule
  • String
  • 可选
  • REFUND_AT_ANY_TIME
  • 退款规则，REFUND_AT_ANY_TIME：随时退 ；REFUND_WITH_CONDITION：条件退；CAN_NOT_REFUND：不可退
  • └ part_refund_deadline
  • String
  • 可选
  • 2020-09-08 11:11:11
  • 部分退款截止时间（针对有条件退）预留字段
  • └ all_refund_deadline
  • String
  • 可选
  • 2020-09-08 11:11:11
  • 全部退款截止时间（针对有条件退）
visitors Visitor [] 必须
  • 最大列表长度：999999
    		•  游玩人列表
    • credentials
    • Credential []
    • 必须
    • { "credentials": [{ "credential_type": "ID_CARD", "credential_no": "330681199909201020" }], "mobile": "18888888888", "name": "张三" }
    • 证件集合
    • └ credential_type
    • String
    • 必须
    • ID_CARD
    • 证件类型
    • └ credential_no
    • String
    • 必须
    • 330681199909201020
    • 证件号
    • └ mobile
    • String
    • 必须
    • 18888888888
    • 手机号
    • └ name
    • String
    • 必须
    • 张三
    • 姓名
    ticket_schedule String 必须 ALL_DAY 门票场次
    ticket_date String 必须 2020-10-12 门票日期,yyyy-MM-dd格式
    real_amount Number 必须 100 商家实收金额，分为单位
    store_id String 可选 319312001 商店id
    shop_id String 可选 202910293103213000 门店id

    响应参数

    名称 类型 示例值 描述
    biz_success Boolean true 业务是否成功
    biz_error_code String SYSTEM_ERROR 错误代码，只有success=false需要是否成功
    biz_error_message String 系统错误 错误信息，用来描述具体错误原因是否成功（
    out_order_no String 123213 合作方订单号，订单创建成功时请务必返回
    success Boolean true 是否成功（废弃，优先使用biz_开头的）
    error_code String SYSTEM_ERROR 错误代码，只有success=false需要是否成功（废弃，优先使用biz_开头的）
    error_message String 系统错误 错误信息，用来描述具体错误原因是否成功（废弃，优先使用biz_开头的）

    请求示例

    {"store_id":"319312001","visitors":[{"credentials":[{"credential_type":"ID_CARD","credential_no":"330681199909201020"}],"mobile":"18888888888","name":"张三"}],"real_amount":100,"shop_id":"202910293103213000","quantity":2,"product_rule":{"refund_rule":"REFUND_AT_ANY_TIME","part_refund_deadline":"2020-09-08 11:11:11","all_refund_deadline":"2020-09-08 11:11:11"},"trade_amount":100,"ticket_schedule":"ALL_DAY","ticket_date":"2020-10-12","trade_no":"23432432","out_product_id":"439302"}

    响应示例

    {
    "biz_success":true,
    "biz_error_code":"SYSTEM_ERROR",
    "biz_error_message":"系统错误",
    "out_order_no":"123213",
    "success":true,
    "error_code":"SYSTEM_ERROR",
    "error_message":"系统错误"
}

    验签示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

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