Saltar al contenido principal
Pix es el sistema de pagos instantáneos de Brasil creado por el Banco Central de Brasil (Banco Central do Brasil). Permite transferencias en tiempo real 24/7, incluidos fines de semana y feriados, y se ha convertido en el método de pago más popular en Brasil.

​
¿Por Qué Ofrecer Pix?

Dominant in Brazil

Pix es el método de pago más usado en Brasil, superando a las tarjetas de crédito y al boleto.

Instant Settlement

Los pagos se confirman en segundos, 24/7/365, sin esperar ventanas de procesamiento bancario.

Low Friction

Los clientes pagan mediante código QR o clave de copiar y pegar, no se necesitan números de tarjeta ni datos bancarios.

​
Resumen

DetalleValor
Moneda de CobroBRL
Países SoportadosBrasil
SuscripcionesNo
Cantidad Mínima$0.50
LiquidaciónInstantánea

​
Cómo Funciona

​
Experiencia del Cliente

  1. El cliente selecciona Pix en el proceso de pago
  2. Se muestra un código QR y una clave para copiar y pegar
  3. El cliente abre su aplicación bancaria y escanea el código QR o pega la clave
  4. El pago se confirma al instante
  5. El cliente es redirigido a la página de éxito
Los códigos QR de Pix típicamente expiran después de un período determinado. Si el cliente no completa el pago a tiempo, deberá reiniciar el proceso de pago.

​
Configuración

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 de API

TipoMétodoPaís
pixPixBrasil

​
Pruebas

1

Enable test mode

Usa tus claves API de prueba de Dodo Payments.
2

Set billing currency to BRL

Asegúrate de que la moneda de cobro esté configurada en BRL en tu solicitud de pago.
3

Enter test CPF and scan the QR code

Cuando se te pida un CPF de Pix, ingresa 1234567890. Se generará un código QR de prueba: escanéalo con la cámara normal de tu teléfono (no se necesita aplicación Pix). Serás redirigido a una página de prueba de Stripe donde podrás simular la transacción como éxito o fallo.

​
Mejores Prácticas

Pix solo funciona con BRL. Asegúrate de que tus precios sean compatibles con transacciones en Real Brasileño para el mercado brasileño.
No todos los clientes brasileños pueden preferir Pix. Siempre incluye credit e debit como opciones alternativas.
Los códigos QR de Pix expiran después de un período establecido. Asegúrate de que tu proceso de pago maneje la expiración adecuadamente y permita a los clientes regenerar el código.

​
Solución de Problemas

Verificación:
  1. ¿Moneda de cobro configurada en BRL?
  2. ¿pix incluida en allowed_payment_method_types?
  3. ¿País de facturación del cliente es Brasil?
Solución: Pix solo está disponible para transacciones en BRL. Verifica la moneda y la dirección de facturación en tu solicitud API.
Causa: El cliente no completó el pago dentro del período de expiración.Solución: El cliente necesita reiniciar el proceso de pago para generar un nuevo código QR.
Causa: Los pagos de Pix se confirman al instante en la mayoría de los casos, pero pueden ocurrir retrasos ocasionales del lado del banco.Solución: Monitorea los webhooks para la confirmación del pago. Si el pago no se confirma en unos minutos, trátalo como fallido.

​
Páginas Relacionadas

Payment Methods Overview

Consulta todos los métodos de pago soportados.

Adaptive Currency

Soporte de moneda y conversión automática.

Checkout Guide

Guía completa de implementación de procesos de pago.

Webhooks

Maneja las confirmaciones de pago de manera asincrónica.
Last modified on April 1, 2026