旅行社交易确认接单接口
接口说明
- 抖音侧通知第三方支付成功后,第三方需要在商品上单中设置的接单时间内通知抖音侧接单结果,超时会拒单。采用异步确认。
- 建议对于接口进行异步重试3次,间隔时间5s
因二维码版本众多,若接口提示无效的二维码,可以在https://www.liantu.com/生成二维码重新接单
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/trip/trade/travelagency/order/confirm/ |
HTTP Method | POST |
Scope | life.capacity.trip_travel_confirm |
权限要求 | 度假行业解决方案-旅行社确认接口 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
confirm_info必填Struct
确认信息
展开子属性
order_id必填String
抖音侧订单号(预约订单号)
source_order_id必填String
预约订单归属的预售订单ID
请求示例
curl --location --request POST '/goodlife/v1/trip/trade/travelagency/order/confirm/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"order_id":"6EgOAOjS8q","source_order_id":"OB2u4Dkymc","confirm_info":{"extra_msg":"vzXCpj9syd","confirm_result":1,"reject_code":1,"hotel_info":{"poi_info":[{"poi_name":"Ly76Y0WncV","poi_id":"hO8IYTL8C3"}],"room_items":[{"room_type":"R4rvzUlWbw","meals":9000390966882285601}]},"play_info":{"show_certs":{"name":"sXnKm7UjWT","card_no":"K9icrJNr36","cert_no":"8TZnsLrnbJ","qr_code_image":"RwEAM7Npo2"},"poi_info":[{"poi_name":"xU9wUCM7EL","poi_id":"WLfIdz6ou6"}],"book_start_time":"NCXa9ulgJm","book_end_time":"1GRVSBJpnW","entrance_types":[7635910298474696313]},"free_travel_info":{"travel_num":{"day_num":6628486512106241503,"night_num":695510042564849379},"oneday_tour_list":[{"hotel_info_list":[{"room_items":[{"room_type":"U7NiASs9RS","meals":3546273506726491173}],"poi_info":[{"poi_id":"YYx5gzFMQ5","poi_name":"P2PBsIGzI5"}]}],"play_info_list":[{"show_certs":{"cert_no":"eHRt1JRbBT","qr_code_image":"cUXLcwKL4n","name":"53pKA6H01u","card_no":"jMZUipxQX6"},"poi_info":[{"poi_id":"iPoGmMlie1","poi_name":"dHO4dZ3lOW"}],"book_start_time":"gj567c7JgD","book_end_time":"0hypuifMJG","entrance_types":[6960931950277433145]}],"sequence":49441194836094840}]}}}'
响应参数
Body展开全部子属性
dataStruct
接口出参
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "error_code": 0, "description": "", "order_out_id": "E2PTx8YaLa", "order_id": "SlXW7mq9Eg" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202412112230373BB910915A64C6E54729", "now": 1733927437 } }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100005 | 参数不合法 | 更换参数 |
200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
200 | 2119001 | 参数不合法 | 更换参数 |
200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
200 | 3000007 | 以实际错误信息为准 | |
200 | 5000002 | 以实际错误信息为准 | |
200 | 5000001 | 服务器打瞌睡了,请稍后再试。 | |
200 | 3000001 | 以实际错误信息为准 |