¿Por Qué Ofrecer Pix?
Dominant in Brazil
Pix es el método de pago más utilizado en Brasil, por delante de las tarjetas de crédito y los boletos bancarios. El Banco Central do Brasil informa que Pix representó el 54,7 % de todas las transacciones de pago en la segunda mitad de 2025.
Instant Settlement
Las transferencias de Pix se completan en segundos, a cualquier hora y cualquier día del año, por lo que no hay que esperar ninguna ventana de procesamiento bancaria.
Low Friction
El cliente escanea un código QR o pega un código Pix en su aplicación bancaria. No introduce números de tarjeta ni datos bancarios.
Resumen
El mínimo es el mínimo del checkout para BRL, por lo que se aplica a todos los métodos de pago en un checkout en BRL.Cómo funciona
Experiencia del cliente
- El cliente selecciona Pix en el checkout e introduce su CPF (el número de identificación fiscal brasileño de 11 dígitos) en el campo Pix CPF.
- El cliente confirma el pago. Se abre un código QR en una superposición de pantalla completa, con el código Pix y un botón Copiar el código debajo.
- El cliente abre su aplicación bancaria, selecciona Pix y escanea el código QR o pega el código Pix.
- El pago se confirma en unos segundos.
- El checkout detecta que el pago se completó y redirige al cliente a tu página de éxito.
El código QR de Pix caduca después de un tiempo limitado. Si el cliente no paga a tiempo, debe iniciar un nuevo checkout desde tu sitio.
Configuración
Tipo de método de API
Pruebas
1
Enable Test Mode
Desactiva el interruptor Live Mode en la barra lateral del dashboard y utiliza API keys creadas en modo de prueba.
2
Set Billing Currency to BRL
Habilita Adaptive Currency. Después, crea una sesión de checkout con
billing_currency: 'BRL' y pix en allowed_payment_method_types.3
Enter Test CPF and Scan the QR Code
En el campo Pix CPF, introduce
00000000000 (11 ceros). El checkout muestra un código QR de prueba. Escanéalo con la cámara de tu teléfono; no necesitas una aplicación de Pix ni bancaria. El código QR abre una página de prueba donde puedes simular un pago exitoso o fallido.Prácticas recomendadas
Set billing currency to BRL
Set billing currency to BRL
Pix funciona únicamente en checkouts facturados en BRL, y Dodo Payments factura en BRL solo cuando Adaptive Currency está habilitado. Habilita Adaptive Currency para que los clientes en Brasil reciban los precios y se les facture en BRL.
Provide card fallbacks
Provide card fallbacks
Algunos clientes brasileños prefieren pagar con tarjeta. Incluye
credit y debit como métodos de pago alternativos.Handle QR code expiration
Handle QR code expiration
Los códigos QR de Pix caducan después de un tiempo limitado. Si un cliente regresa después de que el código haya caducado, crea una nueva sesión de checkout para él.
Solución de problemas
Pix not appearing at checkout
Pix not appearing at checkout
Comprobaciones:
- ¿La moneda de facturación es
BRL? - ¿
pixestá incluido enallowed_payment_method_types? - ¿El país de facturación del cliente es Brasil (
BR)? Con Adaptive Currency, una dirección de facturación brasileña establece la moneda de facturación en BRL. - ¿Adaptive Currency está habilitado?
- ¿El importe alcanza el mínimo de 0.50 BRL?
QR code expired
QR code expired
Causa: El cliente no completó el pago dentro del periodo de validez.Solución: El cliente debe iniciar un nuevo checkout desde tu sitio. Para enviarle un nuevo enlace de pago, crea una nueva sesión de checkout.
Payment pending
Payment pending
Causa: La mayoría de los pagos de Pix se confirman en unos segundos, pero en ocasiones un banco puede retrasar una transferencia.Solución: Utiliza los webhooks
payment.succeeded y payment.failed para obtener el estado final del pago en lugar de la redirección de retorno. Si el pago no se confirma en unos minutos, considéralo fallido.Páginas relacionadas
Payment Methods Overview
Consulta todos los métodos de pago compatibles.
Adaptive Currency
Factura a los clientes en su moneda local, incluido BRL.
Checkout Guide
Guía completa de implementación del checkout.
Webhooks
Gestiona las confirmaciones de pago de forma asíncrona.
Testing Process
Datos de prueba y orientación sobre las pruebas del checkout.