最新更新时间：2022.07.04 版本说明
商户在拉起快捷切卡小程序前，需要先调用本接口预下单，下单成功后，通过返回的token拉起小程序，本接口的调用商户需要和拉起组件传入的调用商户是同一个。
适用对象：服务商 渠道商 从业机构
请求URL：https://api.mch.weixin.qq.com/v3/industry-coupon/tokens
请求方式：POST
path 指该参数为路径参数
query 指该参数需在请求URL传参
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 用户标识 | open_id | string[1, 64] | 是 | body用户在商户AppID下的唯一标识，该用户为后续拉起切卡组件的用户 示例值：obLatjrR8kUDlj4-nofQsPAJAAFI |
| + 出行券列表 | coupon_list | array | 是 | body用户最近领取的出行券列表。 校验规则： 1、多组券ID不能有重复； 2、多组券只能是同一批次下的； 3、由于是领券后拉起切卡组件，所以券列表中的券需要是用户最近5分钟内领取的 |
{
"coupon_list": [
{
"coupon_id": "11004999626",
"stock_id": 16474341
}
],
"open_id": "obLatjrR8kUDlj4-nofQsPAJAAFI"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 切卡组件token值 | token | string[1,1024] | 否 | 切卡组件预下单token，随后用于拉起快捷切卡小程序 示例值：16824f40-aec1-11e8-a69c-f7a44da04f19 |
| token过期时间 | expires_time | string[1,32] | 否 | token过期时间，遵循RFC3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。 示例值：2015-05-20T13:29:35+08:00 |
{
"expires_time": "2015-05-20T13:29:35+08:00",
"token": "16824f40-aec1-11e8-a69c-f7a44da04f19"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 参数错误，请检查重试 | 请根据具体错误信息检查参数是否填写正确 |
| 400 | INVALID_REQUEST | authinfo解析商户code失败 | 请检查鉴权信息是否填写正确 |
| 400 | authinfo解析商户id失败 | 请检查鉴权信息是否填写正确 | |
| 400 | openid有误，请检查后重试 | 请检查openid填写是否正确 | |
| 400 | 参数错误，没传入券列表 | 请检查是否传了券列表 | |
| 400 | 单次请求只能传一个批次号 | 请检查多组券的批次是否一致 | |
| 400 | 券id存在重复，请检查参数列表 | 请检查券id是否重复 | |
| 400 | 用户近五分钟没有领取该批次的券 | 请检查用户5分钟内是否领取了该批次的券 | |
| 400 | 参数传入的券id列表有误（不是该用户最近五分钟内领取的券） | 请检查传入的券id是否用户最近5分钟领取的 | |
| 403 | REQUEST_BLOCKED | 调用方商户号非批次的创建商户或发券商户 | 请查看调用接口的商户号是否为批次的创建商户或者可发券商户 |
| 429 | FREQUENCY_LIMIT_EXCEED | 频率过快，请稍后重试 | 请降低调用频率 |