核心用法
PayPilot 是一个专为 AI 代理设计的支付处理中间件，通过 https://paypilot.agms.com 代理连接主流支付网关。核心功能涵盖六大模块：
1. 支付处理：支持信用卡扣款（通过 vault token，绝不接触原始卡号）、3D Secure 验证、AVS/CVV 风控校验
2. 账单与收款：生成支付链接、发送邮件发票、查看交易流水与销售汇总
3. 退款管理：支持全额退款、部分退款及当日撤销（void）
4. 订阅计费：创建/取消周期性扣款计划，基于 vault 令牌自动续费
5. 欺诈防控：30天欺诈分析、自定义规则（金额阈值、频率限制）、实时风险评分
6. 商户入驻：引导新用户完成 AGMS 网关开户，代理仅收集基础信息，敏感数据（SSN、税号、银行信息）通过安全表单独立完成
首次使用需完成 JWT 认证流程：注册 → 登录获取 token → 配置网关密钥 → 本地保存配置（~/.config/paypilot/config.json，权限 600）。所有 API 调用均需 Bearer Token，支持自动刷新。
显著优点
- 安全架构：原始信用卡号永不进入对话或代理内存，强制使用 token 化机制；网关密钥 AES-256-GCM 加密存储；TLS 强制传输
- 合规友好：明确禁止代理收集敏感 PII，PCI 敏感字段通过独立安全表单处理，降低合规负担
- 功能完整：覆盖支付全生命周期（收单、开票、退款、订阅、风控），支持 3D Secure 等高阶风控
- 开发者体验：提供 OpenAPI 规范、AI Plugin Manifest、LLM Resource Index，支持自动发现；命令行友好，返回 JSON 便于
jq处理 - 透明可控：欺诈规则可自定义（flag/block/review），销售数据实时可查，错误码清晰
潜在缺点与局限性
- 依赖外部网关：实际支付能力依赖 AGMS 网关账户，新用户需 24-48 小时审批周期
- 规则管理受限：欺诈规则不支持更新，需删除重建；部分高级风控功能可能受网关能力限制
- 网络与速率限制：全球 60 req/min、认证端点 5 req/min 的限制可能影响高频场景；依赖 HTTPS 连接稳定性
- 凭证管理责任：JWT 和网关密钥需用户妥善保管，配置泄露可能导致未授权交易
- 无内置对账：需自行调用 API 汇总交易，无自动对账或财务报告导出功能
适合人群
- 中小商户、SaaS 创始人、自由职业者：需快速接入支付，无技术团队维护 PCI 合规基础设施
- AI 助手/自动化工作流开发者：希望通过自然语言指令完成收款、开票、退款等操作
- 订阅制业务运营者：需要自动化周期性计费与失败重试机制
- 风控意识强的商家：希望自定义欺诈规则、实时监控交易风险
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 凭证泄露 | JWT 或网关密钥被盗用 | 配置文件权限 600、定期轮换、不在对话中暴露 |
| 中间人攻击 | 网络层劫持 | 强制 TLS、验证证书、不信任自签名证书 |
| 欺诈误杀/漏判 | 规则配置不当影响收入或损失 | 渐进式调整阈值、监控 flag 率、结合人工复核 |
| 供应商锁定 | 深度绑定 AGMS 网关 | 保留网关密钥迁移能力、定期导出交易数据 |
| 合规连带责任 | 代理配置不当导致 PCI 审计问题 | 严格遵守"不接触原始卡号"原则、定期审计配置 |