pagodera/ABACATEPAY_SETUP.md

Configuração - Sistema de Doações PIX via AbacatePay

Variáveis de Ambiente

Desenvolvimento/Teste

Crie o arquivo .env.local na raiz do projeto:

# Chave de API para ambiente de teste
ABACATE_TEST_APIKEY=abc_test_sua_chave_aqui

# URL base da aplicação
NEXT_PUBLIC_BASE_URL=http://localhost:3000

Produção

# Chave de API para ambiente de produção
ABACATE_APIKEY=abc_live_sua_chave_aqui

# URL base da aplicação
NEXT_PUBLIC_BASE_URL=https://seudominio.com

Como Funciona

O sistema automaticamente escolhe a chave correta baseado no ambiente:

• Desenvolvimento: Usa ABACATE_TEST_APIKEY
• Produção: Usa ABACATE_APIKEY (quando NODE_ENV=production)

Obtenção da Chave API

1. Acesse https://abacatepay.com
2. Crie uma conta gratuita
3. Vá em "Configurações" > "API Keys"
4. Copie sua chave de teste (começa com abc_test_...)
5. Cole no arquivo .env.local

Endpoint do Webhook

Configure no painel do AbacatePay:

Desenvolvimento: http://localhost:3000/api/webhooks/abacatepay Produção: https://seudominio.com/api/webhooks/abacatepay

Estrutura do Sistema

Fluxo de Doação

1. Usuário clica em "Apoiar com PIX"
2. Preenche formulário: nome (obrigatório), email (opcional), mensagem (opcional)
3. Sistema gera QR Code PIX via endpoint /pixQrCode/create
4. Usuário escaneia QR Code ou copia código PIX
5. Pagamento é processado no app bancário
6. Webhook confirma pagamento automaticamente
7. Dados são registrados para futuros agradecimentos e benefícios

Campos Coletados

• Nome: obrigatório (mínimo 3 caracteres) - para dar os devidos agradecimentos
• Email: opcional - para enviar agradecimento por email
• Mensagem: opcional (máximo 280 caracteres) - mensagem personalizada para a equipe

Expiração

• QR Code expira em 10 minutos
• Timer exibido no modal para o usuário acompanhar