最新更新時(shí)間：2022.07.04 版本說明
商戶在拉起快捷切卡小程序前，需要先調(diào)用本接口預(yù)下單，下單成功后，通過返回的token拉起小程序，本接口的調(diào)用商戶需要和拉起組件傳入的調(diào)用商戶是同一個(gè)。
適用對象：服務(wù)商 渠道商 從業(yè)機(jī)構(gòu)
請求URL：https://api.mch.weixin.qq.com/v3/industry-coupon/tokens
請求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 用戶標(biāo)識 | open_id | string[1, 64] | 是 | body用戶在商戶AppID下的唯一標(biāo)識，該用戶為后續(xù)拉起切卡組件的用戶 示例值：obLatjrR8kUDlj4-nofQsPAJAAFI |
| + 出行券列表 | coupon_list | array | 是 | body用戶最近領(lǐng)取的出行券列表。 校驗(yàn)規(guī)則： 1、多組券ID不能有重復(fù)； 2、多組券只能是同一批次下的； 3、由于是領(lǐng)券后拉起切卡組件，所以券列表中的券需要是用戶最近5分鐘內(nèi)領(lǐng)取的 |
{
"coupon_list": [
{
"coupon_id": "11004999626",
"stock_id": 16474341
}
],
"open_id": "obLatjrR8kUDlj4-nofQsPAJAAFI"
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 切卡組件token值 | token | string[1,1024] | 否 | 切卡組件預(yù)下單token，隨后用于拉起快捷切卡小程序 示例值：16824f40-aec1-11e8-a69c-f7a44da04f19 |
| token過期時(shí)間 | expires_time | string[1,32] | 否 | token過期時(shí)間，遵循RFC3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。 示例值：2015-05-20T13:29:35+08:00 |
{
"expires_time": "2015-05-20T13:29:35+08:00",
"token": "16824f40-aec1-11e8-a69c-f7a44da04f19"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤，請檢查重試 | 請根據(jù)具體錯(cuò)誤信息檢查參數(shù)是否填寫正確 |
| 400 | INVALID_REQUEST | authinfo解析商戶code失敗 | 請檢查鑒權(quán)信息是否填寫正確 |
| 400 | authinfo解析商戶id失敗 | 請檢查鑒權(quán)信息是否填寫正確 | |
| 400 | openid有誤，請檢查后重試 | 請檢查openid填寫是否正確 | |
| 400 | 參數(shù)錯(cuò)誤，沒傳入券列表 | 請檢查是否傳了券列表 | |
| 400 | 單次請求只能傳一個(gè)批次號 | 請檢查多組券的批次是否一致 | |
| 400 | 券id存在重復(fù)，請檢查參數(shù)列表 | 請檢查券id是否重復(fù) | |
| 400 | 用戶近五分鐘沒有領(lǐng)取該批次的券 | 請檢查用戶5分鐘內(nèi)是否領(lǐng)取了該批次的券 | |
| 400 | 參數(shù)傳入的券id列表有誤（不是該用戶最近五分鐘內(nèi)領(lǐng)取的券） | 請檢查傳入的券id是否用戶最近5分鐘領(lǐng)取的 | |
| 403 | REQUEST_BLOCKED | 調(diào)用方商戶號非批次的創(chuàng)建商戶或發(fā)券商戶 | 請查看調(diào)用接口的商戶號是否為批次的創(chuàng)建商戶或者可發(fā)券商戶 |
| 429 | FREQUENCY_LIMIT_EXCEED | 頻率過快，請稍后重試 | 請降低調(diào)用頻率 |