出行券切卡组件预下单

更新时间：2024.11.18

商户在拉起快捷切卡小程序前，需要先调用本接口预下单，下单成功后，通过返回的token拉起小程序，本接口的调用商户需要和拉起组件传入的调用商户是同一个。

接口说明

支持商户：【普通服务商】【渠道商】【从业机构】

请求方式：【POST】/v3/industry-coupon/tokens

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

body 包体参数

open_id 　必填 string(64)

【用户标识】用户在商户AppID下的唯一标识，该用户为后续拉起切卡组件的用户

coupon_list 　必填 array[TransitCouponEntity]

【出行券列表】用户最近领取的出行券列表。校验规则：

1、多组券ID不能有重复；

2、多组券只能是同一批次下的；

3、由于是领券后拉起切卡组件，所以券列表中的券需要是用户最近5分钟内领取的

属性

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/industry-coupon/tokens \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "open_id" : "obLatjrR8kUDlj4-nofQsPAJAAFI",
8    "coupon_list" : [
9      {
10        "stock_id" : 16474341,
11        "coupon_id" : "11004999626"
12      }
13    ]
14  }'
15

应答参数

200 OK

token 　选填 string(1024)

【切卡组件token值】切卡组件预下单token，随后用于拉起快捷切卡小程序

expires_time 　选填 string(32)

【token过期时间】 token过期时间，遵循RFC3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

应答示例

200 OK

1{
2  "token" : "16824f40-aec1-11e8-a69c-f7a44da04f19",
3  "expires_time" : "2015-05-20T13:29:35+08:00"
4}
5

错误码

公共错误码

状态码	错误码	描述	解决方案
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	频率过快，请稍后重试	请降低调用频率

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服