Pular para o conteúdo principal
Pix é o sistema de pagamento instantâneo brasileiro criado pelo Banco Central do Brasil. Ele permite transferências em tempo real 24/7, incluindo fins de semana e feriados, e se tornou o método de pagamento mais popular no Brasil.

​
Por que Oferecer Pix?

Dominant in Brazil

Pix é o método de pagamento mais usado no Brasil, superando cartões de crédito e boleto.

Instant Settlement

Os pagamentos são confirmados em segundos, 24/7/365 — sem esperar pela janela de processamento bancário.

Low Friction

Os clientes pagam via QR code ou chave de copiar e colar — não é necessário número de cartão ou dados bancários.

​
Visão Geral

DetalheValor
Moeda de CobrançaBRL
Países SuportadosBrasil
AssinaturasNão
Valor Mínimo$0,50
LiquidaçãoInstantânea

​
Como Funciona

​
Experiência do Cliente

  1. Cliente seleciona Pix no checkout
  2. Um QR code e chave de copiar e colar são exibidos
  3. Cliente abre seu aplicativo bancário e escaneia o QR code ou cola a chave
  4. Pagamento é confirmado instantaneamente
  5. Cliente é redirecionado para a página de sucesso
Os QR codes do Pix normalmente expiram após um período determinado. Se o cliente não concluir o pagamento a tempo, precisará reiniciar o checkout.

​
Configuração

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

​
Tipo de Método da API

TipoMétodoPaís
pixPixBrasil

​
Testes

1

Enable test mode

Use suas chaves de teste da Dodo Payments.
2

Set billing currency to BRL

Certifique-se de que a moeda de cobrança esteja definida como BRL em sua solicitação de checkout.
3

Enter test CPF and scan the QR code

Quando solicitado um CPF Pix, digite 1234567890. Um QR code de teste será gerado — escaneie com a câmera normal do seu celular (não é necessário app do Pix). Você será redirecionado para uma página de teste do Stripe onde poderá simular a transação como sucesso ou falha.

​
Melhores Práticas

Pix funciona apenas com BRL. Garanta que seus preços suportem transações em Real Brasileiro para o mercado brasileiro.
Nem todos os clientes brasileiros podem preferir Pix. Sempre inclua credit e debit como opções alternativas.
Os QR codes do Pix expiram após um período determinado. Certifique-se de que seu checkout lide com a expiração de forma adequada e permita que os clientes regenerem o código.

​
Solução de Problemas

Verificação:
  1. Moeda de cobrança definida como BRL?
  2. pix incluído em allowed_payment_method_types?
  3. País de cobrança do cliente é Brasil?
Solução: Pix está disponível apenas para transações em BRL. Verifique a moeda e o endereço de cobrança em sua solicitação de API.
Causa: Cliente não completou o pagamento dentro do prazo de expiração.Solução: Cliente precisa reiniciar o checkout para gerar um novo QR code.
Causa: Pagamentos Pix são confirmados instantaneamente na maioria dos casos, mas atrasos ocasionais do lado do banco podem ocorrer.Solução: Monitore os webhooks para confirmação do pagamento. Se o pagamento não for confirmado em alguns minutos, trate como falha.

​
Páginas Relacionadas

Payment Methods Overview

Veja todos os métodos de pagamento suportados.

Adaptive Currency

Suporte a moedas e conversão automática.

Checkout Guide

Guia completo de implementação de checkout.

Webhooks

Lide com as confirmações de pagamento de forma assíncrona.
Last modified on April 8, 2026