Agent Skills
返回列表
微信境外支付接入

微信境外支付接入

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/wechatpay-global-payment。

技能介绍

你在对接哪类问题

境外微信支付与境内 API 域名、路径和产品形态并不相同:机构模式下要理清 sp_mchid / sub_mchid、子商户路由、多币种入账与回调幂等;选型阶段还要区分七大支付产品与静态码、订阅扣款等场景。文档分散在全球版站点,版本差异(V2 vs V3)和网络部署(IP 白名单、加速点)也容易在联调前被低估。

技能如何组织回答

启动后技能以微信支付境外业务专家人设工作,并先加载跨境支付通用知识,再按路由表把问题归到模块:产品选型、接入指南(开发参数、签名验签、回调、查单、网络、API 版本对比、质量检查)、接口索引与排障手册。多语言输入会先按术语表归一为中文检索,再用用户语言输出;字段名、域名、路径与错误码保持原样不翻译。需要调用示例时,技能不会自行生成签名或加解密代码,而是引导你到官方接口索引中的 Java / PHP / Go 示例。

适用边界

  • 仅覆盖境外全球版(如 apihk.mch.weixin.qq.com、/v3/global/);境内小店、医保等应改用境内支付相关技能。
  • 文档与链接以 pay.weixin.qq.com/doc/global/v3/ 为准;叙述默认机构视角(除中国香港外,多数地区须通过机构接入)。
  • 一次多个未明确参数的问题会逐项确认,排障结束后会建议对照接入质量检查清单。

使用场景

  • 机构平台联调全球版统一下单时,核对 `sub_mchid` 路由、签名验签与调起支付参数是否一致
  • 业务选型阶段对照七大支付产品,判断静态码、订阅扣款等场景该走哪条接入链路
  • 生产环境 `notify_url` 收不到或解密失败,按排障手册排查回调幂等与多币种入账逻辑
  • 订单长期处于 USERPAYING,需要设计查单轮询、超时兜底与订单闭环策略

适合人员

  • 在支付机构侧负责全球版 API(`/v3/global/`)对接与联调的后端工程师
  • 需要为海外子商户梳理进件、`sub_appid` 与 `openid` 等开发参数的支付平台产品
  • 上线前按接入质量检查验收多币种回调、幂等与签名加解密的支付 QA
  • H5 或小程序联调出现 `chooseWXPay:fail` 时需区分域名白名单与权限配置的前端开发