Por que Oferecer Pix?
Dominant in Brazil
Instant Settlement
Low Friction
Visão Geral
O valor mínimo é o mínimo do checkout para BRL, portanto se aplica a todos os métodos de pagamento em um checkout em BRL. Um pagamento em BRL também deve ser de pelo menos o equivalente a $0.50 para pagamentos únicos e $1.00 para assinaturas. Consulte Valores mínimos.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 no Brasil define a moeda de cobrança como BRL. - O Adaptive Currency está habilitado?
- O valor atende ao mínimo de 0.50 BRL e ao mínimo em USD?
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.