API · Pix

API Pix: gere QR Code e receba na hora

Uma chamada cria a cobrança. Você recebe QR em base64, copia e cola e confirma por webhook. R$ 0,80 por Pix, sem mensalidade.

Criar conta grátisVer documentação

Passo a passo

Como gerar um QR Code Pix pela API

  1. Autentique com o Bearer token da sua conta.
  2. Faça POST em /v2/transparents/create com method PIX e o amount em centavos.
  3. Exiba brCodeBase64 (imagem) e/ou brCode (copia e cola) na sua UI.
  4. Escute o webhook quando o status mudar para pago.

Gateway Pix · Checkout transparente · Desenvolvedores · Docs Pix

curl -X POST https://api.abacatepay.com/v2/transparents/create \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "PIX",
    "data": {
      "amount": 5000,
      "description": "Compra na sua loja",
      "expiresIn": 600
    }
  }'

Endpoints

Endpoints da API Pix

A API de API Pix é baseada em intenção: cada rota diz o que faz. Comece em minutos, escale sem dor.

  • POST/transparents/createCria uma cobrança Pix, boleto ou cartão
  • GET/transparents/listLista todos os checkouts transparentes
  • GET/transparents/checkVerifica o status de um pagamento
  • POST/transparents/simulate-paymentSimula pagamento em ambiente sandbox
  • POST/transparents/refundReembolsa uma cobrança paga
  • POST/pix/sendEnvia um Pix pra qualquer chave
  • GET/pix/getBusca uma transferência pelo ID
  • GET/pix/listLista todas as transferências
Documentação completa 
curl -X POST https://api.abacatepay.com/v2/transparents/create \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "PIX",
    "data": {
      "amount": 5000,
      "description": "Compra na sua loja",
      "expiresIn": 600
    }
  }'

Confirme o pagamento por webhook

O evento transparent.completed chega assinado (HMAC). Trate com idempotência: o mesmo evento pode ser reenviado. Configure em /api/webhooks.

SDKs, sandbox e IA

SDKs e exemplos em 15+ linguagens (veja /pix). Modo de teste usa a mesma URL com a chave de dev. Integre com MCP, llms.txt ou leia como testar no sandbox. Envio de Pix: /api/pix-transfers.

Quanto custa a API Pix

R$ 0,80 por Pix recebido. QR Code grátis. Saque Pix R$ 0,80 (até 20/mês). Sem mensalidade. Tabela em /pricing.

QR Code estático × dinâmico

O QR estático (Manual do BCB) reutiliza a mesma cobrança; o dinâmico gera um BR Code por valor/pedido — o padrão pra e-commerce e assinatura. A API Pix da AbacatePay cria cobranças dinâmicas com expiração configurável.

Criar conta grátis

Dúvidas sobre a API Pix?

Do QR Code dinâmico ao webhook: o que os devs mais perguntam.

O que é uma API Pix?

É a interface programática pra criar cobranças Pix, obter QR Code/copia e cola e saber quando o pagamento foi confirmado — em geral via webhook.

Como gerar QR Code Pix dinâmico pela API?

Chame POST /v2/transparents/create com method PIX e o valor em centavos. A resposta inclui brCode e brCodeBase64. Veja o exemplo de curl nesta página.

A API retorna a imagem do QR Code?

Sim. O campo brCodeBase64 traz a imagem em data URI (base64), além do código copia e cola (brCode).

Como sei que o Pix foi pago?

Configure um webhook e escute o evento transparent.completed (assinado). Também dá pra consultar /transparents/check. Detalhes em abacatepay.com/api/webhooks.

Tem sandbox?

Tem. Com a chave de teste você usa a mesma URL da API e simula o pagamento com /transparents/simulate-payment. Veja o post abacatepay.com/blog/como-testar-gateway-sandbox-abacatepay.

Quanto custa?

R$ 0,80 por Pix recebido. Gerar QR Code não custa nada. Saque Pix a R$ 0,80 (até 20/mês). Sem mensalidade.

Preciso de CNPJ?

Sim. MEI serve. Detalhes em abacatepay.com/blog/precisa-de-cnpj-mei-tambem-vale.

Criar conta grátis

Sem mensalidade. Aprovação não leva semanas.

Gere seu primeiro QR Code Pix hoje

Conta grátis, sandbox na mesma URL e documentação com llms.txt pra colar na IA.

Criar conta grátis

Sem mensalidade. Aprovação não leva semanas.

Ilustração renascentista com anjos e um abacate numa concha