适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/discount-card/cards
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商户领卡号 | out_card_code | string[1,32] | 是 | body 商户在请求领卡预受理接口时传入的领卡请求号，同一个商户号下必须唯一，要求32个字符内，只能是数字、大小写字母_-|* 示例值：6e8369071cd942c0476613f9d1ce9ca3 |
| 先享卡模板ID | card_template_id | string[1,64] | 是 | body 先享卡卡模板ID，唯一定义此资源的标识。创建模板后可获得。 示例值：87789b2f25177433bcbf407e8e471f95 |
| 公众账号ID | appid | string[10,32] | 是 | body 微信公众平台分配的与传入的商户号建立了支付绑定关系的appid，可在公众平台查看绑定关系 示例值：wxd678efh567hg6787 |
| 通知商户URL | notify_url | string[1,255] | 是 | body 用于接收用户领卡通知、守约状态变化通知、扣费状态变化通知 示例值：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"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 根据错误提示，传入正确参数 |
| 404 | RESOURCE_NOT_EXISTS | 订单不存在，请检查订单号是否正确 | 请传入正确的订单号 |
| 400 | INVALID_REQUEST | 请求参数符合参数格式，但不符合业务规则 | 当前状态无需操作 |
| 401 | SIGN_ERROR | 签名验证失败 | 请检查签名参数和方法是否都符合签名算法要求 |
| 403 | NO_AUTH | 权限异常 | 请开通商户号相关权限，请联系产品或商务申请 |
| 429 | FREQUENCY_LIMITED | 请求超过频率限制 | 请求未受理，请降低频率后重试 |