Integrar uma API de pagamentos costuma ser assim: você lê a documentação, descobre que cada endpoint tem um jeito diferente de responder, trata erro de um jeito aqui e de outro ali, e no fim passa mais tempo lidando com inconsistências do que com o que realmente importa — cobrar.
A API v2 da AbacatePay nasceu para mudar isso. Ela está em beta e já é o novo padrão da plataforma. Não é uma atualização cosmética: é uma reformulação pensada em quem integra no dia a dia.
O que mudou de verdade?
A v1 segue funcionando até 1º de março de 2028. Nada de susto. Mas a v2 concentra tudo que lançamos de novo — Checkout Transparente, cartão de crédito, assinaturas, boleto — e tudo que vier pela frente. Se você quer o que há de mais recente, a v2 é o caminho.
O que a gente fez foi simples: ouvimos quem usa a API e reorganizamos tudo em torno de três ideias.
Primeiro: flexibilidade. Antes você criava recursos. Agora você também busca, lista e acessa o que precisa. Quer ver todos os checkouts de um cliente? Filtrar cupons por status? Pegar um pagamento específico pelo ID? Tudo direto, sem gambiarras. O backoffice e a integração ficam mais naturais.
Segundo: padrão. Respostas sempre no mesmo formato — data, success, error. Códigos HTTP que fazem sentido: 200 quando deu certo, 4xx quando o problema é seu, 5xx quando é nosso. Rotas que você adivinha pelo nome: criar checkout, obter checkout, listar checkouts. Menos surpresa, menos if especial espalhado no código.
Terceiro: intenção. Cada endpoint diz o que faz. Você lê a rota e entende. Isso ajuda você e ajuda ferramentas de IA: assistentes conseguem "ler" a API como texto e sugerir chamadas corretas. Integrar vira conversa.
Na prática
Imagine que você precisa consultar um checkout que acabou de ser pago.
Antes:
"Qual endpoint? Que parâmetro? O retorno vem em
resultou emdata?"
Agora:
GET /checkouts/get— e pronto.
O nome da rota é a intenção. A resposta vem sempre no mesmo envelope. Você sabe o que esperar.
Como participar do beta
A API v2 usa chaves de API v2, que você provisiona no dashboard. Os webhooks da v2 têm payloads novos e também são configurados por lá. Durante o beta, o acesso está aberto para clientes selecionados — a fase deve durar alguns dias. Quer entrar? Solicite pelo nosso canal de suporte.
Você pode rodar v1 e v2 em paralelo. A recomendação é migrar cedo: mais estabilidade e acesso a tudo que está vindo.
A documentação completa — autenticação, endpoints, webhooks, SDKs — está em docs.abacatepay.com. Selecione v2 (Beta) no topo e navegue. Para migrar da v1, use o seletor de versões e a seção dedicada à v1.
Se quiser fazer parte do beta, entre em contato. Estamos de ouvidos abertos.