Por que Oferecer Pix?
Dominant in Brazil
Pix é o método de pagamento mais usado no Brasil, à frente dos cartões de crédito e do boleto. O Banco Central do Brasil informa que o Pix foi responsável por 54,7% de todas as transações de pagamento no segundo semestre de 2025.
Instant Settlement
As transferências Pix são concluídas em segundos, a qualquer hora e em qualquer dia do ano, portanto não há janela de processamento bancário pela qual seja necessário esperar.
Low Friction
O cliente escaneia um código QR ou cola um código Pix no aplicativo bancário. Não é necessário inserir números de cartão ou dados bancários.
Visão Geral
O valor mínimo é o mínimo do checkout para BRL, portanto ele se aplica a todos os métodos de pagamento em um checkout em BRL.Como funciona
Experiência do cliente
- O cliente seleciona Pix no checkout e insere seu CPF (o documento de identificação fiscal brasileiro de 11 dígitos) no campo Pix CPF.
- O cliente confirma o pagamento. Um código QR é aberto em uma sobreposição de tela cheia, com o código Pix e um botão Copiar o código abaixo dele.
- O cliente abre o aplicativo bancário, seleciona Pix e escaneia o código QR ou cola o código Pix.
- O pagamento é confirmado em segundos.
- O checkout detecta o pagamento concluído e redireciona o cliente para sua página de sucesso.
O código QR do Pix expira após um período limitado. Se o cliente não pagar a tempo, ele precisará iniciar um novo checkout no seu site.
Configuração
Tipo de método da API
Testes
1
Enable Test Mode
Desative o botão Live Mode na barra lateral do dashboard e use as chaves de API criadas no modo de teste.
2
Set Billing Currency to BRL
Habilite Adaptive Currency. Em seguida, crie uma sessão de checkout com
billing_currency: 'BRL' e pix em allowed_payment_method_types.3
Enter Test CPF and Scan the QR Code
No campo Pix CPF, insira
00000000000 (11 zeros). O checkout exibirá um código QR de teste. Escaneie-o com a câmera do seu celular; não é necessário usar um aplicativo Pix ou bancário. O código QR abre uma página de teste na qual você pode simular um pagamento bem-sucedido ou malsucedido.Práticas recomendadas
Set billing currency to BRL
Set billing currency to BRL
O Pix funciona somente em checkouts cobrados em BRL, e a Dodo Payments cobra em BRL somente quando Adaptive Currency está habilitado. Habilite Adaptive Currency para que clientes no Brasil recebam cotações e sejam cobrados em BRL.
Provide card fallbacks
Provide card fallbacks
Alguns clientes brasileiros preferem pagar com cartão. Inclua
credit e debit como métodos de pagamento alternativos.Handle QR code expiration
Handle QR code expiration
Os códigos QR do Pix expiram após um período limitado. Se um cliente retornar após a expiração do código, crie uma nova sessão de checkout para ele.
Solução de problemas
Pix not appearing at checkout
Pix not appearing at checkout
Verifique:
- A moeda de cobrança é
BRL? pixestá incluído emallowed_payment_method_types?- O país de cobrança do cliente é o Brasil (
BR)? Com Adaptive Currency, um endereço de cobrança brasileiro define a moeda de cobrança como BRL. - Adaptive Currency está habilitado?
- O valor atende ao mínimo de 0.50 BRL?
QR code expired
QR code expired
Causa: O cliente não concluiu o pagamento dentro do período de validade.Solução: O cliente precisa iniciar um novo checkout no seu site. Para enviar um novo link de pagamento, crie uma nova sessão de checkout.
Payment pending
Payment pending
Causa: A maioria dos pagamentos Pix é confirmada em segundos, mas um banco pode ocasionalmente atrasar uma transferência.Solução: Use os webhooks
payment.succeeded e payment.failed para obter o status final do pagamento, em vez do redirecionamento de retorno. Se o pagamento não for confirmado em alguns minutos, considere-o malsucedido.Páginas relacionadas
Payment Methods Overview
Veja todos os métodos de pagamento compatíveis.
Adaptive Currency
Cobre os clientes na moeda local deles, incluindo BRL.
Checkout Guide
Guia completo de implementação do checkout.
Webhooks
Lide com as confirmações de pagamento de forma assíncrona.
Testing Process
Dados de teste e orientações para testar o checkout.