支持第三方调用
支持沙箱环境调用
禁止个人开发者调用
不支持直连支付
公共请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| app_id | string | 是 | 小程序appid |
| access_token | string | 是 | 小程序调用凭证 |
业务请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| product_type | int32 | 是 | 商品类型，2=预售券，3=日历商品 |
| open_id | string | 是 | 用户id |
| out_order_id | string | 否 | 外部订单id，预售券：表示主单订单id，日历商品：不需要传 |
| out_product_id | string | 是 | 外部商品id，预售券：商品主品id即可(不需要传小品id)，日历商品：预约品id |
| out_sku_id | string | 是 | 外部sku id，预售券：商品主品sku id即可(不需要传小品id)，日历商品：预约品sku id |
| poi_id | string | 否 | 门店id，若订单的商品是分账到门店的商品，则必传 |
book_info | struct | 是 | 预约信息 |
out_book_order_id | string | 是 | 预约订单外部订单id |
total_price | int64 | 是 | 预约单总金额，预售券模式下可为0，即不需要补差价，单位到分 |
book_detail | list_struct | 是 | 预约明细，日历商品明细只有一条 |
voucher_code | string | 否 | 小红书侧凭证code，预售券：用于预约的凭证CODE，日历商品：不需要传 |
price | int64 | 是 | 差价金额，预售券模式下可为0，即不需要补差价 |
check_in_date | string | 是 | 入住日期，yyyy-MM-dd格式 |
check_out_date | string | 是 | 离店日期，yyyy-MM-dd格式 |
| path | string | 否 | 商品小程序打开路径，/开头 |
请求示例
{
"product_type":0,
"open_id":"string",
"out_order_id":"string",
"out_product_id":"string",
"out_sku_id":"string",
"poi_id":"string",
"book_info":{
"out_book_order_id":"string",
"total_price":0,
"book_detail":[
{
"voucher_code":"string",
"price":0,
"check_in_date":"string",
"check_out_date":"string"
}
]
},
"path":"string"
}
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
data | struct | 否 | |
out_order_id | string | 否 | 外部订单id，预售券：表示主单订单id，日历商品：不需要传 |
out_book_order_id | string | 是 | 预约订单外部订单id |
pay_detail | struct | 否 | 支付明细，服务商基于该信息唤起收银台，如果是预售券不需要补差价，该字段为空 |
order_id | string | 是 | 小红书订单id，等待该订单的支付成功消息，成功之后认为预约流程完成，可以发起预约单状态同步流程 |
final_price | int64 | 是 | 支付的订单总金额，单位到分 |
pay_token | string | 是 | 订单支付用token,用于拉起小程序支付api |
expired_time | int64 | 是 | 订单支付到期时间，时间戳精确到秒 |
book_result | list_struct | 是 | 预约结果信息，服务商需要建立mapping关系，日历商品只有1个 |
book_id | string | 是 | 小红书侧预约id，服务商侧建立mapping关系，后续的预约单状态同步，退款交互都基于该单号 |
voucher_code | string | 否 | 小红书侧凭证code，日历商品订单该字段为空 |
| success | bool | 否 | 是否成功 |
| msg | string | 否 | 说明，正确响应时为 success，错误响应时为错误描述 |
| code | int32 | 否 | 错误码，正确响应时为 0，错误响应时非0 |
{
"data":{
"out_order_id":"string",
"out_book_order_id":"string",
"pay_detail":{
"order_id":"string",
"final_price":0,
"pay_token":"string",
"expired_time":0
},
"book_result":[
{
"book_id":"string",
"voucher_code":"string"
}
]
},
"success":true,
"msg":"string",
"code":0
}
参见错误码