Receber Pix por chave fixa

• Todo Pix que cai na chave entra no seu saldo, com a mesma taxa do Pix por QR Code da sua conta.
• A cada Pix recebido, a AbacatePay dispara o webhook pix_key.received, com o valor, a taxa e quem pagou (nome, CPF/CNPJ e banco).
• Não existe cobrança por trás. O pagamento é identificado pelo próprio Pix (pagador e endToEndId), não por um ID de cobrança.

​

Disponibilidade

• O recurso é liberado conta a conta pela equipe AbacatePay, para contas elegíveis. Para usar, fale com o suporte pelo chat do dashboard ou em ajuda@abacatepay.com.
• Funciona só em produção. Não existe Pix por chave no Dev mode, e webhooks criados em Dev mode não recebem esses eventos.

​

Passo 1: pegue a sua chave no dashboard

​

Passo 2: acompanhe os Pix recebidos

• pagador (nome e CPF/CNPJ mascarado);
• valor e data;
• status: Pago, Em disputa ou Reembolsado;
• ações: Ver comprovante, Reembolsar e Copiar ID.

​

Passo 3: cadastre o webhook

​

Passo 4: dê baixa com o pix_key.received

{
  "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 - fee.
• data.payer: quem pagou. Use para saber de qual cliente é o Pix.
• data.pixKey.id: o ID do Pix na AbacatePay. Guarde para não dar baixa duas vezes.

​

Reembolso

• O valor volta para quem pagou e o webhook pix_key.refunded é disparado.
• O reembolso exige saldo disponível suficiente na conta.
• Ainda não há endpoint da API para reembolsar um Pix por chave.

​

Boas práticas