MCP server
MCP is the open protocol that lets AI assistants call external tools via JSON-RPC. The payzu-mcp-conta-digital exposes 14 curated tools from the Conta Digital API (Pix in/out, TED, internal transfer, balance, profile, statement).
Installation
Claude Desktop
{
"mcpServers": {
"payzu-conta-digital": {
"command": "npx",
"args": ["-y", "payzu-mcp-conta-digital"],
"env": {
"PAYZU_TOKEN": "<your-token>"
}
}
}
}Cursor
.cursor/mcp.json:
{
"mcpServers": {
"payzu-conta-digital": {
"command": "npx",
"args": ["-y", "payzu-mcp-conta-digital"],
"env": { "PAYZU_TOKEN": "..." }
}
}
}Configuration
| Env var | Required | Default | Description |
|---|---|---|---|
PAYZU_TOKEN | yes | , | Bearer token from abrirconta.payzu.com.br |
PAYZU_HUB_API_URL | no | https://pix.payzu.io/v1 | Conta Digital base URL |
Tools list (14)
Deposits (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} |
Withdrawals (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} |
Account (4)
| Tool | HTTP |
|---|---|
account.balance | GET /user/balance |
account.profile | GET /user |
account.transactions | GET /user/transactions |
account.summary | GET /user/summary |
Conventions
- Amounts in decimal REAIS (
99.90, not9990). clientReferencerequired on creations (idempotência).callbackUrlpublic HTTPS, responds 2xx within 5s.- Auto-retry on 5xx/429 (3 attempts, exponential backoff + jitter).
- Errors include
requestId.
Conta Digital vs Pix Processamento
Use payzu-mcp-pix if you want high-volume pure Pix with MED, API callbacks, CSV reports. Use this package for a complete bank account (Pix + TED + transfer + statement).
Support
Glossário
Status de transação, tipos de chave Pix, infrações (MED), tipos e campos comuns da API Conta Digital.
Para IAs (LLMs)
Toda a documentação da Conta Digital PayZu disponível em formato consumível por modelos de linguagem. Copie o conteúdo direto, baixe o dump completo, ou use as URLs específicas por página. Funciona com ChatGPT, Claude, Gemini, Cursor, Copilot, etc.