# 【接入指引】微信小程序：会员订阅

# 【产品介绍】

# 1.  核心能力

● 一次订阅，多次扣费：仅需和用户完成一次签约，后续可持续按周期发起扣费，完成周期会员续费。

● 会员订阅消息：对于有订阅关系的用户，微信开放平台会新增「会员专属」长期订阅消息；详见：会员订阅消息接入指引

*仅支持安卓设备调用

# 2.  用户交互示意

# 3.  接入模式说明

a. 用户首次签约、即扣费

用户签约后，可在签约开始的12个小时内直接发起扣费，首次扣费无需向用户发起预扣费通知

b. 用户首次签约时，不扣款

用户先免费试用，后续再发起扣费，每次扣款、均需在t-2日向用户发送预扣费通知

# 4.  扣费说明

扣费 - 首次（用户签约12小时内）：

扣费 - 非首次（用户签约12小时以外）

预扣费：

# 5.  结算周期、费率

当前开放三种周期的会员：

虚拟支付，技术服务费率：

# 6.  准入标准

● 已接入小程序虚拟支付

● 小程序首次发布时间至今 >= 90天

● 小程序完成认证备案

● 近30天日均dau >= 1万

# 【对接开发】

# 接入流程

# 申请开通、配置模版

收件人：wx_virtualpayment@tencent.com

流程	对接方式	前置流程	邮件主题	邮件正文	邮件说明
开通权限授权 （小程序维度）	邮件	已和小程序产品团队确认接入意愿	申请开通小程序会员订阅 - 小程序昵称 - 申请日期	小程序昵称： 小程序appid： 虚拟支付商户号： 小程序主体： 小程序类目： 业务模式：主营业务，小程序dau，交易金额 申请用途： 会员相关产品页面交互：（开通、续费、管理流程，图片jpg、png格式，文件大小不超过2MB）	注意事项： ● 不允许使用拍照图片 ● 需把完整的交互都放在一张图片里 ● 购买记录页面需要出现客服电话，且客服电话需要完成认证 认证方式 交互示意：
申请代扣模版 （道具维度）		已收到开通权限授权成功邮件 （预计需3个工作日）	申请配置代扣模版 - 小程序昵称 - 申请日期	小程序昵称： 小程序appid： 虚拟支付商户号： 小程序主体： 小程序类目： 扣费周期： 会员价格（原价）： 产品介绍说明url：官方网站，需支持访问 产品价目表：图片jpg、png格式，文件大小不超过2MB 扣费产品介绍：用户操作主路径，会员开通、续费、管理流程，图片jpg、png格式，文件大小不超过2MB	注意事项： ● 每一个模版，需单独说明以下内容 ● 价目表需和交互示意搭配，说明优惠价格、原价 价目表示意： 短剧、小说周会员<=25，双周、月<=50，其他行业无此限制
道具、模版管理 （道具维度）		已收到代扣模版配置成功邮件，获取模版ID （预计需3个工作日） 已通过api创建会员订阅道具	申请代扣模版、会员道具关联 - 小程序昵称 - 申请日期	小程序昵称： 小程序appid： 虚拟支付商户号： 小程序主体： 小程序类目： 代扣模版ID： 会员道具ID：	道具、模版一一对应； 道具价格 = 会员原价； 道具周期 = 会员周期

# 接口调用

# 支付签名

签名算法伪代码为：

paySig = to_hex(hmac_sha256(appKey,uri + '&' + signData))

# 用户签约wx.requestSubscribeSign

注：该接口返回值不能作为签约成功的判定标准，需以签约结果通知/签约查询为准

signData 参数

返回参数

# 配置订阅道具 start_upload_goods

说明

该接口为异步接口，上传后请用query_upload_goods确认

多个道具请分批次上传，一次上传一个

地址

https://api.weixin.qq.com/xpay/start_upload_goods?access_token=xxx&pay_sig=xxx

请求参数

upload_item的每一项内容如下：

返回参数

# 发布订阅道具 start_publish_goods

说明

该接口为异步接口，发布后请用 query_publish_goods 确认

发布操作格式易错，正确格式参考：{"env":0,"publish_item":[{"id":"100001"},{"id":"100002"},{"id":"100003"}]}

地址

https://api.weixin.qq.com/xpay/start_publish_goods?access_token=xxx&pay_sig=xxx

请求参数

publish_item的每一项内容如下：

返回参数

# 商家解约 cancel_subscribe_contract

地址：https://api.weixin.qq.com/xpay/cancel_subscribe_contract?access_token=xxx&pay_sig=xxx

返回值：

# 查询签约关系 query_subscribe_contract

地址：https://api.weixin.qq.com/xpay/query_subscribe_contract?access_token=xxx&pay_sig=xxx

返回值：

# 预通知扣款 send_subscribe_pre_payment

地址：https://api.weixin.qq.com/xpay/send_subscribe_pre_payment?access_token=xxx&pay_sig=xxx

错误码：

# 发起订阅扣款 submit_subscribe_pay_order

受理后扣款，返回成功仅代表受理成功，不代表扣款成功。扣款成功后再通过xpay_goods_deliver_notify通知

如受理成功后，通知/查询到扣款失败，可在【t日～t+6日】发起重试，同一用户、同一道具，一个小时内仅可以重试一次。

地址：https://api.weixin.qq.com/xpay/submit_subscribe_pay_order?access_token=xxx&pay_sig=xxx

请求参数

返回参数

错误码

# 查询扣款订单 query_order

地址

https://api.weixin.qq.com/xpay/query_order?access_token=xxx&pay_sig=xxx

请求参数

返回参数

其中order的内容如下：

# 申请退款 refund_order

说明

对使用jsapi接口下的单进行退款，此接口只是启动退款任务成功，启动后需要调用query_order接口来查询退款单状态，等状态变成退款完成后即为最终成功

地址

https://api.weixin.qq.com/xpay/refund_order?access_token=xxx&pay_sig=xxx

请求参数

返回参数

# 签约、解约结果通知 xpay_subscribe_signing_result_notify

说明：

1.  建议通过 query_subscribe_contract 接口查询订单兜底

2.  按正确格式回复该通知

请求参数

基础字段

特殊字段

返回参数

返回格式参考消息推送文档：消息推送 | 微信开放文档

XML 示例：

"\

0\ success\

"

# 扣款失败结果通知 xpay_subscribe_pay_fail_notify

注：

1.  建议通过 query_order 接口查询订单兜底，状态为 13 则为扣款失败

2.  按正确格式回复该通知

请求参数

基础字段

特殊字段

WeChatPayInfo内容

GoodsInfo内容

返回参数

返回格式参考消息推送文档：消息推送 | 微信开放文档

XML 示例：

"\

0\ success\

"

# 扣款成功通知 xpay_goods_deliver_notify

请求参数

WeChatPayInfo内容如下：

GoodsInfo内容如下：

TeamInfo内容如下：

返回参数

# 【运营规范】

为响应工业和信息化部相关通知，增强用户在签约流程中的感知及交易保障，保障用户账户权益，维护良好的信息消费环境，现微信开放平台针对小程序自动续费订阅会员能力的使用，推进以下的运营相关规范：

# 用户签约前

1.  开发者申请自动续费订阅会员能力时，必须明确在服务详情中说明优惠结束后，每个周期扣款的原始金额为多少元，不得用小字、不得做模糊描述处理，须用户明确感知。

2.  自动续费订阅会员能力为开发者提供自定义扣款金额能力，但是扣款金额不得超过申请委托代扣模板的上限，不得低于平台规定的最低下限。

3.  申请自动续费订阅会员能力时，为保障用户权益，开发者需缴纳相应金额的交易保证金，保证金按照《小程序交易保证金管理规定》进行管理

4.  开发者申请自动续费订阅会员能力时，必须提供《会员自动续费服务协议》供平台审核，平台将合理判断是否有滥用能力、侵犯消费者合法权益等行为，审核通过后方可开放自动续费订阅会员能力。

a.  须在《会员自动续费服务协议》中明确展示订阅会员服务所包含的内容、服务周期、计费周期以及其他法律要求的等内容。

b.  须在《会员自动续费服务协议》中明确展示自动续费服务的退订方式。明确指引iOS用户、安卓用户在不同的支付平台的退订路径，该流程不得只在常见问题等类似界面展示。

c.  建议在《会员自动续费服务协议》中明确展示关于补扣款的条款内容，因为在扣费日期有可能因为网络、用户账户问题或余额不足导致不能正常扣费续费，在用户未主动明确取消服务前，平台将根据此前开发者与用户达成的委托在扣费日期继续发出续费代扣指令，一旦扣款成功，小程序将继续为用户开通下一个计费周期的连续服务。但由于用户对于补充扣费过程无感知，通常会带来用户投诉问题。因此建议开发者在用户服务协议中明确补扣款的条款内容，确保用户在阅读和签署协议时有接收到醒目的提示。

# 用户签约中

1.  在用户支付场景时，小程序需要提供单次付费的商品，不得只提供自动续费商品，并强制用户绑定使用。

2.  用户在发起自动续费订阅会员能力签约时，须明确感知到当前的订阅优惠金额、未来续费金额、订阅周期以及订阅包含的服务

3.  在用户首次支付时醒目展示下一次周期的扣款时间。建议开发者在会员产品相关页面，加粗或高亮展示下一次服务周期的扣款时间。尤其在首次会员价格有设置营销策略时，通常第一个服务周期非常规周期。不可使用“到期前”“次月”等模糊字眼，不建议用灰色小字体表达。建议明确展示下个周期履约的第一天的具体日期，使小程序用户清晰接收到下一个扣款时间信息

4.  用户在发起自动续费订阅会员能力签约时，小程序需要提供《会员自动续费服务协议》勾选操作，且不得做默认勾选。醒目展示《会员自动续费服务协议》，并强化提醒用户主动勾选。建议开发者高亮展示《会员自动续费服务协议》文案，更好的做法是二次弹窗强化展示，让用户做二次确认。可以降低用户对于“被动签署协议、不明所以就签署了协议”的负向体验和解约诉求。

5.  小程序内的委托代扣商品前端展示时必须有自动续费订阅会员扣款模式的明显描述，如连续包周、连续包月等。

# 用户签约后

1.  开发者针对用户的营销策略必须在用户签约时确认，用户确认后商家不得在签约后擅自修改已签约的优惠以及原本金额。服务内容变更需提前7日公示，重要变更需用户再次确认

2.  根据法律法规要求，自动续费服务在发起正式周期扣款之前必须通过有效手段提前 5 日提醒用户，包括不限于短信、邮件、消息推送等方式。基于用户体验，平台提供了预扣费通知能力，在小程序自动续费前2天将通知用户，且服务通知中说明的扣费金额必须与实际扣款金额相符。

3.  小程序内需要为用户提供客服服务如微信客服、在线IM客服，400电话等，以便用户能够直接联系到小程序开发者并进行相关的使用问题咨询与处理。

4.  如因开发者经营原因，出现周期代扣能力相关的客诉和资金风险等问题，或平台合理判断有滥用能力、侵犯消费者合法权益等情形，平台将进行相应治理处罚，包括但不限于限制小程序发版、回收周期代扣能力、限制结算和限制支付能力、下架小程序等。

5.  开发者须要支持在小程序内的订阅会员退款，应存在简洁清晰的用户退款界面和退款路径

6.  开发者收到投诉后须在24小时内处理投诉以及协商退款事宜，若在24小时内未处理，平台将主动介入处理客诉

7.  开发者应做好未成年消费引导，避免出现未成年人冲动/大额消费等问题，未成年人交易退款依照未成年人退款流程处理

8.  需在小程序内展示自动续费服务的退订解约方式。明确指引iOS用户、安卓用户在不同的支付平台的退订路径，该流程不得只在常见问题等类似界面展示；安卓端微信内退订路径：打开微信 - 我 - 服务 - 钱包 - 支付设置 - 自动续费 - 关闭相关小程序自动续费