预订验证
说明:此接口用来验证产品是否可以预定成功
请求方式:POST(HTTPS)
请求地址:https://btbapi.sctt.net/v1/check
请求包体:
{ "merchant_id":281953, "request_time":"2023-02-09 11:48:00", "sign":"225D9213E2EF97B6FB6C5C87288E1635", "booking_data":{ "product_id":6230524435, "travel_day":"2024-07-27", "total_price":61.13, "session": "12:45", "pickup_id":12, "dropoff_id":21, "goods_list":[ { "goods_id":5230524847, "sku_list":[ { "sku_id":523052484711, "quantity":1, "price":61.13 } ] } ], "booking":[ { "id":3, "name":"Last Name", "value":"TEST TEST" }, { "id":4, "name":"First Name", "value":"TEST TEST" }, { "id":9, "name":"Email", "value":"TEST TEST" }, { "id":10, "name":"Mobile", "value":"TEST TEST" } ], "traveler_list":[ { "sku_id":521112413701, "entry_item":[ { "id":3, "name":"Last Name", "value":"TEST TEST" }, { "id":4, "name":"First Name", "value":"TEST TEST" }, { "id":9, "name":"Email", "value":"TEST TEST" }, { "id":10, "name":"Mobile", "value":"TEST TEST" } ] } ], "remarks":"string" } }
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
merchant_id | 是 | bigint | 商户编号 |
request_time | 是 | string | 请求时间,格式:“yyyy-MM-dd HH:mm:ss” |
sign | 是 | string | 签名 |
booking_data | 是 | object | 预定对象 |
- product_id | 是 | bigint | 产品编号 |
- travel_day | 否 | string | 出行日(yyyy-MM-dd |
- total_price | 是 | float | 订单总额 |
- pickup_id | 否 | bigint | 接送点 |
- dropoff_id | 是 | bigint | 下车点 |
- goods_list | 是 | list | 购买资源List |
- - goods_id | 是 | bigint | 资源编号 |
- - sku_list | 是 | list | SKU List |
- - - sku_id | 是 | bigint | SKU编号 |
- - - quantity | 是 | int | 数量 |
- - - price | 是 | float | 单价 |
- booking | 是 | list | 预订人 |
- - id | 是 | int | id |
- - name | 是 | string | 填写项标题 (有id此字段不需要赋值,没id 赋值对应标题,如:Last Name,First Name,Email,Mobile |
- - value | 是 | string | 填写值/选择值 |
- traveler_list | 是 | list | 出行人List |
- - sku_id | 是 | bigint | 出行人对应SKU CODE |
- - entry_item | 是 | list | 填写数据结构 |
- - - id | 是 | int | id |
- - - name | 是 | string | 填写项标题 (有id此字段不需要赋值,没id 赋值对应标题,如:Last Name,First Name,Email,Mobile |
- - - value | 是 | string | 填写值/选择值 |
- remarks | 否 | string | 订单备注 |
- session | 否 | string | 时间场次(例:12:45 |
返回结果:
{ "code": 0, "msg": "ok", "data": { "order_code": 0, "total_price": 0, "order_currency": null, "certificate_mode": 0, "certificate_type": 0, "surplus_quota": 0, "cancel_type": 0 } }
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
msg | string | 接口返回信息 |
data | object | 接口返回数据 |
状态码说明:
状态码 | 说明 |
---|---|
0 | 验证成功 |
4001 | 报文错误 |
4002 | 签名错误 |
4003 | 账号停用(商户账号,商户主账号 |
7003 | 产品不存在(下架,不在售 |
7004 | 资源错误 (不存在,下架,不在售 |
7005 | sku错误(不存在,不在售 |
7006 | 销售价格错误(不存在,不在售 |
7007 | 日期错误(日期格式错误,请求日期周期错误 |
7008 | 填写项错误(填写项字符类型错误(填写项为英文字符),填写项为空 |
7009 | 缺少必填项 |
7010 | 产品库存不足 |
7011 | 商户额度不足 |
7013 | 此产品接送点必填 |