券核销消息通知
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/v2/result_callback
接口说明
基本信息
| 基本信息 | |
|---|---|
| HTTP URL | 在抖音开放平台-核销工具小程序页面-开发-行业模板-券核销消息通知中订阅。 |
| HTTP Method | POST |
msg 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| app_id | string | 是 | 小程序 app_id | ttxxxxx |
| order_info | object | 是 | 小程序交易系统订单信息 | |
| poi_id | string | 是 | 核销门店poi_id，核销工具订单由开发者下单时传入 | 8607092469467730 |
| coupon_verify_results | array(object) | 是 | 核销工具订单下单时传入的原生券核销信息 |
order_info 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| order_id | string | 是 | 核销工具在小程序交易系统产生的订单号 | ots7057435515980663049 |
| order_source | string | 是 | 订单来源标识 核销工具订单：fulfillment_tool | fulfillment_tool |
coupon_verify_results 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| result_code | int | 是 | 验券结果，0为成功，非0失败 | 0 |
| result_msg | string | 是 | 验券结果说明 | 验券成功 |
| certificate_id | string | 是 | 抖音原生券ID，下单时传入的抵扣券ID | 71843339522862940 |
| verify_id | string | 否 | 此次核销行为的唯一标识，验券成功才会有。 撤销核销接口需要用到 | 71843339522862999 |
| verify_time | int64 | 否 | 核销时间，验券成功才会有。 | 1672748886 |
| code | string | 否 | 核销用户券码code，核销成功后返回，需要联系运营 加白 | 100090023546491 |
msg 字段内容示例
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/v2/result_callback' \
--header 'Content-Type: application/json' \
--data-raw '{
"version": "2.0", //本次固定为2.0, 通过版本信息识别，用不同的结构体去解析上述关键参数
"msg": "{\"app_id\":\"ttxxxxx\",\"poi_id\":\"8607092469467730\",\"order_info\":{\"order_id\":\"ots7057435515980663049\",\"order_source\":\"fulfillment_tool\"},\"coupon_verify_results\":[{\"certificate_id\":\"71843339522862940\",\"verify_id\":\"71843339522862999\",\"verify_time\":1672748886,\"result_code\":0,\"result_msg\":\"验券成功\"}]}",
"type": "coupon_verify"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_tips": "success"
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Body 参数application/json