基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分
支付即服务
行业方案
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
消费卡
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
付款
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传

接入前准备

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安全 > API安全】目录,点击【APIV3密钥】。

  • 2在弹出窗口中点击“已沟通”。

  • 3输入API密钥,内容为32位字符,包括数字及大小写字母。点击获取短信验证码。

  • 4输入短信验证码,点击“确认”即设置成功。

  • 完成

4.下载并配置商户证书

商户API证书具体使用说明可参见接口规则文档中私钥和证书章节

商户可登录微信商户平台,在【账户中心】->【API安全】->【API证书】目录下载证书

以下为具体下载步骤:

  • 1从2018年底开始,微信支付新入驻机构及商户都将使用CA签发证书,在证书申请页面上点击“下载证书”。

  • 2在弹出窗口内点击“下载证书工具”按钮下载证书工具。

  • 3安装证书工具并打开,选择证书需要存储的路径后点击“申请证书”。

  • 4在证书工具中,将复制的商户信息粘贴并点击“下一步”。

  • 5获取请求串

  • 6生成证书串

    步骤1 在【商户平台】-“复制证书串”环节,点击“复制证书串”按钮后;

    步骤2 在【证书工具】-“复制请求串”环节,点击“下一步”按钮进入“粘贴证书串”环节;

    步骤3 在【证书工具】-“粘贴证书串”环节,点击“粘贴”按钮后;

    步骤4 点击“下一步”按钮,进入【证书工具】-“生成证书”环节

  • 7在【证书工具】-“生成证书”环节,已完成申请证书流程,点击“查看证书文件夹”,查看已生成的证书文件。

  • 完成

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》,完成消费卡发放



技术咨询

文档反馈