Skip to main content

​
Autenticação e chaves

Acesse o dashboard da AbacatePay, vá em Integrar → API Keys e clique em Criar Chave. Consulte o guia de autenticação para o passo a passo completo.
Não. Chaves de Dev mode só funcionam no ambiente de desenvolvimento — elas nunca processam transações reais. Para produção, crie uma chave separada após verificar sua conta.
Verifique se:
  • O header Authorization: Bearer SUA_CHAVE está presente na requisição
  • A chave não foi revogada no dashboard
  • Você está usando a chave do ambiente correto (dev ou produção)
A chave existe e é válida, mas não tem permissão para o recurso solicitado. Acesse o dashboard, edite a chave e adicione a permissão necessária (ex: CHECKOUT:CREATE). Consulte a tabela de permissões.

​
Dev mode e testes

No Dev mode, todos os pagamentos são simulados — nenhum valor real é movimentado. O ambiente é determinado automaticamente pela chave usada: chaves de Dev geram transações fictícias, chaves de Produção processam transações reais.
Para PIX, use o endpoint /transparents/simulate-payment após criar a cobrança. Para cartão, use o número 4242 4242 4242 4242 com qualquer data futura e CVV de 3 dígitos. Consulte o guia de Dev mode.
Não. Webhooks criados em Dev mode recebem apenas eventos simulados. Para eventos reais, use uma chave de produção e crie o webhook no ambiente de produção.

​
Webhooks

  1. Confirme que a URL está acessível publicamente via HTTPS
  2. Verifique se o endpoint responde 200 OK — qualquer outro código faz a AbacatePay considerar a entrega como falha
  3. Confira se o webhook foi criado no ambiente correto (dev ou produção)
  4. Veja os logs do webhook no dashboard para checar tentativas anteriores
Sim. Em caso de falha (timeout ou resposta não-2xx), a AbacatePay realiza novas tentativas com backoff progressivo. Implemente idempotência usando o campo id do evento para evitar processamento duplicado.
Cada requisição inclui o header X-Webhook-Signature com uma assinatura HMAC-SHA256. Consulte a página de segurança de webhooks para exemplos em Node.js, Python e Go.

​
Pagamentos e cobranças

O Checkout redireciona o cliente para uma página de pagamento hospedada pela AbacatePay. O Checkout Transparente permite que você construa a interface de pagamento na sua própria aplicação, enquanto a AbacatePay processa a transação nos bastidores.
O parcelamento está disponível no Checkout com cartão de crédito. Você define o número máximo de parcelas ao criar o checkout. Consulte a documentação de parcelamento para os detalhes de configuração.
No Dev mode, a confirmação é imediata após simular o pagamento. Em produção, PIX são confirmados em segundos após o pagamento pelo cliente — você receberá um webhook transparent.completed ou checkout.completed assim que ocorrer.

​
SDKs e integração

Use o SDK da linguagem do seu backend. Para Node.js/TypeScript é @abacatepay/sdk. Consulte a página de SDKs para ver todas as opções disponíveis.
Sim. Todos os endpoints aceitam requisições HTTP padrão com Content-Type: application/json. Os SDKs são conveniência, não obrigação.
Abra uma issue no repositório GitHub do SDK específico. Os links estão na página de cada SDK. Nossa equipe monitora ativamente os repositórios.

Não encontrou sua resposta?

Entre em contato com nossa equipe: ajuda@abacatepay.com