基本信息
| Item |
Info |
| name |
核销 |
| URL |
/supplier/v1/carserve/ticket/verify |
| Method |
POST |
| Content-Type: |
application/json |
query参数
| 参数名 |
是否必须 |
类型 |
备注 |
| app_id |
必须 |
string |
|
| sign |
必须 |
string |
|
| timestamp |
必须 |
string |
10位unix时间戳 |
接口body参数
| 参数名 |
类型 |
是否必须 |
说明 |
| source |
string |
必须 |
系统来源编码(10012001-车点点, 10012002-盛大) |
| ticket_no |
string |
必须 |
蔚来券码（以【NIO-】开头） |
| tp_merchant_no |
string |
必须 |
三方商户编码 |
返回参数说明
| 参数名 |
类型 |
是否必须 |
说明 |
| result_code |
string |
|
参考 API 规范 |
| request_id |
string |
|
参考 API 规范 |
| debug_msg |
string |
|
参考 API 规范 |
| display_msg |
string |
|
参考 API 规范 |
| server_time |
long |
|
参考 API 规范 |
| data |
object |
|
|
| |─ticket |
object |
|
券信息（核销后） |
| |─order_no |
string |
|
订单号 |
| |─tp_commodity_no |
string |
|
三方商品编码 |
| |─create_time |
long |
|
创建时间（13位时间戳） |
| |─expire_time |
long |
|
失效时间（13位时间戳） |
| |─verificate_time |
long |
|
核销时间（13位时间戳） |
| |─status |
integer |
|
服务券状态：10-待使用；20-已核销；30-已失效 |
| |─result |
integer |
|
核销结果枚举 |
| |─reason |
string |
|
核销失败原因 |
返回示例
{
"result_code":"success",
"debug_msg":"success",
"display_msg":"success",
"request_id":"0a7d9161ivvxqxry-164",
"server_time":1518143886,
"data": {
"ticket": {
"order_no": "abc",
"tp_commodity_no": "cba",
"create_time": 1697114679000,
"expire_time": 1697114679000,
"verificate_time": 1697114679000,
"status": 20
},
"result": 100,
"reason": "核销成功"
}
}
result_code枚举
| code |
描述 |
| success |
成功 |
| fail |
系统异常 |
| missing_required_parameters |
参数缺失 |
| parameters_length_error |
参数长度不正确 |
| ticket_verified |
券已核销 |
| ticket_not_exist |
券不存在 |
| ticket_expired |
券已过期 |
| ticket_invalid |
券已失效 |
| wrong_supplier |
供应商不匹配 |
| wrong_merchant |
商户不匹配 |
| merchant_not_exist |
商户不存在 |
| merchant_invalid |
商户下架 |
| commodity_not_exist |
商品不存在 |
| commodity_invalid |
商品三方状态下架 |
| order_not_exist |
订单不存在 |
| order_completed |
订单已完成 |
| order_status_error |
仅支持待使用状态订单核销 |
| standard_commodity_invalid |
标准商品失效 |
| merchant_commodity_display_invalid |
商户商品不是展示状态 |
| other |
其他原因 |
| system_error |
系统异常 |