適用對象：直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/discount-card/cards
請求方式：POST
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數為路徑參數
query 指該參數為URL參數
body 指該參數需在請求JSON傳參
| 參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶領卡號 | out_card_code | string[1,32] | 是 | body 商戶在請求領卡預受理接口時傳入的領卡請求號，同一個商戶號下必須唯一，要求32個字符內，只能是數字、大小寫字母_-|* 示例值：6e8369071cd942c0476613f9d1ce9ca3 |
| 先享卡模板ID | card_template_id | string[1,64] | 是 | body 先享卡卡模板ID，唯一定義此資源的標識。創(chuàng)建模板后可獲得。 示例值：87789b2f25177433bcbf407e8e471f95 |
| 公眾賬號ID | appid | string[10,32] | 是 | body 微信公眾平臺分配的與傳入的商戶號建立了支付綁定關系的appid，可在公眾平臺查看綁定關系 示例值：wxd678efh567hg6787 |
| 通知商戶URL | notify_url | string[1,255] | 是 | body 用于接收用戶領卡通知、守約狀態(tài)變化通知、扣費狀態(tài)變化通知 示例值：https://api.test.com |
{
"out_card_code" : "6e8369071cd942c0476613f9d1ce9ca3",
"card_template_id" : "87789b2f25177433bcbf407e8e471f95",
"appid" : "wxd678efh567hg6787",
"notify_url" : "https://api.test.com"
}
| 參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 預領卡請求token | prepare_card_token | string[1,256] | 是 | 預領卡請求token，在引導用戶進入先享卡領卡時，需要傳入prepare_card_token 示例值：zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2 |
{
"prepare_card_token" : "zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 5開頭的狀態(tài)碼都為系統(tǒng)問題，請使用相同參數稍后重新調用 |
| 400 | PARAM_ERROR | 參數錯誤 | 根據錯誤提示，傳入正確參數 |
| 404 | RESOURCE_NOT_EXISTS | 訂單不存在，請檢查訂單號是否正確 | 請傳入正確的訂單號 |
| 400 | INVALID_REQUEST | 請求參數符合參數格式，但不符合業(yè)務規(guī)則 | 當前狀態(tài)無需操作 |
| 401 | SIGN_ERROR | 簽名驗證失敗 | 請檢查簽名參數和方法是否都符合簽名算法要求 |
| 403 | NO_AUTH | 權限異常 | 請開通商戶號相關權限，請聯(lián)系產品或商務申請 |
| 429 | FREQUENCY_LIMITED | 請求超過頻率限制 | 請求未受理，請降低頻率后重試 |