商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
平台收付通(商户进件)
平台收付通(普通支付)
平台收付通(合单支付)
平台收付通(分账)
平台收付通(补差)
平台收付通(退款)
平台收付通(余额查询)
平台收付通(商户提现)
平台收付通(注销申请)
平台收付通(注销后提现)
平台收付通(跨境付款)
平台收付通(下载账单)
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
商户违规通知回调
其他能力
图片上传
视频上传
微信支付平台证书

出行券切卡组件预下单API

最新更新时间: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分钟内领取的
参数名 变量 类型[长度限制] 必填 描述
批次号 stock_id int 出行券的批次号,唯一定义出行代金券的标识
示例值:16474341
券ID coupon_id string[1, 64] 用户领券后唯一标识这张券的ID
示例值:11004999626

请求示例


{
  "coupon_list": [
    {
      "coupon_id": "11004999626",
      "stock_id": 16474341
    }
  ],
  "open_id": "obLatjrR8kUDlj4-nofQsPAJAAFI"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
切卡组件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"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

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




技术咨询

文档反馈