验券 - 抖音

poi_info 信息

团购类商品库商品下单的订单必填所有字段（强校验）。请尽量传入真实的核销门店信息，这对订单后续的评价、内部转化等都有积极作用。

名称	类型	是否必填	描述	示例值
shop_name	string	否	核销店铺名称，参考商铺同步接口中的店铺名称（name）字段。团购类商品库商品下单的订单必填。	xx 门店
ext_valid_shop_id	string	否	核销门店的外部店铺 id，参考商铺同步接口中的接入方店铺 id（supplier_ext_id）字段团购类商品库商品下单的订单必填。	x0001
valid_poi_id_str	string	否	核销门店对应的抖音 poi_id，参考商铺同步接口中的抖音 poi_id 字段团购类商品库商品下单的订单必填。	6601136930455291912

result_code 不同值的含义

值	result_msg	含义
0	验券成功	成功
1208	券码已核销	代表券码已核销。短时间内的重试请求可能会返回1208，可当做成功处理。
1211	其他错误	检查券码有效期。如果券码不在有效期范围内，将会返回此错误。不在有效期内不能核销。

错误码

HTTP 状态码	错误码	描述	排查建议
200	10000	参数错误	参数不符合规范。请根据提示检查参数。
200	13000	系统错误，请重试	内部错误，重试可解决。
200	11001	访问未授权	请求的小程序和订单的小程序不匹配。
200	20000	订单不存在	检查传入的 order_id 参数是否正确。
200	21001	商品单状态不支持核销	商品单状态不符合可核销要求，请查询商品单信息，只有商品单状态为待使用状态才可核销。

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/trade/v2/delivery_verify' \ --header 'Content-Type: application/json' \ --data-raw '{ "verify_token":"xxx", "order_id":"ot123456", "certificates":[ { "encrypted_code":"xxx", "certificate_id":"123456" } ], "poi_info":"{\"shop_name\":\"xx门店\",\"ext_valid_shop_id\":\"x0001\",\"valid_poi_id_str\":\"6601136930455291912\"}" }'

{ "err_no": 0, "err_tips": "success", "data": { "verify_results": [ { "item_order_id": "ot123", "certificate_code": "888888888888", "result_code": 0, "result_msg": "验券成功", "verify_time": 1658300479000 } ] } }

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

verify_token

string

必需

验券标识，从验券准备接口获取的，用于幂等。

order_id

string

必需

交易系统单号，从验券准备接口获取。

certificates

array [object {2}]

必需

验券准备接口返回的加密券码，传入几份表示核销几份。

encrypted_code

string

加密券码

可选

certificate_id

string

券 id

可选

poi_info

string

可选

核销的商铺 POI 信息，最多 1024 个字节。注意：商品库商品下单的订单必填。此字段为 json string，按下面结构填入所需字段后序列化成 string。

示例

application/json

Body

err_no

integer

必需

err_tips

string

必需

data

object

必需

verify_results

array [object {5}]

必需

数组，每个券的验券结果

验券

poi_info 信息#

result_code 不同值的含义#

错误码#

请求参数

返回响应

poi_info 信息

result_code 不同值的含义

错误码