基本信息
| Item |
Info |
| name |
核销券查询 |
| URL |
/supplier/v1/carserve/ticket/info |
| 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-已失效 |
| |─allow |
boolean |
|
是否允许核销 |
| |─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
},
"allow": false,
"reason": "已核销"
}
}
result_code枚举
| code |
描述 |
| success |
成功 |
| fail |
系统异常 |
| missing_required_parameters |
参数缺失 |
| parameters_length_error |
参数长度不正确 |
| ticket_not_exist |
券不存在 |
|
|
|
|