Início rápido

Comece criando uma chave em Integrações no painel AgitaPay. Cada chave pertence a uma loja e tem permissões próprias.

Teste a chave

O endpoint GET /account valida a autenticação sem criar cobranças nem movimentar saldo.

curl -X GET "https://agitapay.johndev.shop/v1/account" \
  -H "Authorization: Bearer agp_li...xxxx"

Crie uma cobrança PIX

E-mail, nome, documento (CPF ou CNPJ) e notification_url são obrigatórios.

curl -X POST "https://agitapay.johndev.shop/v1/payments/pix" \
  -H "Authorization: Bearer agp_li...xxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d '{"customer":{"email":"[email protected]","name":"Ana Silva","document":"39053344705"},"amount":19.9,"currency":"BRL","notification_url":"https://loja.com/webhooks/agitapay"}'

Confirme antes de liberar produto

O webhook é um aviso. Ao receber payment.paid, confirme no servidor com GET /payments/{id} antes de liberar qualquer produto.

Em operação real, envie Idempotency-Key em toda criação de PIX ou saque. Sem a chave, um retry após timeout pode cobrar duas vezes.

Próximos passos

Autenticação — regras da chave e permissões
Criar cobrança PIX — QR Code e copia-e-cola
Webhooks — receba e confirme eventos de pagamento

Primeiros passos

Autenticação e fundamentos

PIX

Links de pagamento

Saldo e saques

Eventos e suporte

Integração com IA

Próximos passos

​Próximos passos

Próximos passos