微信平台投放卡券

接口简介该模块只针对自定义code商户，非自定义code开发者请自动忽略。 开发者可以将自定义code提前导入至微信服务器，以获得和非自定义code商户同样的投放能力，如分组群发、客服消息下发卡券等。导入code后的卡券在投放时等同于非自定义code卡券新创建卡券如果开发者打算新创建一张支持导入code模式的卡券，不同于以往的创建方式，建议开发者采用以下流程创建预存code模式卡券，否则会报错。步骤一：创建预存模式卡券，将库存quantity初始值设置为0，并填入get_custom_code_mode字段;步骤二：待卡券通过审核后，调用导入code接口并核查code;步骤三：调用修改库存接口，须令卡券库存小于或等于导入code的数目。(为了避免混乱建议设置为相等)非新创建卡券如果开发者已经有一张卡券，想把它改为预存code模式，建议开发者按照以下流程对卡券进行更新。步骤一：调用导入code接口导入一定量的自定义code并核查code;步骤二：调用更改卡券信息接口填入get_custom_code_mode字段;步骤三：调用修改库存接口将卡券库存quantity设置为与导入code数目相等的数字。4.1.1 填入/更新导入code必需字段接口说明自定义code的卡券仅支持API创建，创建时务必在base_info中加入以下字段(详情见接口文档CreateCard创建卡券接口)， 加入以下两个指定字段后，才可以调用code导入接口进行code导入字段示例说明base_info  get_custom_code_modeGET_CUSTOM_CODE_MODE_DEPOSIT填入该字段后，自定义code卡券方可进行导入code并投放的动作。use_custom_codetrue将卡券设置为自定义code创建卡券时JSON示例{ "card": {     "card_type": "GROUPON",     "groupon": {     "base_info": {     ··········     "use_custom_code":true,     "get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",         },          "advanced_info": {      ··········          },         "deal_detail": "示例"     }   }}更新卡券时JSON示例 {      "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",      "groupon": {       "base_info": {      ·········                    "get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",      ·········              }        } } 注意事项： 创建/更新填入get_custom_code_mode时，须检查库存数与已经导入code数目的关系，当导入code的数目小于库存数时，会报错。4.1.2 导入code接口在自定义code卡券成功创建并且通过审核后，必须将自定义code按照与发券方的约定数量调用导入code接口导入微信后台。接口说明开发者可调用该接口将自定义code导入微信卡券后台，由微信侧代理存储并下发code。注： 1）单次调用接口传入code的数量上限为100个。2）每一个 code 均不能为空串。3）导入结束后系统会自动判断提供方设置库存与实际导入code的量是否一致。4）导入失败支持重复导入，提示成功为止。接口调用请求说明HTTP请求方式: POSTURL:http://api.weixin.qq.com/card/code/deposit?access_token=ACCESS_TOKEN请求参数说明参数是否必须说明access_token是调用接口凭证buffer是文件的数据流POST数据{   "card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",   "code": [       "11111",       "22222",       "33333",       "44444",       "55555"   ]}字段说明字段说明是否必填card_id需要进行导入code的卡券ID。是code需导入微信卡券后台的自定义code，上限为100个。是返回数据说明{  "errcode":0,  "errmsg":"ok"}字段说明字段说明errcode错误码，0为正常；40109：code数量超过100个errmsg错误信息。succ_code成功个数duplicate_code重复导入的code会自动被过滤。fail_code失败个数。4.1.3 查询导入code数目接口接口说明支持开发者调用该接口查询code导入微信后台成功的数目。接口调用请求说明HTTP请求方式: POSTURL:http://api.weixin.qq.com/card/code/getdepositcount?access_token=ACCESS_TOKEN请求参数说明参数是否必须说明access_token是调用接口凭证POST数据{   "card_id" : " pDF3iY0_dVjb_Pua96MMewA96qvA "}字段说明字段说明是否必填card_id进行导入code的卡券ID。是返回数据说明{  "errcode":0,  "errmsg":"ok"，  "count":123}字段说明字段说明errcode错误码，0为正常。errmsg错误信息。count已经成功存入的code数目。4.1.4 核查code接口为了避免出现导入差错，强烈建议开发者在查询完code数目的时候核查code接口校验code导入微信后台的情况。接口说明支持开发者调用该接口查询code导入微信后台的情况。接口调用请求说明HTTP请求方式: POSTURL:http://api.weixin.qq.com/card/code/checkcode?access_token=ACCESS_TOKEN请求参数说明参数是否必须说明access_token是调用接口凭证POST数据{   "card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",   "code": [       "11111",       "22222",       "33333",       "44444",       "55555"   ]}字段说明字段说明是否必填card_id进行导入code的卡券ID。是code已经微信卡券后台的自定义code，上限为100个。是返回数据说明{  "errcode":0,  "errmsg":"ok"  "exist_code":["11111","22222","33333"],  "not_exist_code":["44444","55555"]}字段说明字段说明errcode错误码，0为正常；40109：code数量超过100个errmsg错误信息。exist_code已经成功存入的code。not_exist_code没有存入的code。4.2 图文消息群发卡券支持开发者调用该接口获取卡券嵌入图文消息的标准格式代码，将返回代码填入上传图文素材接口中content字段，即可获取嵌入卡券的图文消息素材。特别注意：目前该接口仅支持填入非自定义code的卡券,自定义code的卡券需先进行code导入后调用。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/mpnews/gethtml?access_token=TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{  "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"}参数名必填类型示例值描述card_id否string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。返回数据 {"errcode":0,"errmsg":"ok","content":"<iframeclass=\"res_iframecard_iframejs_editor_card\"data-src=\"http: \/\/mp.weixin.qq.com\/bizmall\/appmsgcard?action=show&biz=MjM5OTAwODk4MA%3D%3D&cardid=p1Pj9jnXTLf2nF7lccYScFUYqJ0&wechat_card_js=1#wechat_redirect\">"}参数名描述errcode错误码errmsg错误信息content返回一段html代码，可以直接嵌入到图文消息的正文里。即可以把这段代码嵌入到上传图文消息素材接口中的content字段