Magen
A Magen é a API que você usa quando precisa receber e enviar Pix em volume. Desenhada para alto throughput, atende marketplaces, gateways de pagamento, plataformas de cashback, payouts B2B e qualquer aplicação que precise mover Pix programaticamente.
Por onde começar
| Se você é | Comece por |
|---|---|
| Primeira integração | Primeiros passos → Receber Pix |
| Indo direto à referência | Endpoints da API |
| Precisa entender callbacks | Webhooks |
| Preparando para produção | Boas práticas → Checklist |
| Recebeu uma disputa Pix | MED → Infrações tutorial |
O que a API cobre
| Grupo | Endpoints | Uso típico |
|---|---|---|
| Cobranças Pix | 4 | Receber pagamentos via QR Code dinâmico. |
| Saques | 6 | Pagar fornecedor, payout de marketplace. |
| Transferência interna | 2 | Mover saldo entre contas Magen, instantâneo. |
| Conta | 2 | Validar token, consultar saldo. |
| Relatórios | 6 | Listar transações, gerar CSV assíncrono. |
| Callbacks | 4 | Inspecionar e reenviar webhooks. |
| Infrações (MED) | 5 | Lidar com disputas Pix do Bacen. |
Características
| Aspecto | Valor |
|---|---|
| Endpoints | 29 agrupados em 7 áreas |
| Autenticação | Bearer token |
| Content-Type | application/json (obrigatório) |
| Valores | Em reais (BRL), nunca centavos |
| Webhooks | Retry exponencial até 72 tentativas |
| Linguagens cobertas | curl, Node.js, Python, Go, PHP |
| Disponibilidade | 24/7, processamento Pix em segundos |
Ambiente
| Item | Valor |
|---|---|
| Base URL | https://api.magen.processamento.com/v1 |
| Status | status.magen.com.br |