出行券切卡组件预下单
更新时间：2024.12.25商户在拉起快捷切卡小程序前，需要先调用本接口预下单，下单成功后，通过返回的token拉起小程序，本接口的调用商户需要和拉起组件传入的调用商户是同一个。
# 接口说明
支持商户： 【普通服务商】【渠道商】【从业机构】
请求URL： /v3/industry-coupon/tokens
请求方式： 【POST】
# 请求参数
- open_id 必填【用户标识】 用户在商户AppID下的唯一标识，该用户为后续拉起切卡组件的用户。
- coupon_list 必填【出行券列表】 用户最近领取的出行券列表。 校验规则：1、多组券ID不能有重复；2、多组券只能是同一批次下的；3、由于是领券后拉起切卡组件，所以券列表中的券需要是用户最近5分钟内领取的
- 数组
Body 包体参数
# 返回参数
- token 选填【切卡组件token值】 切卡组件预下单token，随后用于拉起快捷切卡小程序。
- expires_time 选填【token过期时间】 token过期时间，遵循RFC3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。
请求示例
1{2 "coupon_list": [3 {4 "coupon_id": "11004999626",5 "stock_id": 164743416 }7 ],8 "open_id": "obLatjrR8kUDlj4-nofQsPAJAAFI"9}返回示例
1{2 "expires_time": "2015-05-20T13:29:35+08:00",3 "token": "16824f40-aec1-11e8-a69c-f7a44da04f19"4}# 错误码
# 公共错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
| 401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
| 500 | SYSTEM_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
# 业务错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 参数错误，请检查重试 | 请根据具体错误信息检查参数是否填写正确 |
| 400 | INVALID_REQUEST | authinfo解析商户code失败 | 请检查鉴权信息是否填写正确 |
| 400 | INVALID_REQUEST | authinfo解析商户ID失败 | 请检查鉴权信息是否填写正确 |
| 400 | INVALID_REQUEST | OpenID有误，请检查后重试 | 请检查OpenID填写是否正确 |
| 400 | INVALID_REQUEST | 参数错误，没传入券列表 | 请检查是否传了券列表 |
| 400 | INVALID_REQUEST | 单次请求只能传一个批次号 | 请检查多组券的批次是否一致 |
| 400 | INVALID_REQUEST | 券ID存在重复，请检查参数列表 | 请检查券ID是否重复 |
| 400 | INVALID_REQUEST | 用户近五分钟没有领取该批次的券 | 请检查用户5分钟内是否领取了该批次的券 |
| 400 | INVALID_REQUEST | 参数传入的券ID列表有误（不是该用户最近五分钟内领取的券） | 请检查传入的券ID是否用户最近5分钟领取的 |
| 403 | REQUEST_BLOCKED | 调用方商户号非批次的创建商户或发券商户 | 请查看调用接口的商户号是否为批次的创建商户或者可发券商户 |
| 429 | FREQUENCY_LIMIT_EXCEED | 频率过快，请稍后重试 | 请降低调用频率 |
文档是否有帮助
