核心用法
本技能指导开发者在 Web 和 Android 平台实现 Google Pay 支付集成，涵盖从架构决策到生产部署的全流程。
主要功能模块：
- 架构设计：支持 Web（Google Pay API + 网关 tokenization）和 Android（应用内 Google Pay API）两条路径
- Tokenization 模式：明确区分
PAYMENT_GATEWAY（推荐）与DIRECT（需 PCI 合规）两种模式 - 安全实施：强制服务端验证金额、禁止客户端信任、敏感 token 零持久化
- 验证矩阵：覆盖成功、失败、取消、超时等全场景测试
- 事故响应：内置失败处理手册与根因追踪模板
关键操作约束：
- 必须确认
GOOGLE_PAY_MERCHANT_ID环境变量 - 金额与币种必须在客户端请求、服务端订单、PSP 授权三层保持一致
- 所有关键支付调用（授权、捕获、退款）必须实现幂等性
- 生产发布前必须通过完整设备/浏览器矩阵测试
显著优点
1. 安全设计优先：强制服务端金额验证、token 最小化处理、零敏感数据日志留存
2. 生产就绪：包含完整的发布门控、回退方案、监控告警配置指南
3. 双平台覆盖：统一技能支持 Web Chrome 与 Android Native 两种主流场景
4. 合规导向：明确 PCI 边界，指导开发者选择适当的 tokenization 模式
5. 事故可追踪：结构化 memory 系统记录决策、验证与事故历史
潜在缺点与局限性
- 依赖外部信任：核心支付流程依赖 Google 基础设施与选定 PSP，无自托管选项
- 环境配置复杂：需同时管理 Google Pay 商户控制台、PSP 账户、多环境 origin 配置
- 地域限制：Google Pay 可用性与 PSP 支持存在国家/地区差异
- 无内置测试卡：需依赖 Google 官方测试环境，本地 mock 能力有限
- Android/Web 路径分离：同一项目混合双平台需明确的迁移计划，非自动兼容
适合人群
- 电商/订阅服务开发者：需要快速接入高转化率钱包支付
- Android 应用团队：寻求原生支付体验优化
- 支付架构师：负责网关选型、tokenization 策略与 PCI 范围界定
- 运维工程师：需要建立支付失败监控与事故响应流程
常规风险
| 风险场景 | 后果 | 缓解措施 |
|---------|------|---------|
| 测试配置误发生产 | 真实用户支付失败 | 强制环境隔离与发布门控检查 |
| 网关商户 ID 环境不匹配 | Token 处理错误 | 实施前 prerequisite 清单验证 |
| 跳过 `isReadyToPay` 检测 | 钱包按钮异常/空白 | 强制能力检测前置 |
| 信任客户端金额 | 授权金额与订单不符 | 服务端金额最终校验规则 |
| 重试缺失幂等键 | 重复扣款 | 所有支付调用强制 idempotency |
| 无 fallback checkout | 钱包不可用时转化流失 | 发布前强制备用支付路径验证 |