撤销核销消息通知
开发环境
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 |
| status | string | 是 | 撤销核销状态枚举值： SUCCESS：撤销核销成功 FAIL：撤销核销失败 | SUCCESS |
| verify_id | string | 是 | 核销的唯一标识，在券核销消息通知中会给到。 | 71843339522862999 |
| certificate_id | string | 是 | 抖音原生团购券ID，即下单时传入的抵扣券ID | 71843339522862940 |
| cannot_cancel_msg | string | 是 | 撤销核销失败原因 超过核销时间1h后将无法撤销核销 | |
| order_info | object | 是 | 小程序交易系统订单信息 |
order_info 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| order_id | string | 是 | 核销工具在小程序交易系统产生的订单号 | ots7057435515980663049 |
| order_source | string | 是 | 订单来源标识 核销工具订单：fulfillment_tool | fulfillment_tool |
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\",\"status\":\"SUCCESS\",\"verify_id\":\"71843339522862999\",\"certificate_id\":\"71843339522862940\",\"cannot_cancel_msg\":\"\",\"order_info\":{\"order_id\":\"ots7057435515980663049\",\"order_source\":\"fulfillment_tool\"}}",
"type": "coupon_verify_cancel"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_tips": "success"
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Body 参数application/json
返回响应
修改于 2023-12-01 06:23:25