---
name: payzu
description: Index das skills das APIs PayZu. Direciona pra Pix Processamento ou Conta Digital de acordo com o produto que o usuario esta integrando. Carregue uma das duas (nao as duas juntas).
---

# PayZu — Skills

PayZu tem **dois produtos com APIs separadas**. Carregue apenas a skill do
produto que voce esta integrando — misturar as duas confunde a IA com base
URLs e capacidades diferentes.

## Qual carregar?

### Pix Processamento

Use quando o cliente quer **alto volume de Pix puro** (marketplace, gateway,
payouts em massa, conciliacao automatica).

- Base URL: `https://api.payzu.processamento.com/v1`
- 29 endpoints
- Tem MED (infracoes), relatorios CSV async, callbacks API
- **NAO tem TED, NAO tem saque por dados bancarios**

**Skill**: https://docs.payzu.com.br/pix-processamento/SKILL.md

### Conta Digital

Use quando o cliente quer **conta bancaria via API completa** (Pix + TED +
transferencia interna, saldo, extrato).

- Base URL: `https://pix.payzu.io/v1`
- 13 endpoints
- Tem TED, saque por dados bancarios, transferencia interna
- **NAO tem MED defesa, NAO tem relatorios CSV async**

**Skill**: https://docs.payzu.com.br/conta-digital/SKILL.md

## Comparacao rapida

| Operacao | Pix Processamento | Conta Digital |
|---|---|---|
| Cobranca Pix (`POST /pix`) | ✓ | ✓ |
| Pagar QR (`POST /withdraw/qrcode`) | ✓ | ✓ |
| Saque chave Pix (`POST /withdraw`) | ✓ | ✓ |
| Saque dados bancarios (`POST /withdraw/bank-data`) | ✗ | ✓ |
| TED (`POST /ted`) | ✗ | ✓ |
| Transferencia interna (`POST /internal-transfer`) | ✓ | ✓ |
| Saldo + extrato (`GET /user/*`) | ✓ | ✓ |
| Relatorios CSV async | ✓ | ✗ |
| Defender infracao MED | ✓ | ✗ |

## Regras universais (valem pras duas APIs)

- Header: `Authorization: Bearer SEU_TOKEN`
- Header: `Content-Type: application/json`
- Valores em **reais decimais** (R$ 99,90 = `99.90`), nunca centavos
- `clientReference` unico e deterministico em criacoes
- `callbackUrl` HTTPS publico, responde 2xx em ate 5s
- Webhook retry: ate 72 tentativas com backoff
- Dedupe webhook por `id + status`
- Toda resposta de erro traz `requestId` — logue sempre
- Status: `PENDING -> COMPLETED | CANCELED | REFUNDED | EXPIRED`
- pixType: `cpf` | `cnpj` | `phone` (5511...) | `email` | `evp` (UUID)

## Recursos comuns

- Doc: https://docs.payzu.com.br
- Dashboard: https://abrirconta.payzu.com.br
- Status: https://status.payzu.com.br
- Suporte: https://suporte.payzu.com.br
- SDKs Pix: https://github.com/PayZuPlus/payzu-sdks
- Postman: https://dev.payzu.com.br

## Como carregar essa skill

**Claude Code**: salve em `~/.claude/skills/payzu/SKILL.md`
**Cursor**: cole em `.cursor/rules/payzu.mdc` ou `.cursorrules`
**Copilot**: cole em `.github/copilot-instructions.md`
**ChatGPT/Gemini**: cole no system prompt ou primeira mensagem

Depois carregue a skill especifica do produto que voce esta integrando.