# Pixzy

> Documentação oficial da API do Pixzy — processe pagamentos e saques via PIX de forma simples, eficiente e automatizada. Base URL: https://app.pixzypay.com/api. Todos os valores monetários são em centavos (R$ 10,00 = 1000).

## Começando

- [Introdução](https://docs.pixzypay.com/index.md): Visão geral da API, base URL, formato e moeda.
- [Autenticação](https://docs.pixzypay.com/autenticacao.md): Bearer Token no cabeçalho Authorization; como gerar e proteger tokens.
- [Códigos de Erro](https://docs.pixzypay.com/codigos-de-erro.md): Códigos HTTP padrão e formatos de erro (genérico e validação 422).
- [Rate Limiting](https://docs.pixzypay.com/rate-limiting.md): Limites de requisição por token e por IP; tratamento de 429 e Retry-After.

## Endpoints

- [Minha Conta](https://docs.pixzypay.com/endpoints/minha-conta.md): GET /api/account — dados da conta e saldo disponível em centavos.
- [Criar Transação](https://docs.pixzypay.com/endpoints/criar-transacao.md): POST /api/transactions — cria uma cobrança PIX dinâmica e retorna o br_code.
- [Consultar Transação](https://docs.pixzypay.com/endpoints/consultar-transacao.md): GET /api/transactions/{id} — detalhes por UUID ou external_id.
- [Criar Saque](https://docs.pixzypay.com/endpoints/criar-saque.md): POST /api/withdrawals — solicita um saque via PIX deduzido do saldo.

## Webhooks

- [Webhook de Transação](https://docs.pixzypay.com/webhooks/transacao.md): Eventos paid, expired e failed enviados para a webhook_url da transação.
- [Webhook de Saque](https://docs.pixzypay.com/webhooks/saque.md): Eventos approved e rejected enviados para a webhook_url do saque.
- [Webhook de Integração](https://docs.pixzypay.com/webhooks/integracao.md): Payload completo (transação, cliente, produtos, UTMs) com retry até 3x.

## Extras

- [MCP (Model Context Protocol)](https://docs.pixzypay.com/extras/mcp.md): Servidor MCP da documentação gerado pela Mintlify para agentes de IA.