MCP 服务器

npm payzu-mcp-conta-digital GitHub 仓库 SKILL.md（轻量替代方案）

MCP 是开放协议，让 AI 助手通过 JSON-RPC 调用外部工具。payzu-mcp-conta-digital 暴露了 Conta Digital API 的 14 个精选 tools（Pix in/out、TED、内部转账、余额、账户信息、流水）。

安装

Claude Desktop

{
  "mcpServers": {
    "payzu-conta-digital": {
      "command": "npx",
      "args": ["-y", "payzu-mcp-conta-digital"],
      "env": {
        "PAYZU_TOKEN": "<您的-token>"
      }
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "payzu-conta-digital": {
      "command": "npx",
      "args": ["-y", "payzu-mcp-conta-digital"],
      "env": { "PAYZU_TOKEN": "..." }
    }
  }
}

配置

环境变量	必填	默认值	说明
`PAYZU_TOKEN`	是	,	来自 abrirconta.payzu.com.br 的 Bearer token
`PAYZU_HUB_API_URL`	否	`https://pix.payzu.io/v1`	Conta Digital 的基础 URL

Tools 列表 (14)

存款 (4)

Tool	HTTP
`deposits.create_pix`	`POST /pix`
`deposits.get_pix`	`GET /pix/{id}`
`deposits.proof`	`GET /proof/{id}`
`deposits.refund`	`POST /pix/refund/{id}`

提现 (6)

Tool	HTTP
`withdraw.by_pix_key`	`POST /withdraw`
`withdraw.by_bank_data`	`POST /withdraw/bank-data`
`withdraw.ted`	`POST /ted`
`withdraw.by_qr`	`POST /withdraw/qrcode`
`withdraw.internal_transfer`	`POST /internal-transfer`
`withdraw.proof`	`GET /proof/{id}`

账户 (4)

Tool	HTTP
`account.balance`	`GET /user/balance`
`account.profile`	`GET /user`
`account.transactions`	`GET /user/transactions`
`account.summary`	`GET /user/summary`

约定

金额采用十进制雷亚尔 (99.90，而非 9990)。
创建操作必须传 clientReference（idempotência）。
callbackUrl 需为 HTTPS 公网地址，5 秒内响应 2xx。
5xx/429 自动重试（3 次，指数退避 + jitter）。
错误响应包含 requestId。

Conta Digital 与 Pix Processamento 对比

如果您需要高吞吐量的纯 Pix 配合 MED、API callbacks、CSV 报表，请使用 payzu-mcp-pix。如果您需要完整的银行账户（Pix + TED + 转账 + 流水），请使用本包。

支持

报告 bug 完整文档 PayZu 支持

MCP 服务器

On this page