通过安全的支付网关代理处理支付、发送发票、办理退款、管理订阅并检测欺诈。当用户要求收取费用时使用
PayPilot——AI代理的支付处理是一项面向实际任务的技能,主要用于接受付款、发发票、退款、追踪销售情况——全部通过对话进行;Setup.PayPilot在https://p上连接到一个托管的API代理。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
接收付款、开具发票、处理退款、追踪销售数据——全部通过对话完成。
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"}'
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"}'
# 创建订阅
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%”
当支付成功时:
“✅ 已处理 $500.00 的付款。交易 ID:abc123。”
当发送账单时:
“📧 已向 john@example.com 发送 $500.00 的支付链接。”
当支付失败时:
“❌ 付款被拒。是否尝试其他支付方式,或改发支付链接?”
当查询销售数据时:
“📊 本月:23 笔交易 · 销售额 $4,750 · 2 笔退款($150)· 净收入 $4,600”
详细网关 API 文档,请参阅 references/gateway-api.md。
支付流程图,请参阅 references/payment-flows.md。
PCI 合规性指南,请参阅 references/pci-compliance.md。
AI Agent 与 Bot 可自动发现 PayPilot 的各项能力:
https://paypilot.agms.com/openapi.jsonhttps://paypilot.agms.com/.well-known/ai-plugin.jsonhttps://paypilot.agms.com/llms.txthttps://agms.com/paypilot/https://clawhub.ai/agmsyumet/paypilot-agms相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章