> ## Documentation Index > Fetch the complete documentation index at: https://docs.abacatepay.com/llms.txt > Use this file to discover all available pages before exploring further. # Receber pagamentos por Pix > Receba por Pix com QR Code e copia e cola no checkout, no link de pagamento ou no seu site. Confirmação em segundos e o valor direto no seu saldo. O Pix é o pagamento instantâneo do Banco Central: funciona 24 horas por dia e confirma em segundos. Na AbacatePay, cada cobrança Pix tem um QR Code e um código copia e cola próprios, e o valor entra no seu saldo assim que o cliente paga. **Cobrança PIX - AbacatePay** O vídeo também está em [Pix](https://docs.abacatepay.com/pages/videos/pix.md). ## Quando usar o Pix | | Pix | Cartão de crédito | Boleto | | - | - | - | - | | **Confirmação** | Segundos | Segundos | Até 3 dias úteis (pelo Pix do boleto, segundos) | | **Disponível** | 24 horas, todos os dias | 24 horas, todos os dias | Dias úteis | | **Parcelamento** | Não | Até 12x | Não | | **Taxa** | Menor | Maior | Intermediária | | **Reembolso** | Sim | Sim | Não | Os valores das taxas estão em [Taxas](https://docs.abacatepay.com/pages/comecar/taxas.md). * **Venda de valor baixo ou que precisa de confirmação na hora:** Pix. * **Venda de valor alto:** cartão, com [parcelamento](https://docs.abacatepay.com/pages/pagamentos/parcelamento.md). * **Cliente sem cartão que quer pagar depois:** [boleto](https://docs.abacatepay.com/pages/pagamentos/boleto.md). * **Cobrança recorrente por Pix:** [Pix Automático](https://docs.abacatepay.com/pages/cobrar/pix-automatico.md), em que o cliente autoriza uma vez e as cobranças da assinatura saem sozinhas. * **Receber numa chave fixa, sem criar cobrança:** [Pix por chave](https://docs.abacatepay.com/pages/dinheiro/chave-pix.md). ## Como funciona o Pix ```mermaid theme={null} sequenceDiagram participant C as Cliente participant S as Seu sistema participant A as AbacatePay S->>A: Cria a cobrança A-->>C: QR Code e copia e cola C->>A: Paga no app do banco A-->>S: Webhook de pagamento Note over A: Valor entra no seu saldo ``` O Pix está disponível no [checkout](https://docs.abacatepay.com/pages/cobrar/checkout.md), no [link de pagamento](https://docs.abacatepay.com/pages/cobrar/link-de-pagamento.md) e no [checkout transparente](https://docs.abacatepay.com/pages/cobrar/checkout-transparente.md). No checkout e no link, o QR Code aparece na tela de pagamento da AbacatePay. No checkout transparente, você recebe o QR Code pela API e mostra no seu site. * **Valor mínimo:** R\$ 1,00 (`100` centavos). O banco de quem paga pode ter limites próprios de Pix. * **QR Code e copia e cola:** o cliente escaneia o QR Code ou cola o código no app do banco. Os dois já trazem o valor, e o cliente não digita nada. * **Saldo:** o valor, já sem a [taxa](https://docs.abacatepay.com/pages/comecar/taxas.md), entra no seu saldo na AbacatePay e fica disponível para [saque](https://docs.abacatepay.com/pages/dinheiro/saques.md). Na API, o QR Code vem em `brCodeBase64` (imagem PNG em base64, pronta para usar num ``) e o copia e cola em `brCode` (texto, bom para mandar por WhatsApp, e-mail ou SMS). ## Quanto tempo o Pix vale | Onde | Validade | | - | - | | Checkout e link de pagamento | 24 horas a partir do momento em que o cliente escolhe Pix. O checkout continua aberto: se o QR Code expirar, o cliente volta ao checkout e gera outro. | | Checkout transparente | 24 horas por padrão. Para mudar, envie `expiresIn` em segundos, com no mínimo 300 (5 minutos). | | Autorização do [Pix Automático](https://docs.abacatepay.com/pages/cobrar/pix-automatico.md) | 1 hora | Depois do prazo, a cobrança passa para `EXPIRED` e o QR Code não aceita mais pagamento. A resposta da API traz o momento exato em `expiresAt`. ## Quem pagou O banco informa à AbacatePay o nome e o CPF/CNPJ de quem fez o Pix. Esses dados chegam em `payerInformation`: * nos webhooks `checkout.*` e `transparent.*`; * na consulta do checkout, em [`GET /v2/checkouts/get`](https://docs.abacatepay.com/pages/payment/one), que também traz o banco de origem quando ele é informado. O CPF/CNPJ vem mascarado. No webhook, `isSameAsCustomer` diz se quem pagou tem o mesmo CPF/CNPJ do cliente da cobrança: ```json theme={null} "payerInformation": { "method": "PIX", "PIX": { "name": "Maria Santos", "taxId": "529.***.247-**", "isSameAsCustomer": true } } ``` Se o checkout não pedir os dados do cliente (flag `skip_customer`, veja [Checkout](https://docs.abacatepay.com/pages/cobrar/checkout.md)), a cobrança sai sem cliente, e quem pagou chega só por `payerInformation`. ## Exigir o mesmo CPF ou CNPJ do cliente No checkout transparente, `ensureSameTaxId: true` faz o Pix só ser aceito se quem paga tiver o mesmo CPF/CNPJ de `customer.taxId`. Se outra pessoa tentar pagar o QR Code, o banco recusa o pagamento. Use em cobranças nominais, como mensalidades e faturas. * Exige `customer` com `taxId`. Sem ele, a API responde `ensureSameTaxId requires a customer with taxId`. * Vale só para Pix no checkout transparente. * Nem toda conta tem a trava disponível. Quando não tem, a API responde `ensureSameTaxId is not supported by the current PIX provider`. * No Modo Teste, a trava não é aplicada. ## Dividir o Pix com subcontas Com `data.splits`, parte de um Pix do checkout transparente vai para o saldo das suas subcontas quando o cliente paga. As regras estão em [Subcontas e split](https://docs.abacatepay.com/pages/dinheiro/subcontas-e-split.md). ## Status do Pix ```mermaid theme={null} stateDiagram-v2 [*] --> PENDING: cobrança criada PENDING --> PAID: cliente pagou PENDING --> EXPIRED: prazo acabou PENDING --> CANCELLED: cancelada PAID --> REFUNDED: reembolso PAID --> UNDER_DISPUTE: pagador contestou (MED) UNDER_DISPUTE --> PAID: disputa encerrada a seu favor UNDER_DISPUTE --> REFUNDED: valor devolvido ``` Esses são os status da cobrança Pix do checkout transparente (`pix_char_...`). No checkout e no link, o status do checkout acompanha o pagamento: veja [Checkout](https://docs.abacatepay.com/pages/cobrar/checkout.md). O **MED** (Mecanismo Especial de Devolução) é o processo do Banco Central para o pagador contestar um Pix, em caso de fraude ou golpe. Enquanto a contestação está aberta, a cobrança fica `UNDER_DISPUTE`. ## Pelo dashboard 1. Em **Sua Loja → Links de pagamento**, clique em **Criar link de pagamento**. Para uma cobrança avulsa, use **Sua Loja → Cobranças → Criar cobrança**. 2. Em **Métodos de pagamento**, marque **Pix**. 3. Mande o link ao cliente. Ele escolhe Pix e paga com o QR Code ou com o botão **Copiar código PIX**. 4. Acompanhe os pagamentos em **Sua Loja → Cobranças**. O Pix do checkout transparente só é criado pela API. As cobranças dele aparecem na aba **Checkout Transparente** de **Sua Loja → Cobranças**. ## Pela API ### No checkout e no link de pagamento Inclua `"PIX"` em `methods`. Se você omitir `methods`, o checkout aceita Pix e cartão. Veja [Criar um checkout](https://docs.abacatepay.com/pages/payment/create.md) e [Criar um link de pagamento](https://docs.abacatepay.com/pages/payment-links/create.md). ```json theme={null} { "methods": ["PIX"], "items": [{ "id": "prod_abc123xyz", "quantity": 1 }] } ``` ### No checkout transparente Chame [`POST /v2/transparents/create`](https://docs.abacatepay.com/pages/transparents/create) com `method: "PIX"`. Só `data.amount` é obrigatório: ```json theme={null} { "method": "PIX", "data": { "amount": 10000, "description": "Pedido 123", "expiresIn": 3600, "externalId": "pedido-123", "customer": { "name": "Daniel Lima", "email": "daniel_lima@abacatepay.com", "taxId": "111.444.777-35", "cellphone": "(11) 4002-8922" }, "metadata": { "pedidoId": "pedido-123" } } } ``` | Campo | Descrição | | - | - | | `amount` | Valor em centavos. Mínimo `100` (R\$ 1,00). | | `expiresIn` | Validade em segundos. Padrão de 24 horas, mínimo `300`. | | `description` | Descrição do Pix, com até 140 caracteres. Emoji e alguns caracteres especiais são recusados. | | `customer` | Opcional. Se enviar, mande os quatro campos: `name`, `email`, `taxId` e `cellphone`. | | `ensureSameTaxId` | Exige que quem paga tenha o CPF/CNPJ de `customer.taxId`. | | `externalId` | Código do pedido no seu sistema. Se já houver uma cobrança Pix pendente com o mesmo `externalId`, a API devolve ela em vez de criar outra. | | `metadata`, `utm` | Dados seus e da campanha. Veja [UTM e metadados](https://docs.abacatepay.com/pages/vender/utm-e-metadados.md). | | `splits` | Partes do Pix para [subcontas](https://docs.abacatepay.com/pages/dinheiro/subcontas-e-split.md). | A resposta traz o QR Code, o copia e cola e a validade: ```json theme={null} { "data": { "id": "pix_char_abc123xyz", "amount": 10000, "status": "PENDING", "devMode": false, "brCode": "00020101021226950014br.gov.bcb.pix...", "brCodeBase64": "data:image/png;base64,iVBORw0KG...", "platformFee": 80, "receiptUrl": null, "createdAt": "2026-11-10T18:38:28.573Z", "updatedAt": "2026-11-10T18:38:28.573Z", "expiresAt": "2026-11-10T19:38:28.573Z", "metadata": { "pedidoId": "pedido-123" } }, "success": true, "error": null } ``` ### Consultar o status Para saber se um Pix do checkout transparente foi pago, use [`GET /v2/transparents/check`](https://docs.abacatepay.com/pages/transparents/check). Ele devolve só `id`, `status` e `expiresAt`, e aceita apenas Pix: com um id de boleto ou de cartão, a resposta é `Pix QR Code not found`. Para ver a cobrança completa, use `GET /v2/transparents/get`. Prefira os webhooks a consultar a API em intervalos: a confirmação chega assim que o cliente paga. ## Notificações | Evento | Quando dispara | | - | - | | `checkout.completed` | O cliente pagou o Pix de um checkout ou de um link de pagamento. | | `transparent.completed` | O cliente pagou o Pix do checkout transparente (`status: "PAID"`). | | `checkout.refunded`, `transparent.refunded` | O Pix foi [reembolsado](https://docs.abacatepay.com/pages/vender/reembolsos.md). | | `checkout.disputed`, `transparent.disputed` | O pagador contestou o Pix (MED). | O conteúdo de cada evento está em [eventos de checkout](https://docs.abacatepay.com/pages/webhooks/events/checkout.md) e [eventos do checkout transparente](https://docs.abacatepay.com/pages/webhooks/events/transparent.md). Não há evento de expiração: use `expiresAt` ou consulte o status. Para configurar, veja [Webhooks](https://docs.abacatepay.com/pages/notificacoes/webhooks.md). ## Testar no Modo Teste * **Checkout e link de pagamento:** na tela do Pix, clique em **Simular Pagamento**. * **Checkout transparente:** chame [`POST /v2/transparents/simulate-payment`](https://docs.abacatepay.com/pages/transparents/simulate-payment) com o `id` da cobrança. A simulação existe só para Pix e só no [Modo Teste](https://docs.abacatepay.com/pages/comecar/modo-teste.md). * **Expiração:** no Modo Teste, a cobrança expira de verdade no prazo de `expiresIn`, que aceita a partir de 60 segundos. Use um prazo curto para testar o `EXPIRED`. ## Perguntas frequentes > [accordion] Quanto tempo o QR Code Pix vale? > > 24 horas. No checkout transparente, você muda o prazo com `expiresIn`. O QR Code de autorização do Pix Automático vale 1 hora. > [accordion] Qual o valor mínimo de um Pix? > > R$ 1,00 (`100` centavos). Para boleto, o mínimo é R$ 3,00. > [accordion] O dinheiro do Pix cai na hora? > > Sim. Assim que o cliente paga, o valor entra no seu saldo na AbacatePay. Para mandar para a sua conta bancária, faça um [saque](https://docs.abacatepay.com/pages/dinheiro/saques.md). > [accordion] Como sei que o cliente pagou? > > Pelo webhook `checkout.completed` ou `transparent.completed`, pelo dashboard em **Sua Loja → Cobranças** ou, no checkout transparente, pela rota `/transparents/check`. > [accordion] O cliente pode pagar um QR Code expirado? > > Não. No checkout e no link, ele volta à tela de pagamento e gera outro QR Code. No checkout transparente, crie uma cobrança nova. > [accordion] Posso impedir que outra pessoa pague o Pix? > > Sim, no checkout transparente. Envie `ensureSameTaxId: true` com o `customer.taxId`. Veja [Exigir o mesmo CPF ou CNPJ do cliente](#exigir-o-mesmo-cpf-ou-cnpj-do-cliente). > [accordion] Posso reembolsar um Pix? > > Sim. O reembolso devolve o valor ao pagador. Veja [Reembolsos](https://docs.abacatepay.com/pages/vender/reembolsos.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.