微信境外支付接入
将以下提示词粘贴到你的 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` 时需区分域名白名单与权限配置的前端开发