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

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

  1. 注册 PayPilot 代理服务:
curl -s "https://paypilot.agms.com/v1/auth/register" -X POST 
  -H "Content-Type: application/json" 
  -d '{"name":"BUSINESS_NAME","email":"EMAIL","password":"PASSWORD"}'
  1. 登录 获取访问令牌(JWT):
curl -s "https://paypilot.agms.com/v1/auth/login" -X POST 
  -H "Content-Type: application/json" 
  -d '{"email":"EMAIL","password":"PASSWORD"}'
  1. 配置 支付网关密钥:
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"}'
  1. 保存 凭证至本地:
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,不会被写入配置文件,也不会从环境变量中读取。

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

  1. 以对话方式收集基础信息:

    • 企业名称
    • 联系人姓名
    • 邮箱地址
    • 电话号码
    • 业务类型(零售、餐饮、电商、移动应用等)
  2. 将该潜在客户信息保存至我方系统:

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"}'
  1. 向用户发送完整申请链接,供其在线填写并电子签名:

“很好!请通过以下链接完成申请: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

相关专题

更多
DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

XORM框架零基础入门教程
XORM框架零基础入门教程

本专题梳理XORM框架的入门路径,从框架定位、依赖安装、连接数据库到跑通第一个增删改查示例,讲清Engine初始化、日志开启与项目目录规划,并对比GORM等同类ORM的差异,帮助Go开发者建立整体认知。

2026.11.04

0

15

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

2026.11.03

0

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习