验券接口
接口说明
- 提货券抖音券码的核销需要先调用验券准备接口,再调用本接口。
- 可支持多个批量验券,需为同一个订单,不可跨订单验券。
- error_code、result 均为 0 代表验券成功。error_code非0时则表示调用验券接口失败,建议服务商侧主动发起重试,建议间隔5s发起。第一次调用error_code非0,第二次调用error_code=0且result=1208或2,也可以代表验券成功
- 接口报错返回”服务器错误,请稍后重试“、“您的访问过于频繁,请稍后重试”等建议重试的文案后,建议以如下重试策略进行重试,接口成功返回后即可停止重试:
- 前5次重试以5s间隔进行
- 之后以40s间隔进行
- 最高重试14次,如果接口依然报错,请进线反馈
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/compre_retail/fulfilment/certificate/verify/ |
HTTP Method | POST |
Scope | life.capacity.compre_retail_certificate_verify |
权限要求 | 综合到店提货解决方案-提货券抖音码交易,提货券三方码交易能力 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body展开全部子属性
poi_id必填String
核销的抖音门店id
如何获得抖音门店id,可以参考:门店关联及匹配能力
抖音码交易:使用验券准备返回的预约门店
verify_token必填String
一次验券的标识
抖音码交易:验券准备接口返回的验券标识
三方码交易:针对三方码订单,每次请求都需要保证幂等!(请求维度,非券码/订单维度)
account_idString
核销的商家账号
code_with_time_listList
核销前验证核销时间
展开子属性
codesArray<String>
三方券码:券码值列表 codes (encrypted_codes/codes/code_with_time_list必须三选一)
注:抖音券码需要先调用验券准备接口,一般是传encrypted_codes字段,三方码传code_with_time_list 或 codes
encrypted_codesArray<String>
针对抖音券码:验券准备接口返回的加密抖音券码
order_idString
抖音侧的订单号
verify_extraStruct