Saltar al contenido

Medios de pago · Brasil

Pix en Brasil: pagos inmediatos, de entrada y de salida

Cobra con código QR o Copia e Cola, asigna llaves Pix a tus clientes y paga a beneficiarios en tiempo real, 24/7, desde una sola integración.

  • Transferencia inmediata
  • Brasil
  • Pay-in · Payout

Datos clave

Pix a escala nacional

Cifras publicadas por el Banco Central de Brasil.

Qué es

El riel de pagos inmediatos de Brasil

Pix es el sistema de pagos inmediatos creado por el Banco Central de Brasil. El pagador aprueba en la app de su banco y el dinero se mueve entre cuentas en segundos, a cualquier hora. Con Localpayment lo usas de tres formas: como método de pay-in, como cuenta virtual identificada por una llave Pix y como riel de payouts.

  • Pay-in con código QR o Copia e Cola, confirmado por webhook
  • Cuenta virtual con llave Pix (email, teléfono o aleatoria) que también recibe TED
  • Payouts Pix en tiempo real, 24/7, y TED para transferencias el mismo día o T+1

Cómo funciona

Cómo funciona un pago con Pix

Los actores y pasos siguen el flujo documentado. El estado final siempre llega por webhook firmado.

  1. 1

    ClienteTu empresa:

    Elige Pix

    En tu checkout o mediante un link de pago.

  2. 2

    Tu empresaLocalpayment:

    Crea el pay-in

    POST /api/payin/ con país, moneda, monto y datos del pagador. La respuesta incluye la imagen del QR Pix y el código Copia e Cola, con fecha de vencimiento. Estado 100 (INPROGRESS).

  3. 3

    ClienteBanco · Pix:

    Aprueba en la app del banco o billetera

    El pagador escanea el QR o pega el código en la app de su banco y confirma el pago.

  4. 4

    LocalpaymentTu empresa:

    Webhook con el estado final

    Localpayment recibe la confirmación y actualiza la transacción. Firmado con HMAC-SHA256 (x-Signature). El estado 200 indica completado; deduplica por externalId.

Diagrama simplificado. Los tiempos dependen del riel y del banco; consulta los datos clave más abajo.

Cómo funciona

Cómo funciona un payout con Pix

Los actores y pasos siguen el flujo documentado. El estado final siempre llega por webhook firmado.

  1. 1

    Tu empresaLocalpayment:

    Envía la solicitud de payout

    POST /api/payout/ con los datos del beneficiario, el monto y el externalId. Se aplican controles de cumplimiento; con requireAuth, un segundo aprobador firma antes de mover los fondos.

  2. 2

    LocalpaymentBanco · Pix:

    Bloquea los fondos y envía la instrucción

    El payout pasa de Locked a In Progress por Pix.

  3. 3

    Banco · PixBeneficiario:

    Acredita al beneficiario

    Los tiempos dependen del riel; consulta los datos clave más abajo.

  4. 4

    LocalpaymentTu empresa:

    Webhook: payout completado

    Localpayment actualiza el payout a su estado final. Webhook firmado con el estado final; puedes descargar el comprobante de pago.

Diagrama simplificado. Los tiempos dependen del riel y del banco; consulta los datos clave más abajo.

Cómo funciona

Mira Pix en acción

Un recorrido simplificado y ficticio. Los nombres y montos son ejemplos.

  1. 1PixSe muestra al pagador un código QR (o un código para copiar y pegar).
  2. 2Banco EjemploEl pagador revisa BRL 249,90 y aprueba en la app de su banco o billetera.
  3. 3Pago confirmadoTu sistema recibe el webhook firmado y libera la orden.

Datos clave

Pix: datos clave

  • País

    Detalle
    🇧🇷 Brasil
  • Moneda

    Detalle
    BRL
  • Dirección

    Detalle
    Pay-in y payout
  • Pay-in · Pix (QR y Copia e Cola)

    Detalle
    En tiempo real, confirmado por webhook · BRL 0,01 – 1.000.000
  • Pay-in · Cuenta virtual (Pix or TED)

    Detalle
    En tiempo real, confirmado por webhook · BRL 0,01 – 2.000.000
  • Payout · Pix

    Detalle
    En tiempo real, 24/7 · Mín. BRL 0,06, sin máximo
  • Payout · Transferencia bancaria (TED)

    Detalle
    Mismo día o T+1, corte 17:00 hora de Brasilia
  • Liquidación de payouts

    Detalle
    En tiempo real, 24/7, incluidos fines de semana y feriados

Tomados de la documentación de Localpayment de cada país. Los límites y la disponibilidad pueden cambiar; confírmalos con tu ejecutivo de cuenta.

Experiencia del cliente

Qué ve tu cliente con Pix

Autorización, límites y reembolsos según docs.localpayment.com. Los límites se muestran solo cuando la documentación los indica.

  • Cómo autoriza el cliente

    El cliente escanea el QR con la app de su banco o billetera, o pega el código Copia e Cola en el campo “Pagar con código Pix” de la app, revisa el monto y confirma. La respuesta trae una fecha de vencimiento; muestra una cuenta regresiva y crea un nuevo pay-in si expira.

  • Límites documentados

    Pix (QR y Copia e Cola) (Pay-in): BRL 0,01 – 1.000.000 · Cuenta virtual (Pix or TED) (Pay-in): BRL 0,01 – 2.000.000 · Pix (Payout): Mín. BRL 0,06, sin máximo. Por transacción, según la documentación publicada; los límites contractuales pueden variar.

  • Reembolsos y devoluciones

    Un pay-in completado se reembolsa con PATCH /api/payin/{externalId}/refund. Solo se admiten reembolsos totales; el dinero vuelve a una cuenta bancaria del pagador y la transacción termina en estado 902 (REFUNDED). Mientras el pago sigue pendiente, puede cancelarse.

Checklist de integración

Sal a producción con Pix en cinco pasos

La misma secuencia para todos los rieles. Mira el checkout animado de este país antes de construir.

  1. Obtén credenciales de Stage

    Solicita acceso, recibe credenciales de sandbox y obtén un JWT con POST /api/token/.

  2. Crea el pay-in

    POST /api/payin/ con el código Localpayment de la tabla de datos clave, país ISO-3, moneda, monto y datos del pagador.

  3. Muestra las instrucciones

    Muestra el QR, el código, la redirección o los datos de cuenta de la respuesta y respeta la fecha de vencimiento.

  4. Verifica el webhook

    Valida x-Signature (HMAC-SHA256), libera la orden con el estado 200 y deduplica por externalId.

  5. Mira el checkout animado

    Cada método de este país, pantalla por pantalla, en la galería de experiencias de checkout.

Historia

Cómo Pix se volvió la forma habitual de pagar

Fuente: Banco Central do Brasil, Relatório de Gestão do Pix 2023–2025.

  1. Lanzamiento

    El Banco Central de Brasil lanza Pix sobre su infraestructura SPI: transferencias inmediatas entre cualquier cuenta, 24/7, direccionadas por llaves.

  2. Retiro de efectivo y funciones para comercios

    Pix Saque y Pix Troco permiten retirar efectivo en comercios; el QR dinámico y Copia e Cola convierten a Pix en un método de checkout.

  3. Pix Automático

    Los pagos recurrentes entran en operación el 16 de junio de 2025, junto con Pix Agendado, Pix sin contacto y la iniciación de pagos de Open Finance.

  4. Cerca de 80 mil millones de transacciones

    Pix procesa 79,8 mil millones de transacciones en el año, 43% de persona a empresa, con más de 920 millones de llaves registradas.

Por qué Localpayment

Por qué usar Pix con Localpayment

  • Una API para pay-ins y payouts

    Pix funciona con la misma API que el resto de los métodos: POST /api/payin/ para cobrar, POST /api/payout/ para pagar y nuevos mercados por configuración.

  • Estado por webhook en cada transacción

    Cada cambio de estado llega a tu endpoint firmado con HMAC-SHA256, para que lo verifiques y automatices.

  • Conciliación en el Business Portal

    Concilia cada transacción con tu externalId y nuestro internalId, con reportes del Business Portal y APIs de saldo.

Preguntas frecuentes

Pix: preguntas frecuentes

¿Qué tan rápido se confirma un pago Pix?

Pix es un riel en tiempo real que confirma en segundos, 24/7. En los pay-ins el estado final te llega por webhook firmado, así que diseña el flujo de tus órdenes a partir de esa notificación.

¿Cuáles son los límites?

El rango documentado para pay-ins es de BRL 0,01 a 1.000.000 por transacción. Los payouts Pix parten de BRL 0,06 y no tienen máximo documentado. Revisa la tabla de datos clave y confirma tus límites con tu ejecutivo de cuenta.

¿Puedo enviar payouts por Pix y por TED?

Sí. Los payouts Pix son en tiempo real, 24/7. También está disponible TED para transferencias el mismo día o T+1, con corte a las 17:00 hora de Brasilia.

¿Qué tipos de llave Pix puede usar una cuenta virtual?

Una cuenta virtual de Localpayment en Brasil incluye una llave Pix (email, teléfono o aleatoria) y datos de banco, agencia y cuenta, que se devuelven al crearla. El pagador envía un Pix a la llave, o un Pix o TED a los datos de la cuenta: ambos rieles acreditan la misma cuenta y disparan el mismo webhook.

¿Puedo reembolsar un pago Pix de forma parcial?

No. Los reembolsos Pix con Localpayment son solo totales y se solicitan con PATCH /api/payin/{externalId}/refund sobre una transacción completada. El dinero vuelve al pagador y el pay-in termina en estado 902 (REFUNDED).

¿Pix tiene contracargos?

Pix es un pago push que el pagador autoriza en la app de su propio banco, así que no existe el contracargo al estilo tarjeta. Las disputas se resuelven con reembolsos que inicias tú.

¿El código QR vence?

Sí. Cada respuesta de pay-in incluye qr.expirationDate. Muestra una cuenta regresiva en tu checkout y, cuando venza, crea un nuevo pay-in en lugar de reutilizar el código.

Suma Pix a tus cobros

Cuéntanos tus mercados y volúmenes. Empiezas con credenciales de Stage (sandbox) y te acompañamos hasta el go-live.

¿Cómo podemos ayudarte?

Descarga tu ejemplar

Déjanos tus datos y obtén la edición completa al instante.