Receber Pix na chave (QR Code estático)

​

Quando usar

​

Como funciona

• Todo Pix que cai na chave entra no saldo disponível, com a mesma taxa do Pix por QR Code da sua conta. A taxa nunca passa do valor recebido.
• Não existe cobrança por trás. O pagamento é identificado por quem pagou e pelo endToEndId do Pix.
• Os Pix recebidos na chave contam no faturamento do dashboard e aparecem no extrato como venda no Pix.
• O recurso é liberado conta a conta pela equipe AbacatePay. Para usar, fale com o suporte pelo chat do dashboard ou em ajuda@abacatepay.com.
• Funciona só em produção.

​

Como receber Pix na chave pelo dashboard

1

Pegue a sua chave

Com o recurso liberado, a aba Chave Pix aparece em Sua Loja → Cobranças. Nela, clique em Ver minha chave Pix:

Copie a chave. É ela que você passa para os seus clientes.

2

Acompanhe os Pix recebidos

A aba Chave Pix lista cada Pix recebido na chave, com o pagador (nome e CPF/CNPJ mascarado), o valor, a data, o status e as ações Ver comprovante, Reembolsar e Copiar ID. Dá para buscar por ID, nome ou CPF/CNPJ e filtrar por status.

3

Cadastre o webhook

Em Integração → Webhooks, clique em Criar webhook, escolha Webhook v2 e selecione os eventos Pix recebido na chave (pix_key.received) e Pix recebido na chave reembolsado (pix_key.refunded). Os dois eventos só aparecem nas contas com o recurso liberado.

Assinatura, retentativas e formato de entrega são os mesmos dos outros webhooks. Veja Webhooks.

​

Pela API

{
  "id": "log_uRuGjMfQhP1nCPt5kuLBMWqn",
  "event": "pix_key.received",
  "apiVersion": 2,
  "devMode": false,
  "data": {
    "pixKey": {
      "id": "tran_64cYncueN5DNF24FQgGJUyqZ",
      "amount": 100,
      "fee": 80,
      "status": "COMPLETE",
      "endToEndId": "E18236120202610271332s06f8c6bb99",
      "receiptUrl": "https://app.abacatepay.com/receipt/tran_64cYncueN5DNF24FQgGJUyqZ",
      "createdAt": "2026-10-27T13:32:34.077Z"
    },
    "payer": {
      "name": "Maria da Silva",
      "taxId": "123.***.789-**",
      "bank": { "ispb": "18236120", "name": "NU PAGAMENTOS - IP" }
    }
  }
}

• data.pixKey.amount: o que o cliente pagou, em centavos.
• data.pixKey.fee: a taxa, em centavos. Você recebe amount menos fee.
• data.pixKey.id: o ID do Pix na AbacatePay. Guarde para não dar baixa duas vezes.
• data.payer: quem pagou. Use para saber de qual cliente é o Pix. O CPF/CNPJ vem mascarado; para receber o documento completo no webhook, fale com o suporte.

​

Notificações

​

Reembolso

• O valor volta para quem pagou e o webhook pix_key.refunded é disparado.
• O reembolso sai do saldo disponível e exige saldo suficiente.
• A taxa do Pix recebido não é devolvida. Veja Reembolsos.

​

Testar no Modo Teste

​

Perguntas frequentes