券码核销通知
开发环境
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 | tt7cd50a68e3b208fc01 |
| order_info | object | 是 | 小程序交易系统订单信息 | |
| poi_id | string | 是 | 核销门店poi_id | 6601149910161033224 |
| verify_results | array(object) | 是 | 券核销信息 | |
| verify_mode | string | 否 | 核销方式，该字段为空说明是接口核销laike : 来客核销 | laike |
| cp_extra | string | 否 | 预下单时开发者传入的透传字段（如果开发者未传，此字段为空） |
order_info 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| order_id | string | 是 | 交易系统订单号 | 1000000096288643630 |
verify_results 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| result_code | int | 是 | 核销结果，0为成功，非0失败 | 0 |
| result_msg | string | 是 | 核销结果说明 | 验券成功 |
| item_order_id | string | 是 | 交易系统商品单号 | 800000000135213440013213630 |
| verify_time | int64 | 否 | 核销时间，验券成功才会有。 | 1679897654 |
| time_card | object | 否 | 次卡次数 | |
| code | string | 否 | 用户券码 | 100000045385072 |
time_card 字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| times_available | int64 | 是 | 剩余可用次数 | 1 |
| times_used | int64 | 是 | 已使用次数 | 1 |
msg 字段内容示例
"app_id": "tt7cd50a68e3b208fc01",
"poi_id": "6601149910161033224",
"order_info": {
"order_id": "1000000096288643630"
},
"verify_results": [
{
"result_code": 0,
"result_msg": "",
"item_order_id": "800000000135213440013213630",
"verify_time": 1679897654,
"time_card": {
"times_available": 1,
"times_used": 1
},
"code": "100000045385072"
}
],
"verify_mode": "laike",
"cp_extra": "{"use_trade_delivery":1}"
}
请求示例请求示例
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",
"msg":"{\"app_id\":\"tt7cd50a68e3b208fc01\",\"poi_id\":\"6601149910161033224\",\"order_info\":{\"order_id\":\"1000000096288643630\"},\"verify_results\":[{\"result_code\":0,\"result_msg\":\"\",\"item_order_id\":\"800000000135213440013213630\",\"verify_time\":1679897654,\"time_card\":{\"times_available\":1,\"times_used\":1},\"code\":\"100000045385072\"}],\"verify_mode\":\"laike\",\"cp_extra\":\"{\\\"use_trade_delivery\\\":1}\"}",
"type": "verify"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_tips": "success"
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Body 参数application/json