PayPilot by AGMS_知识管理 skill-PHP中文网

PayPilot by AGMS

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过安全的支付网关代理处理支付、发送发票、办理退款、管理订阅并检测欺诈。当用户要求收取费用时使用

PayPilot——AI代理的支付处理

功能概述

PayPilot——AI代理的支付处理是一项面向实际任务的技能，主要用于接受付款、发发票、退款、追踪销售情况——全部通过对话进行；Setup.PayPilot在https://p上连接到一个托管的API代理。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

PayPilot — 面向 AI Agent 的支付处理服务

接收付款、开具发票、处理退款、追踪销售数据——全部通过对话完成。

初始化配置

PayPilot 连接到托管在 https://paypilot.agms.com 的 API 代理服务。首次使用时，请检查本地凭证文件：

cat ~/.config/paypilot/config.json

若配置文件不存在，则引导用户完成初始化流程：

curl -s "https://paypilot.agms.com/v1/auth/register" -X POST 
  -H "Content-Type: application/json" 
  -d '{"name":"BUSINESS_NAME","email":"EMAIL","password":"PASSWORD"}'

登录获取访问令牌（JWT）：

curl -s "https://paypilot.agms.com/v1/auth/login" -X POST 
  -H "Content-Type: application/json" 
  -d '{"email":"EMAIL","password":"PASSWORD"}'

配置支付网关密钥：

curl -s "https://paypilot.agms.com/v1/auth/configure" -X POST 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $TOKEN" 
  -d '{"gateway_key":"YOUR_GATEWAY_KEY"}'

保存凭证至本地：

mkdir -p ~/.config/paypilot
cat > ~/.config/paypilot/config.json << 'EOF'
{
  "api_url": "https://paypilot.agms.com",
  "email": "merchant@example.com",
  "token": "jwt_token_here"
}
EOF
chmod 600 ~/.config/paypilot/config.json

注意： 密码仅在注册与登录阶段用于获取 JWT，不会被写入配置文件，也不会从环境变量中读取。

若用户尚无支付网关账户，请启动入驻流程：

以对话方式收集基础信息：
- 企业名称
- 联系人姓名
- 邮箱地址
- 电话号码
- 业务类型（零售、餐饮、电商、移动应用等）
将该潜在客户信息保存至我方系统：

curl -s "https://paypilot.agms.com/v1/onboard" -X POST 
  -H "Content-Type: application/json" 
  -d '{"business_name":"Acme Corp","contact_name":"John Doe","email":"john@acme.com","phone":"555-1234","business_type":"retail"}'

向用户发送完整申请链接，供其在线填写并电子签名：

“很好！请通过以下链接完成申请：https://agms.com/get-started/ 整个过程约需 5–10 分钟。您需要准备企业地址、税务识别号（Tax ID）及银行账户信息。提交后可立即完成电子签名，通常将在 24–48 小时内获得审批结果。审批通过后，请返回此处，我将在数秒内为您启用支付处理功能。”

重要提示： Agent 绝不收集、存储或传输社会安全号码（SSN）、税务识别号（Tax ID）、银行账号/清算号（routing number）或其他敏感个人身份信息（PII）。所有此类信息仅可通过 AGMS 提供的安全表单提交。

身份认证

所有支付接口均需携带 JWT Bearer Token。请加载配置并设置请求头：

CONFIG=$(cat ~/.config/paypilot/config.json)
API=$(echo $CONFIG | jq -r '.api_url')
TOKEN=$(echo $CONFIG | jq -r '.token')
AUTH="Authorization: Bearer $TOKEN"

若请求返回 401 状态码，请重新登录并更新已保存的令牌。

刷新过期令牌的方法：提示用户输入密码——切勿存储该密码，也不得从环境变量中读取：

# 重新登录
LOGIN=$(curl -s "$API/v1/auth/login" -X POST 
  -H "Content-Type: application/json" 
  -d "{\"email\":\"$(echo $CONFIG | jq -r '.email')\",\"password\":\"$USER_PASSWORD\"}")
NEW_TOKEN=$(echo $LOGIN | jq -r '.access_token')

# 更新配置文件
TMP=$(mktemp)
chmod 600 "$TMP"
jq --arg t "$NEW_TOKEN" '.token = $t' ~/.config/paypilot/config.json > "$TMP" && mv "$TMP" ~/.config/paypilot/config.json
chmod 600 ~/.config/paypilot/config.json

核心命令

收款 / 交易

使用已存档的卡片令牌（vaulted card token）执行支付。 严禁处理原始银行卡号。

curl -s "$API/v1/payments/charge" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"amount":500.00,"token":"VAULT_ID","description":"Consulting — January"}'

对高金额或标记为可疑的交易启用 3D Secure 验证：

curl -s "$API/v1/payments/charge" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"amount":2500.00,"token":"VAULT_ID","description":"Premium service","three_d_secure":true}'

响应中包含风险评估与验证结果：

{
  "transaction_id": "123",
  "status": "complete",
  "amount": 2500,
  "risk": { "score": "low", "flags": [] },
  "verification": { "avs": "Y", "cvv": "M" },
  "three_d_secure": true
}

发送账单 / 支付链接

curl -s "$API/v1/payments/invoice" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"amount":500.00,"email":"john@example.com","description":"Consulting — January"}'

退款

# 全额退款
curl -s "$API/v1/payments/refund" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"transaction_id":"TXN_ID"}'

# 部分退款
curl -s "$API/v1/payments/refund" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"transaction_id":"TXN_ID","amount":50.00}'

作废（当日取消）

curl -s "$API/v1/payments/void" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"transaction_id":"TXN_ID"}'

查看交易记录

curl -s "$API/v1/transactions" -H "$AUTH" | jq .

销售汇总

curl -s "$API/v1/transactions/summary" -H "$AUTH" | jq .

客户卡库（安全地对银行卡进行令牌化）

安全存储银行卡信息——返回一个卡库令牌（vault token）。客户须通过安全表单输入卡片详情；原始卡片数据绝不会经由 Agent 处理。

curl -s "$API/v1/vault/add" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"first_name":"John","last_name":"Smith","email":"john@example.com"}'

对已存档卡片发起收款

curl -s "$API/v1/vault/charge" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"vault_id":"VAULT_ID","amount":99.00,"description":"Monthly service"}'

周期性计费（Recurring Billing）

# 创建订阅
curl -s "$API/v1/subscriptions" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"vault_id":"VAULT_ID","plan_id":"monthly_99","amount":99.00,"interval":"monthly"}'

# 取消订阅
curl -s "$API/v1/subscriptions/SUB_ID" -X DELETE -H "$AUTH"

欺诈检测与规则管理

# 查看最近 30 天的欺诈分析数据
curl -s "$API/v1/fraud/summary" -H "$AUTH" | jq .

# 列出当前启用的欺诈规则
curl -s "$API/v1/fraud/rules" -H "$AUTH" | jq .

# 创建一条欺诈规则（标记金额超过 $5000 的交易）
curl -s "$API/v1/fraud/rules" -X POST 
  -H "Content-Type: application/json" -H "$AUTH" 
  -d '{"rule_type":"max_amount","threshold":"5000","action":"flag"}'

# 支持的规则类型：max_amount、min_amount、velocity_limit  
# 支持的动作：flag（告警）、block（拒绝）、review（人工审核）

# 查看某条具体规则（如平台支持该操作）
curl -s "$API/v1/fraud/rules/RULE_ID" -H "$AUTH" | jq .

# 删除某条规则
curl -s "$API/v1/fraud/rules/RULE_ID" -X DELETE -H "$AUTH"

注意：不支持直接更新规则。如需修改，请先删除再重新创建。

创建规则后的响应示例：

{
  "rule_id": "rule_123",
  "rule_type": "max_amount",
  "threshold": "5000",
  "action": "flag",
  "status": "active",
  "created_at": "2026-03-15T00:00:00Z"
}

汇报欺诈统计数据时的示例表述：

“🛡️ 过去 30 天：共 45 笔交易，0 笔被标记，0 笔被拦截。当前启用 1 条规则（单笔上限 $5,000）。欺诈率：0.00%”

安全规范

严禁主动索取、记录或存储原始银行卡号
严禁将银行卡号写入对话历史或记忆文件
必须始终 使用支付链接或客户卡库令牌（vault token）执行收款
必须始终 使用 HTTPS 协议——代理服务强制启用 TLS 加密
API 令牌与网关密钥必须仅保留在配置文件中，不得出现在聊天内容中
代理服务会对静态存储的网关密钥进行 AES-256-GCM 加密
速率限制：全局 60 次请求/分钟；认证相关接口 5 次请求/分钟

错误处理

401 Unauthorized（未授权）：重新登录，更新已保存的令牌，然后重试。
400 Bad Request（错误请求）：校验请求体格式，并记录错误信息。
429 Rate Limited（请求超限）：全局限速 60 次/分钟，认证接口限速 5 次/分钟。应退避后重试。
5xx Server Error（服务器错误）：采用指数退避策略重试。
网络错误：验证 HTTPS 连通性后重试。

响应模板

当支付成功时：

“✅ 已处理 $500.00 的付款。交易 ID：abc123。”

当发送账单时：

“📧 已向 john@example.com 发送 $500.00 的支付链接。”

当支付失败时：

“❌ 付款被拒。是否尝试其他支付方式，或改发支付链接？”

当查询销售数据时：

“📊 本月：23 笔交易 · 销售额 $4,750 · 2 笔退款（$150）· 净收入 $4,600”

API 参考文档

详细网关 API 文档，请参阅 references/gateway-api.md。支付流程图，请参阅 references/payment-flows.md。 PCI 合规性指南，请参阅 references/pci-compliance.md。

能力发现

AI Agent 与 Bot 可自动发现 PayPilot 的各项能力：

OpenAPI 规范： https://paypilot.agms.com/openapi.json
AI 插件清单文件（AI Plugin Manifest）： https://paypilot.agms.com/.well-known/ai-plugin.json
大语言模型资源索引（LLM Resource Index）： https://paypilot.agms.com/llms.txt
产品落地页（Landing Page）： https://agms.com/paypilot/
ClawHub 页面： https://clawhub.ai/agmsyumet/paypilot-agms