前言¶
接入微信支付委托代扣,通常要跨过几道门槛:先分清纯签约和支付中签约该走哪条链路,再补齐申请扣款、预扣费通知、解约、查询、退款、对账这些接口的细节,最后还要处理周期扣款和先享后付两种业务场景下的参数差异。接口文档分散、示例代码不全,落地时很容易在签约参数或回调处理上反复返工。
tencentcli-test 就是为了解决这个问题而存在的。下面介绍这个 Skill 的定位、能力和用法。
这是什么¶
tencentcli-test 是一个面向开发者的微信支付委托代扣接入解决方案 Skill,坐标 @user_8268720b/apply-8233,由社区开发者 user_8268720b 发布维护,当前版本 1.0.6,分类为 dev-programming。
它解决的问题是:在周期扣款 / 先享后付场景下,把委托代扣的全链路流程——纯签约、支付中签约、申请扣款、预扣费通知、解约、查询、退款、对账——整理成可直接调用的工程能力,并提供选型建议、示例代码、业务速查、质量评估、排障五类支持,减少接入过程中查文档和试错的成本。
需要说明的是,该 Skill 标记为 requires_api_key=true,使用时需要提供相应的 API Key。
核心功能¶
从官方简介看,tencentcli-test 覆盖的能力可以拆成两条线。
一条是业务流程线,覆盖委托代扣的完整链路:
- 纯签约:不发生实际支付的签约场景,适合先绑卡后扣款。
- 支付中签约:在支付过程中完成签约,适合下单即签约的场景。
- 申请扣款:按周期或按次发起扣款。
- 预扣费通知:扣款前的告知流程。
- 解约:用户取消委托关系。
- 查询:签约状态、扣款记录等查询能力。
- 退款:已扣款项的退回处理。
- 对账:与平台侧核对账务数据。
另一条是辅助能力线,提供五类支持:
- 选型:帮助判断当前业务该用哪种签约和扣款方式。
- 示例代码:给出可直接参考的接口调用代码。
- 业务速查:快速定位某个业务环节对应的接口和参数。
- 质量评估:对接入实现做质量层面的检查。
- 排障:针对委托代扣相关问题的排查支持。
触发方式上,当用户提到「委托代扣」「周期扣款」「周期扣费」「自动续费」「先享后付」「免密支付」「纯签约」「支付中签约」「预扣费通知」「申请扣款」,或者提出「接入委托代扣」「要委托代扣接口示例代码」「排查委托代扣问题」这类诉求时,就可以用这个 Skill。
安装与启用¶
官方页面:https://api.skillhub.cn/user_8268720b/apply-8233
SkillHub 页面:https://www.skillhub.cn/skills/user_8268720b/apply-8233
在已抓取的资料中,没有给出具体的安装命令或目录配置。该 Skill 基于通用 SKILL.md 格式,坐标为 @user_8268720b/apply-8233,发布者为社区开发者 user_8268720b。如需安装,建议直接通过上面的官方地址获取说明。
需要注意:该 Skill 标记 requires_api_key=true,启用前需准备好对应的 API Key,并确认微信支付侧的相关商户资质和接口权限已开通。
典型用法¶
下面列出的都是从官方简介中可以确认的诉求场景,具体命令和参数以官方资料为准。
接入委托代扣时,先确定业务属于周期扣款还是先享后付,再判断采用纯签约还是支付中签约,然后按链路调用对应接口:
- 纯签约:完成签约关系建立,不涉及即时支付。
- 支付中签约:在支付流程中同时完成签约。
- 申请扣款:签约关系建立后,按周期或按次发起扣款。
- 预扣费通知:在扣款前向用户发送通知。
- 解约:用户发起取消后解除签约关系。
- 查询:确认签约状态、扣款结果等。
- 退款:对已扣款项发起退回。
- 对账:与平台数据进行核对。
需要示例代码时,直接提出「要委托代扣接口示例代码」,Skill 会给出对应环节的参考代码。遇到问题时,提出「排查委托代扣问题」,走排障能力定位原因。
适用场景与注意¶
适合用在以下场景:
- 会员订阅、会员续费类的周期扣款业务。
- 先享后付类业务,需要绑定用户后续扣款关系。
- 需要完整覆盖签约到对账全链路的委托代扣接入项目。
- 已有委托代扣实现,需要做质量评估或排障的团队。
需要注意的地方:
- 该 Skill 来自社区发布者,属于 community 来源,不是官方出品。上线生产前建议自行核对接口参数和业务规则。
- 标记 requires_api_key=true,使用前需准备 API Key,并确认微信支付商户权限已开通。
- 委托代扣涉及资金和签约关系,解约、退款、对账环节要按实际业务规则实现,示例代码仅作参考。
- 当前版本 1.0.6,后续接口变更需关注 Skill 更新。
结尾¶
tencentcli-test 的价值在于把委托代扣的全链路流程和接入中常见的选型、排障问题打包成一个可直接调用的 Skill,减少查文档和试错的时间。如果你正在做周期扣款或先享后付类业务的接入,可以从官方地址开始了解。
官方地址:https://api.skillhub.cn/user_8268720b/apply-8233