预受理领卡请求API

最新更新时间:2020.06.12 版本说明


商户在引导用户跳转先享卡领卡前,需要请求先享卡预受理领卡请求接口,再根据返回数据引导用户跳转领卡。

接口说明

适用对象:直连商户

请求URL:https://api.mch.weixin.qq.com/v3/discount-card/cards

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


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"
}

    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
预领卡请求token prepare_card_token string[1,256] 预领卡请求token,在引导用户进入先享卡领卡时,需要传入prepare_card_token
示例值:zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2

返回示例


{
  "prepare_card_token" : "zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2"
}
                                

    http://2323weixin.qq.com
                

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
404 RESOURCE_NOT_EXISTS 订单不存在,请检查订单号是否正确 请传入正确的订单号
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 当前状态无需操作
401 SIGN_ERROR 签名验证失败 请检查签名参数和方法是否都符合签名算法要求
403 NO_AUTH 权限异常 请开通商户号相关权限,请联系产品或商务申请
429 FREQUENCY_LIMITED 请求超过频率限制 请求未受理,请降低频率后重试

版本说明

关闭
V1.0
2020.06.05
1. 预受理领卡请求接口上线

技术咨询

反馈有奖