消费卡接入前准备
1.选择接入模式
商户/服务商在接入前首先要判断自己公司注册区域适用的接入模式，微信支付目前提供两种接入方式：直连模式和服务商模式。
● 直连模式：
信息、资金流：微信支付—>直连商户
直连模式，商户自行申请入驻微信支付，无需服务商协助。（商户平台申请）成为直连商户
● 服务商模式：
—— 信息流 —— 资金流
服务商模式，商户申请成为微信支付服务商，服务商自身无法作为一个直连商户直接发起交易，其发起交易必须传入相关特约商户商户号的参数信息。（服务商平台申请）成为服务商
请结合自身实际情况来选择接入模式。
服务商模式相关说明详见：服务商模式介绍
2.参数申请
商户自行申请入驻微信支付，无服务商协助。（商户平台申请）成为直连商户
-
1申请APPID
由于微信支付的产品体系全部搭载于微信的社交体系之上，所以直连商户或服务商接入微信支付之前，都需要有一个微信社交载体，该载体对应的ID即为APPID。
对于直连商户，该社交载体可以是公众号（什么是公众号），小程序（什么是小程序）或APP。
如申请社交载体为公众号，请前往 公众平台申请
如申请社交载体为小程序，请前往 小程序平台 申请
如商户已拥有自己的APP，且希望该APP接入微信支付，请前往 开放平台申请
商户可根据实际的业务需求来选择申请不同的社交载体。
各类社交载体一旦申请成功后，可以登录对应平台查看账号信息以获取对应的appid。
-
2申请mchid
申请mchid和APPID的操作互不影响，可以并行操作，申请地址如下： 商户号申请平台
申请成功后，会向服务商填写的联系邮箱下发通知邮件，内容包含申请成功的mchid及其登录账号密码，请妥善保存。
注意：一个mchid只能对应一个结算币种，若需要使用多个币种收款，需要申请对应数量的mchid。
-
3绑定APPID及mchid
APPID和mchid全部申请完毕后，需要建立两者之间的绑定关系。
直连模式下，APPID与mchid之间的关系为多对多，即一个APPID下可以绑定多个mchid，而一个mchid也可以绑定多个APPID。
-
完成
3.配置API key
API v3密钥主要用于平台证书解密、回调信息解密，具体使用方式可参见接口规则文档中证书和回调报文解密章节。
请根据以下步骤配置API key：
-
1登录微信商户平台，进入【账户中心 > API安全 】目录，设置APIV3密钥。
-
2在弹出窗口中点击“已沟通”。
-
3输入API密钥，内容为32位字符，包括数字及大小写字母。点击获取短信验证码。
-
4输入短信验证码，点击“确认”即设置成功。
-
完成
4.下载并配置商户证书
商户API证书具体使用说明可参见接口规则文档中私钥和证书章节
商户可登录微信商户平台，在【账户中心】->【API安全】目录下载证书
以下为具体下载步骤：
-
1从2018年底开始，微信支付新入驻机构及商户都将使用CA签发证书，在证书申请页面上点击“申请证书”。
-
2在弹出窗口中点击“确定”。
-
3在弹出窗口内点击“下载证书工具”按钮下载证书工具。
-
4安装证书工具并打开，选择证书需要存储的路径后点击“申请证书”。
-
5在证书工具中，将复制的商户信息粘贴并点击“下一步”。
-
6获取请求串
-
7生成证书串
步骤1 在【商户平台】-“复制证书串”环节，点击“复制证书串”按钮后；
步骤2 在【证书工具】-“复制请求串”环节，点击“下一步”按钮进入“粘贴证书串”环节；
步骤3 在【证书工具】-“粘贴证书串”环节，点击“粘贴”按钮后；
步骤4 点击“下一步”按钮，进入【证书工具】-“生成证书”环节
-
8在【证书工具】-“生成证书”环节，已完成申请证书流程，点击“查看证书文件夹”，查看已生成的证书文件。
-
完成
5. 配置应用
5.1. 权限申请
5.1.1. 公众号开通卡券功能
● 若商户还未拥有开通卡券功能的公众号，商户可以登录【微信公众平台】进行公众号注册并进行认证，具体流程参见：《注册微信公众平台》
● 注册完成后，商户可以登录【微信公众平台】，并进入【添加插件】-【卡包功能】提交相应资料并开通卡券功能，详情参见：《微信卡券功能使用规则》
5.1.2. 申请礼品卡权限
登录微信支付商户后台进入产品中心，找到【微信礼品卡】点击开通
5.2. 创建消费卡
5.2.1. 创建消费卡入口
直连商户登录微信支付商户平台，访问创建消费卡，开始配置消费卡信息。此功能仅向指定邀约商户开放，如有需要可以通过微信支付消费卡功能进行申请
5.2.2. 创建消费卡-创建消费卡
| 参数名称 | 参数说明 |
|---|---|
| 归属appid | 礼品卡需要和appid进行关联，调用发放消费卡API接口时，指定用户的openid使用此appid生成。appid需要和登录商户号有M-A绑定关系 |
| 卡面图片 | 展示在用户卡包，尺寸1000*600，大小不超过2M，支持JPG\PNG格式 |
| 背景颜色 | 展示在用户卡包，可以从备选颜色中选取 |
| 消费卡logo | 展示在用户卡包，尺寸300*300，大小不超过1M，支持JPG\PNG格式 |
| 商户名称 | 展示在用户卡包，如不填写，默认取登录商户号的公司名称 |
| 消费卡价格 | 消费卡实际价值，在用户卡包中不展示，是用于校验关联批次是否正确的信息，消费卡价格需要和消费卡中关联的消费券的面额匹配对应：∑关联消费券批次面额*该批次的每用户发放个数=消费卡价格。 如消费卡关联50元与20元两个批次，其中，20元面额的券发放5张，50元发放10张（用户领取1张消费卡，可领15张券），那么消费卡价格应等于600元。消费卡价格最小0.01元 |
| 使用须知 | 消费卡使用须知 |
| 可用时间 | 消费卡最大持续可用时间90天，建议活动持续7-30天 |
| 客服电话 | 如填写会展示在用户卡包的“消费券详情”中 |
| 自定义入口 | 支持自定义跳转H5链接，如填写会出现在用户卡包中 |
| 发放总个数 | 消费卡总库存。每个关联的批次，发放张数*消费卡发放总个数需要不大于券总库存 |
| 用户可领个数 | 每个微信用户可领取1张，暂时无法更改 |
| 安全防刷 | 为了保证福利必达，默认关闭自然人防刷与可疑账号拦截能力，商户调用发放消费卡API时，只要用户openid有效、符合发放总个数和用户可领个数，都可发放成功 |
5.2.3. 创建消费卡-关联消费券
● 券批次ID：提前配置好代金券，手动输入批次号。代金券必须满足以下要求：
[1] 仅支持本账号登录商户创建的代金券
[2] 仅支持满减券
[3] 一张消费卡最多支持关联10个批次信息
[4] 批次中，“用户类型”必须选择“所有人”
[5] 不管是否勾选领取消息，都不发批次的领取消息，仅发送消费卡的领取消息
[6] 不允许领取时扣除预算的券
[7] 不允许相对有效期的券、不允许非立即可用的券
[8] 必须勾选优惠可同享
[9] 超预算的批次不可添加
[10] 不允许api指定面额的券
[11] 每个关联的批次，发放张数*消费卡发放总个数需要不大于券总库存
● 发放张数：每张消费卡发放该批次的张数。如消费卡关联50元与20元两个批次，其中，20元面额的券打算发放5张，那么20元的批次对应的发放张数应填5。配置代金券时，每用户可领张数需要小于该券在消费卡中的发放张数
5.3. 发放消费卡
调用《发放消费卡API》，完成消费卡发放