MCP server
MCP é o protocolo aberto que deixa assistentes de IA chamarem ferramentas externas via JSON-RPC. O payzu-mcp-conta-digital expõe 14 tools curadas da API Conta Digital (Pix in/out, TED, transferência interna, saldo, perfil, extrato).
Instalação
Claude Desktop
{
"mcpServers": {
"payzu-conta-digital": {
"command": "npx",
"args": ["-y", "payzu-mcp-conta-digital"],
"env": {
"PAYZU_TOKEN": "<seu-token>"
}
}
}
}Cursor
.cursor/mcp.json:
{
"mcpServers": {
"payzu-conta-digital": {
"command": "npx",
"args": ["-y", "payzu-mcp-conta-digital"],
"env": { "PAYZU_TOKEN": "..." }
}
}
}Configuração
| Env var | Obrigatório | Default | Descrição |
|---|---|---|---|
PAYZU_TOKEN | sim | , | Bearer token de abrirconta.payzu.com.br |
PAYZU_HUB_API_URL | não | https://pix.payzu.io/v1 | Base URL da Conta Digital |
Lista de tools (14)
Depósitos (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} |
Saques (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} |
Conta (4)
| Tool | HTTP |
|---|---|
account.balance | GET /user/balance |
account.profile | GET /user |
account.transactions | GET /user/transactions |
account.summary | GET /user/summary |
Convenções
- Amounts em REAIS decimais (
99.90, não9990). clientReferenceobrigatório em criações (idempotência).callbackUrlHTTPS público, responde 2xx em até 5s.- Auto-retry em 5xx/429 (3 tentativas, backoff exponencial + jitter).
- Erros incluem
requestId.
Conta Digital vs Pix Processamento
Use payzu-mcp-pix se você quer alto volume de Pix puro com MED, callbacks API, relatórios CSV. Use este pacote pra conta bancária completa (Pix + TED + transferência + extrato).
Suporte
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.