微信支付对账自动化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-2ulb7xpt/wechatpay-recon-ops-v2
技能介绍
对账为什么需要自动化
微信支付对账至少要核对两维度:交易对账需按 out_trade_no 匹配微信交易账单与商户订单,检查金额、状态一致性;资金对账要确认实际入账金额与应收是否匹配。人工处理时,单边账(微信有交易但商户无记录)、状态异常(微信成功但商户显示失败)、金额差异等问题需要逐笔排查,退款后的会员解绑也容易遗漏。
技能核心能力
- 双维度对账引擎:拉取微信交易/资金账单 → 解析 → 按
out_trade_no精确匹配交易,核对资金入账与应收,自动标记异常类型。 - 退款与会员解绑联动:发起退款后同步状态,退款成功触发会员解绑,支持到期自动扫描清理,同步微信侧解约回调。
- 付费触发机制:通过 HTTP 商户服务(
scripts/pay_server.py)实现,首次请求返回402,支付完成后携带WeixinPay-Required和X-Out-Trade-No重试获取报告,同一out_trade_no幂等履约。
适用边界与注意点
- 演示模式(
mode=demo)使用内置数据,无需配置商户凭证;真实模式(mode=real)需临时传入终端商户的mchid/appid等参数,建议由 SaaS 后台统一管理。 - 金额单位需注意:微信 V3 接口统一为「分」,演示数据为「元」,转换时避免误差。
- 合规红线:平台不触碰资金,直连商户模式下回调必须验签,禁止二清或资金归集。
使用场景
- 支付SaaS运营每日核对微信交易账单与商户订单是否一致
- 商户需自动标记单边账、状态异常和资金差异
- 退款成功后需联动解绑会员并同步微信侧状态
- 对账异常时需生成结构化报告供财务排查
适合人员
- 支付SaaS后端工程师需集成微信支付对账能力
- 财务运营需自动核对交易与资金账单差异
- 会员系统开发者需退款后触发解绑逻辑
- 技术运维需监控对账服务的幂等与稳定性