Sem código, crie um produto e um link de pagamento no painel. Com código, use a API v2 (REST com JSON e chave Bearer) ou os SDKs oficiais de Node.js e Ruby. Teste tudo no Modo Teste, sem enviar documentos, e confirme cada pagamento por webhook, com a assinatura HMAC-SHA256 no header.
Qual caminho escolher
| Caminho | Esforço | Para quem |
|---|---|---|
| Link de pagamento | Sem código: produto e link criados no painel | Quem vende por mensagem, e-mail ou link na bio |
| Checkout hospedado | A API cria a cobrança e o cliente paga numa página da AbacatePay | Sites e sistemas que querem integrar rápido |
| Checkout transparente | O pagamento fica no seu site: Pix pela API e cartão pelo abacatepay.js, com a chave pública pk_ |
Quem quer a tela de pagamento dentro do próprio site |
| Automação sem código | Fluxos no n8n, no Zapier ou no Make chamando a API | Quem já automatiza vendas: veja cobrança Pix no n8n e Zapier e Make |
| Agente de IA | MCP e AI Skills | Quem cobra a partir de um agente ou programa com IA |
O cartão de crédito é ativado sob consulta. O Pix funciona em todos os caminhos.
Passo a passo com a API
- Crie a conta. Toda conta começa no Modo Teste, onde os pagamentos são simulados e nada é cobrado.
- Crie a chave de teste. No painel, em Integração → API → Nova chave. Para criar chaves, a conta precisa da verificação em duas etapas (2FA). Escolha as permissões de cada rota e copie a chave: ela aparece uma única vez. A chave de teste começa com
abc_dev_. - Faça a primeira cobrança no Modo Teste. A base é
https://api.abacatepay.com/v2, com o headerAuthorization: Bearere a sua chave. - Configure o webhook. Cadastre a URL que vai receber os eventos e o secret.
- Vá para produção. Com a conta verificada, desligue o Modo Teste, crie a chave de produção (
abc_prod_), troque a chave no seu sistema, crie os webhooks de novo e faça uma venda real de valor baixo. A URL da API é a mesma.
O guia completo está na documentação e em como integrar um gateway de pagamento.
Webhooks
A cada mudança de status, a AbacatePay faz um POST com o JSON do evento para a sua URL, com o secret que você cadastrou e a assinatura HMAC-SHA256 do corpo no header X-Webhook-Signature. Se o seu servidor não responder, a entrega é repetida automaticamente, com o mesmo id, que serve para descartar repetidos. Confira o secret e a assinatura antes de liberar o pedido. Veja o que é webhook de pagamento.
Ferramentas
- SDKs da v2: os oficiais são os de Node.js e Ruby. Os SDKs de Python, Go, Java, PHP, Rust, Kotlin e Swift são da v1, legados. Em outra linguagem, chame a API REST direto.
- Só no servidor: todo SDK roda no seu backend, porque a chave de API é secreta e não pode ir para dentro de um app ou do navegador.
- CLI: login, webhooks no seu localhost e simulação de pagamentos.
- MCP: a API da AbacatePay dentro de agentes e editores com IA.
- Open source: os SDKs, a CLI, o MCP e a documentação têm repositórios públicos.
Mais detalhes na página de desenvolvedores e na API Pix.
Segurança da chave
- Guarde a chave só no backend, numa variável de ambiente ou num gerenciador de segredos, nunca no front.
- Dê a cada chave só as permissões que a integração usa. As permissões não podem ser editadas depois: para mudar, crie uma chave nova e exclua a antiga.
- Cada loja pode fazer até 100 requisições por segundo, somando todas as chaves. Acima disso, a API responde
429.
Perguntas frequentes
Preciso programar para usar a AbacatePay?
Não. Dá para vender só com o link de pagamento e o checkout criados no painel.
A AbacatePay tem ambiente de teste?
Sim. O Modo Teste simula pagamentos por Pix, cartão e boleto e os webhooks, sem dinheiro real e sem enviar documentos.
Qual linguagem tem SDK?
Na API v2, Node.js e Ruby. Nas outras linguagens, chame a API REST direto.
Como sei que o pagamento caiu?
Pelo webhook: a AbacatePay avisa a sua URL quando o pagamento é confirmado. Confira o secret e a assinatura de cada entrega.