# @profullstack/payagent 中文文档

规范地址：https://npmcn.com/package/%40profullstack/payagent/

版本：0\.8\.0
npm 元数据更新时间：2026-11-02T03:43:56.472Z
中文译文更新时间：2026-11-02T05:53:09.014Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40profullstack/payagent
原文对照：https://npmcn.com/package/%40profullstack/payagent/?lang=original
项目主页：https://pay.agent/
源码仓库：https://github.com/moshcoder/pay.agent

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：217 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：9 个
- 首次发布：2026-10-17T19:46:12.527Z
- 最新版本发布：2026-11-02T03:43:56.260Z
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

工资。代理：通过一个链接获得加密支付，Venmo为代理网络。使用CoinPay登录；支付任何人的处理从web， API， CLI， TUI或MCP。

## 安装

```sh
npm install @profullstack/payagent
```

也可以使用：`pnpm add @profullstack/payagent`、`yarn add @profullstack/payagent`、`bun add @profullstack/payagent`

## README

# pay.agent

通过一个链接获得加密支付。CoinPay上的代理网络Venmo。

登录CoinPay，选择一个名字，然后分享 `pay.agent/you`． 人员和代理人 用USDC、BTC、ETH、SOL等支付；它会进入你的CoinPay钱包或 你的CoinPay业务。工资。代理人从不持有资金。

-   **网络**： [https://pay.agent](https://pay.agent/) （Moshpit DNS）或 [https://pay.agent.pit.world](https://pay.agent.pit.world/)
-   **API**： `POST /api/v1/users/:handle/payments {"amount_usd": 5, "payer_email": "me@example.com"}` → `checkout_url`， CoinPay 在收款人自己的业务上托管结账：付款人选择收款人拿走的任何硬币，或者当他们连接PayPal时
-   **发票**： `POST /api/v1/invoices {"to_email", "description", "amount_usd", "recurrence": "monthly"}` (你的钥匙 CoinPay发票寄给你；CoinPay通过电子邮件发送支付链接并发送重复。 `payagent invoice pat@example.com 49 Logo`， MCP `send_invoice`． 每个网站都有一个公共页面 `pay.agent/i/<id>`.
-   **人则**:支付。代理的帖子 `payment.created`， `payment.paid`， `payment.expired`， `payment.failed`， `invoice.created`， `invoice.paid`， `invoice.overdue` 和 `invoice.cancelled` 链接到您的URL，如 每个云事件签名 [标准的人](https://www.standardwebhooks.com/) (通过 [@profullstack /人](https://github.com/profullstack/webhooks))，再试了大约三天。添加一个 `/me#webhooks`， `POST /api/v1/webhooks {"url", "events": ["payment.*"]}` (你的关键), `payagent webhook add <url>`， 或MCP `create_webhook`． 签名秘密用 `PAYAGENT_KEY`.
-   **Cli / tui**： `bunx @profullstack/payagent alice 5 --email=me@example.com`，或者 `bunx @profullstack/payagent`
-   **MCP**： `claude mcp add payagent -- bunx @profullstack/payagent mcp`
-   **代理，没有浏览器**： `COINPAY_EMAIL=… COINPAY_PASSWORD=… bunx @profullstack/payagent claim mybot` (或 `COINPAY_TOKEN`，或MCP `claim`)作为您登录CoinPay，批准支付。有那个会话的特工，声称 `pay.agent/mybot` 然后打印一个 `pa_` 关键。在任何时候再次运行它以获取新密钥。手工: `POST /api/v1/claim/start` →pkce绑定的授权请求； `POST <consent.endpoint>` 与 `authorization: Bearer <CoinPay session>` 和 `consent.body` → `{ redirect }`； `POST /api/v1/claim {"redirect", "handle"}` →你的链接和 `api_key`． 你的CoinPay凭证只会去CoinPay。
-   **硬币和卡片** （0.7.0）：一个新的链接也采取USDC的基础，多边形和索拉纳在一个地址的所有者 该链上已经有了（作为钱包添加的） `pay.agent/<handle>` 业务; `"stablecoins": false` 或在向导中取消选中，以跳过)。所有者选择链接的内容 `/me#takes`， `PUT /api/v1/me/coins {"coins": ["usdc_base", "sol", "paypal"] | "all"}`， `{"add_stablecoins": true}`， `payagent coins set|add-usdc|recheck`，或MCP `my_coins`;签出将pick传递为 `allowed_methods`. 一旦所有者将自己的PayPal REST应用程序连接到CoinPay上，卡就会通过PayPal的客人结账 业务(`/help#cards`); `card` 在提供它的第一次签出时，API中的属性变为true。没有条纹。

新员工培训是 [@profullstack / coinpay-onboard](https://github.com/profullstack/coinpay-onboard)： 一次通行证就可以完成CoinPay业务、支付钱包和webhook。相同的 发动机在每个舰队发射地点运行。

## 运行它

```sh
bun install
PAYAGENT_KEY=$(openssl rand -hex 32) PAYAGENT_COINPAY_CLIENT_ID=cp_… bun src/server.ts
```

设置: `PAYAGENT_KEY` 它不能打开任何人的CoinPay令牌：这些令牌是在每个登录密钥下密封的，只保存在内存中，所以没有切换的重启会暂停每个链接，直到它的所有者再次登录 `/me` + `GET /api/v1/me` 显示 `locked`)， `PAYAGENT_HANDOFF` （`off` 禁用部署切换套接字； `PAYAGENT_HANDOFF_SOCKET` 将它从 `~/.payagent-vault/handoff.sock`)， `LEGACY_KEY_MIGRATION` （`off` 停止迁移0.6之前的令牌副本； `sqlite3 pay-agent.db 'select count(*) from users where tokens is not null'` 计算剩下的)， `PAYAGENT_COINPAY_CLIENT_ID` / `_SECRET` (一个带有作用域的CoinPay OAuth客户端 `openid profile email wallet:read merchant`)， `PAYAGENT_DB` (SQLite路径), `PORT` (8796), `COINPAY_BASE`， `PAYAGENT_WEBHOOK_ORIGIN`.

部署: `bin/install.sh` （OpenInstall）上的盒子，金库 `profullstack/pay-agent--prod`. 自0.8.0以来，部署不再暂停每个付费链接： `bin/install.sh` 通过私有Unix套接字导出正在运行的进程的内存解锁(`scripts/vault-handoff.sh`（仅在shell变量中，而不是在磁盘中），在重新启动之前导入它们一次 `/health` 答案，保留每个原始到期（剩余一分钟以下被丢弃）。这日志 `Vault unlocks handed to the new process` 或者一个 `WARNING`.

麻省理工学院

## 常见问题

### @profullstack/payagent 是什么？

工资。代理：通过一个链接获得加密支付，Venmo为代理网络。使用CoinPay登录；支付任何人的处理从web， API， CLI， TUI或MCP。

### 如何安装 @profullstack/payagent？

在项目目录运行 npm install @profullstack/payagent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 payagent，可以用 npx payagent 直接运行。

### @profullstack/payagent 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/profullstack\_\_payagent 是否存在。

### @profullstack/payagent 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @profullstack/payagent 可以商用吗？

@profullstack/payagent 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @profullstack/payagent 还在维护吗？

最新版本 0\.8\.0 发布于 2026/11/02（1 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。