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

1、用户我平台下单之后,我方会同步调用该接口去合作方创建订单预校验 2、合作方创建订单预校验失败请返回SYSTEM_ERROR(系统异常)PRICE_CHECK_ERROR(价格校验失败)PURCHASE_OVERFLOW(超过景区限购)CREDENTIAL_OVERFLOW(证件限购)MOBILE_OVERFLOW(电话号码限购)OTHER_ERROR(其他校验不通过的原因),system_error我方会忽略,其他异常会走废单逻辑,前端提示用户对应的下单失败原因 3、这个接口在交易主链路中,我方最多会等待1s超时时间,超时时间内未返回结果我方会默认交易通过,继续之后的创单流程

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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 Visitors [] 可选
  • 最大列表长度:999999
  • 游玩人列表
    • credentials
    • Credentials []
    • 可选
    • 证件集合
    • └ 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格式
    store_id String 可选 319312001 淘宝店铺id
    shop_id String 可选 202910293103213000 口碑店铺ID

    响应参数

    名称 类型 示例值 描述
    biz_success Boolean true 业务是否成功
    biz_error_code String SYSTEM_ERROR 错误代码,只有biz_success=false需要是否成功
    biz_error_message String 系统错误 错误信息,用来描述具体错误原因是否成功

    请求示例

    {"store_id":"319312001","visitors":[{"credentials":[{"credential_type":"ID_CARD","credential_no":"330681199909201020"}],"mobile":"18888888888","name":"张三"}],"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":"系统错误"
    }

    验签示例

    {"biz_success":"false","biz_error_code":"sign-check-failure","biz_error_message":"Illegal request"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    FAQ

    返回
    顶部