正向交易流程
收藏交互动线
创单模式
创单时刻可以锁定库存优先对接两步创单模式，两种模式的差异主要是调用外部创单接口的时机。一步创单比两步创单会少调用一个支付接口。
可定回传 ari 是抖音侧最高效的数据更新链路，用于服务商前置的价量态变更之后没有及时推送的补充链路，强烈建议回传并且对接。
两步创单
一步创单
最佳实践和注意事项
可定检查接口对接最佳实践
- •可定接口复用在日历房和预售预约里面的一次可定和二次可定，通过 bizType来区分业务。
- •一次可定和二次可定的差异主要体现在二次可以有用户留资信息。
- •可定检查接口超时时间为 5s，超时未返回无系统重试，需要用户二次下单。
- •可定检查返回值里面的ari 最小传参结构
{ "stock_and_amount": [ { "available": false,//房态 "inventory": 0,//库存 "original_amount": 0,// 价格 "rate_plan_id": "1800663981114404", //rpid" timerange": {//时间范围，建议只传一个间夜，多个间夜外层数组展开。 "end": "2025-04-08", "start": "2025-04-08" } } ] }
- •错误码需要标准化对接，1 错误码为商品状态，18 错误码为房态异常
- •可定检查价格异常如果回传 ari，用户 C 端页面会主动刷新获取到最新的价格信息，用户可二次点击创单。
创单接口对接最佳实践
- •创单接口超时时间为 3s，超时无响应则都有会在 10min 进行 12 次重试直到成功。
- •12 次都重试失败，则订单会等待用户取消订单和超时拒单。
- •错误码100 主要用作外部重试可解决异常场景分布式锁冲突等。
- •外部需要根据抖音的 orderid 做幂等，如果重试幂等了需要幂等成功返回。
- •如果外部创单时刻即可接单，则需要在创单接口里面回传同步接单和接拒单结果。
- •接单超时时间通用规则为用户支付后 1h，晚 20:00 后会延迟到隔日 10:00 前。
