开发指引

更新时间:2025.06.22

1、开发前准备

1.1、设置安全联系人

微信支付日常安全监测发现技术异常时,会向安全联系人和超级管理员发送风险提醒。请商户超级管理员尽快设置技术同事为安全联系人,确保能及时接收异常信息评估业务风险,详见安全联系人设置指引

1.2、熟悉微信支付接口规则

正式进入开发前,开发者需要先阅读基本规则开发参数申请和配置了解调用微信支付接口的基本规则和签名规则。

1.3、准备开发参数

在发起接口请求时,开发者还需传入一些必要参数,如服务商商户号、子商户号(也叫特约商户号)、sp_appid、证书私钥、公钥等,获取方式详见:服务商模式开发必要参数说明

2、整体业务开发流程概览

  • 商家开通名片功能后,即可创建、查询、修改会员卡模版。

  • 创建会员卡模版后,可通过4种方式引导用户入会,具体方式可参考下方概览图中的用户入会阶段。

  • 用户领取会员卡后,可同步用户会员动态信息(非微信支付渠道),用于商家名片会员卡展示

3、详细步骤说明

3.1、会员卡模版管理

商户系统可以通过 API 管理会员卡模板,包括创建、查询列表、查询详情、修改、删除等操作:

3.2、用户入会

3.2.1、小程序和H5入会

用户可通过小程序或H5页面进入微信支付开卡组件发起入会流程核心流程如下:

 

3.2.2、商家名片

用户通过商家名片发起入会流程时核心流程如下:

3.2.3、付费会员

付费会员需完成 “支付 + 会员开通” 闭环,流程如下:

3.2.4、API导入

API 导入是商户系统通过接口单个录入会员信息的方式,适用于已有会员体系迁移场景:

3.3、用户动态

用于记录会员在非微信支付渠道下单的动态,可通过API调用:

 

3.4、用户会员卡状态流转图

以下2个状态为终态

  • 已过期

  • 已失效