¿Por Qué Ofrecer Pix?
Dominant in Brazil
Instant Settlement
Low Friction
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. Un pago en BRL también debe ser de al menos el equivalente a $0.50 para pagos únicos y $1.00 para suscripciones. Consulta Importes mínimos.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
Comprobación:
- ¿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 cumple con el mínimo de 0.50 BRL y el mínimo en USD?
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.