Tu proveedor en Curitiba no te mandó datos bancarios. La factura termina con un código QR y un texto largo llamado Pix Copia e Cola, y tu banco en el exterior no sabe qué hacer con eso.
Los pagos con código QR de Pix a Brasil usando stablecoins resuelven ese problema. Fondeas en USDC o USD, bloqueas una cotización y el código se paga en reales (BRL) a través del sistema Pix de Brasil.
Así se cobra hoy en Brasil. Los códigos QR dinámicos iniciaron cerca del 40% de todas las transacciones Pix en 2025, frente a 5% en 2021, según el Banco Central do Brasil (BCB). Además, 12,8 millones de empresas hicieron o recibieron un pago Pix en diciembre de 2025.
En esta guía verás qué contiene un código QR de Pix y por qué a los pagadores extranjeros se les complica. Luego te explicamos el flujo con stablecoins y te mostramos tu primer pago con QR por dashboard y por API.
Por qué pagar un código QR de Pix desde el exterior es más difícil de lo que debería
Los códigos QR de Pix hacen que pagar en Brasil sea fácil para cualquiera con una cuenta brasileña. Todos los demás chocan contra una pared.
Tu banco extranjero no puede pagar un código Pix. Pix es un sistema local brasileño. La salida habitual es una transferencia internacional a la cuenta del proveedor, y eso desperdicia todo lo que el código hacía por ti.
El código fija el cobro. Un código dinámico trae el monto y un identificador de transacción. Según los estándares de iniciación de Pix del BCB, el pagador solo puede cambiar el monto si el emisor lo permite. Una transferencia que llega incompleta por descuentos bancarios rompe esa conciliación.
Los códigos dinámicos vencen. Si el emisor no define un vencimiento, un cobro dinámico se puede pagar durante 24 horas desde su creación. Una transferencia que tarda tres días pierde esa ventana por completo.
Las transferencias internacionales cuestan caro. Enviar montos pequeños al exterior cuesta en promedio 6,36% del monto enviado, según el Banco Mundial. Con US$20.000 al mes en facturas brasileñas, ese promedio te costaría US$1.272 cada mes.
Pagos con código QR de Pix en Brasil con stablecoins: cómo funciona
Yativo es infraestructura de pagos, no un banco. Usamos stablecoins como capa de liquidación entre tu saldo y Brasil. Luego, un socio de pago local licenciado paga el código Pix en destino.
- Fondeas tu saldo float en Yativo con un depósito en moneda fiat o en stablecoins, como USDC.
- Yativo convierte el valor del pago a USDC y lo liquida on-chain.
- Un socio de pago local licenciado en Brasil recibe la liquidación en stablecoins.
- El socio convierte USDC a BRL y paga el código QR por Pix.
- Tu proveedor recibe reales contra el cobro exacto que emitió.
Tu proveedor no necesita una billetera cripto. Nunca ve ni toca stablecoins. Para él, el cobro simplemente aparece pagado, como cualquier Pix de un cliente brasileño.
Si quieres ver el paso de conversión en detalle, lee cómo se mueven los fondos de USD a BRL.
Código QR de Pix estático vs dinámico: qué estás pagando
Todo código QR de Pix sigue el estándar BR Code, que adapta el estándar EMV para códigos QR de pago, según el manual de iniciación de Pix del BCB. Hay dos tipos.
Código QR estático. Todos los datos del pago están dentro del código. Debe contener una clave Pix válida y puede incluir un monto, un identificador de transacción y un campo de texto libre. Los comercios pequeños suelen imprimir uno y reutilizarlo.
Código QR dinámico. El código apunta a una URL que devuelve los detalles del cobro, como monto, identificador y vencimiento. Las empresas generan uno nuevo por factura, lo que les permite conciliar pagos automáticamente.
Pix Copia e Cola. Es la versión en texto del mismo código. Tu destinatario puede pegarlo en un correo o en la factura, y tú puedes pegarlo en un formulario de pago sin escanear nada.
Rieles de pago disponibles para Brasil
Los métodos de pago activos de Yativo en BRL cubren códigos QR de Pix, claves Pix y cuentas bancarias. Esta guía se enfoca en pagar un código QR de Pix.
Pay with QR (off-ramp)
El gateway 904 paga un código QR de Pix en BRL, con fondos de tu saldo en USD. Úsalo si tienes USD o USDC.
Datos requeridos: los campos que devuelve el formulario de este gateway, normalmente el código Pix Copia e Cola.
Tiempo de liquidación: tu cotización muestra el tiempo de entrega antes de confirmar.
Ideal para: facturas de proveedores, cuentas de servicios y cobros de marketplaces que vienen con un código Pix.
Pay with QR
El gateway 903 paga el mismo tipo de código desde un saldo en BRL. Sirve a empresas que ya cobran en reales, por ejemplo con una cuenta virtual BRL (Pix) en Yativo.
Clave Pix y transferencia bancaria
Si tu destinatario te comparte una clave Pix en vez de un código, revisa nuestra guía de pagos con Pix a Brasil. Si solo te manda banco, agencia y cuenta, revisa nuestra guía de transferencias bancarias locales a Brasil.
Alternativa en USD
Si tu destinatario quiere dólares, un código Pix no es la herramienta correcta. Los métodos de Yativo para Brasil también incluyen SWIFT, gateway 547, que paga en USD. Revisa la lista en vivo antes de construir, porque la disponibilidad depende de tu cuenta.
Ambos métodos QR requieren el endorsement de Brasil. Tras la aprobación de KYC o KYB, Yativo otorga endorsements que definen qué rieles puede usar cada cliente.
Qué pedirle a tu destinatario antes de pagar
El formulario de pago de tu gateway es la lista oficial de campos. Pide estos elementos a tu proveedor con cada factura.
- El texto Pix Copia e Cola: la versión en texto del código QR, copiada tal cual.
- La imagen del código QR: como respaldo si el texto se corta en un correo.
- Monto en BRL: necesario si el código es estático y no trae monto.
- Fecha de vencimiento: para pagar un código dinámico mientras siga vigente.
- Nombre legal y CNPJ o CPF: para compararlos con el beneficiario que muestran tu cotización y tu comprobante.
- Número de factura: para tu propia conciliación.
Cómo enviar un pago con código QR de Pix con Yativo
Opción 1: dashboard (para pagos manuales)
- Fondea tu saldo float en Yativo con un depósito en moneda fiat o en stablecoins.
- Ve a Transfer en tu dashboard de Yativo.
- Selecciona la billetera float con la que vas a pagar, por ejemplo USD, EUR, MXN o el saldo que hayas fondeado.
- Elige el cliente en cuyo nombre estás pagando. Este paso es necesario para las fintechs que procesan pagos en nombre de sus clientes.
- Elige Brasil como país de destino y el método de pago Pay with QR.
- Ingresa los datos que pide el formulario, como el código Pix Copia e Cola de la factura.
- Ingresa el monto en USD o BRL.
- Revisa la cotización: tipo de cambio, comisiones, tiempo de entrega y el monto exacto en BRL que recibe el código.
- Confirma con tu PIN y 2FA.
- Sigue el pago en tiempo real y descarga el comprobante para tus registros.
Opción 2: API (para pagos automatizados y masivos)
Todos los endpoints de abajo están en la documentación de la API de Yativo. Las llamadas de producción van a https://api.yativo.com/api/v1 y el sandbox funciona en https://smtp.yativo.com/api/v1.
Autentica cada solicitud con los headers X-Api-Key y X-Api-Secret, y agrega las IP de tus servidores a la lista permitida de cada key. Los tokens de login dejan de funcionar desde servidores el 15 de octubre de 2026, como explicamos en nuestra actualización de octubre. Cada solicitud POST también necesita un header Idempotency-Key único.
Paso 1. Genera una dirección de fondeo en USDC sobre Solana para recargar tu saldo en USD:
POST https://api.yativo.com/api/v1/crypto/create-wallet
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 7a1b2c3d-4e5f-4061-8a9b-0c1d2e3f4a5b
Content-Type: application/json
{
"currency": "USDC_SOL"
}Paso 2. Lista los métodos de pago disponibles para Brasil:
curl "https://api.yativo.com/api/v1/payment-methods/payout?country=BRA" \
-H "X-Api-Key: $YATIVO_API_KEY" \
-H "X-Api-Secret: $YATIVO_API_SECRET" \
-H "Accept: application/json"Busca en la respuesta Pay with QR (off-ramp), gateway 904. Los ejemplos de abajo usan 904.
Paso 3. Obtén los campos requeridos para ese gateway:
GET https://api.yativo.com/api/v1/beneficiary/form/show/904
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRETLa respuesta lista cada campo requerido y sus valores aceptados. Arma tu objeto payment_data a partir de ella. Para los nombres de los campos, revisa la documentación de la API.
Paso 4. Crea el método de pago. Reemplaza el marcador con los campos que devolvió el formulario:
POST https://api.yativo.com/api/v1/beneficiaries/payment-methods/
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 3e4f5a6b-7c8d-4e9f-a0b1-c2d3e4f5a6b7
Content-Type: application/json
{
"gateway_id": 904,
"nickname": "Distribuidora Curitiba Ltda",
"currency": "BRL",
"customer_id": "e8caa491-57b6-4c39-9e3a-d2c97e47fbf0",
"payment_data": {
"{field_from_form}": "{value}"
}
}Paso 5. Bloquea tu tipo de cambio. Las cotizaciones duran 5 minutos, así que pide una justo antes de pagar:
POST https://api.yativo.com/api/v1/exchange-rate
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d
Content-Type: application/json
{
"from_currency": "USD",
"to_currency": "BRL",
"method_id": 904,
"method_type": "payout",
"amount": 2000
}Paso 6. Inicia el pago desde tu saldo en USD:
POST https://api.yativo.com/api/v1/wallet/payout
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a
Content-Type: application/json
{
"debit_wallet": "USD",
"amount": 2000,
"payment_method_id": 4824,
"customer_id": "e8caa491-57b6-4c39-9e3a-d2c97e47fbf0",
"quote_id": "4a72ecf8-6c8a-4e38-9971-8aabe9f785ed"
}Usa el id de la respuesta del método de pago como payment_method_id. Si pagas desde un saldo en BRL con el gateway 903, debita tu billetera BRL. Para pagos masivos, repite la llamada por código, como explicamos en nuestra página de pagos.
¿Qué opción de pago a Brasil te conviene?
| Código QR de Pix con Yativo | Clave Pix con Yativo | Transferencia bancaria con Yativo | Transferencia internacional (SWIFT) | |
| Velocidad de liquidación | Indicada en tu cotización | Indicada en tu cotización | Indicada en tu cotización | Depende de los bancos corresponsales |
| Datos requeridos | Código Pix Copia e Cola | Clave Pix y documento | Documento, banco, agencia, cuenta | Código SWIFT, cuenta, dirección del banco |
| Ideal para | Facturas con código Pix | Destinatarios con clave Pix | Facturas con datos bancarios | Transferencias grandes y puntuales en USD |
| Disponibilidad | Gateways 904 y 903 | Gateways 494, 897, 1276 | Gateways 495 y 898 | Gateway 547 |
| Moneda recibida | BRL | BRL | BRL | USD |
Buenas prácticas para pagos con código QR de Pix
Paga los códigos dinámicos antes de que venzan. Un código sin vencimiento definido dura 24 horas. Pide a tus proveedores que envíen la factura el día que planeas pagar, o que definan un vencimiento más largo.
Cotiza en BRL cuando el código fija el monto. Ingresa el monto en BRL de la factura y fondéalo desde USD. Así el proveedor recibe exactamente lo que pide el código.
Usa el texto, no una foto. Copiar el texto Pix Copia e Cola evita errores de lectura de un PDF impreso o borroso.
Revisa el beneficiario antes de confirmar. Compara el nombre y el CNPJ de la factura con el beneficiario que muestra tu flujo en Yativo. Detente si no coinciden.
Elige el saldo que se ajusta a tu tesorería. Usa el gateway 904 para fondos en USD o USDC y el 903 si ya tienes reales.
Lee los gateway IDs en tiempo de ejecución. Yativo dio de baja varios rieles el 2 de septiembre de 2026. Obtén los IDs desde el endpoint de métodos de pago para que tu integración resista cambios futuros.
Preguntas frecuentes
¿Mi proveedor en Brasil necesita una billetera cripto?
No. Tu proveedor no necesita una billetera cripto. Su cobro Pix se paga en reales en su cuenta habitual, y nunca interactúa con stablecoins.
¿Es legal y cumple con la normativa pagar así facturas brasileñas?
Sí, cuando el pago pasa por infraestructura regulada. Yativo está registrada ante FinCEN como Money Services Business, con el número de registro 31000270723339. Un socio de pago local licenciado hace el pago Pix en Brasil. Tus propias obligaciones tributarias y de reporte siguen vigentes, así que confírmalas con tu asesor de cumplimiento.
¿Cuánto demora un pago con código QR de Pix?
Tu cotización en Yativo muestra el tiempo de entrega antes de confirmar. Del lado brasileño, Pix funciona las 24 horas, todos los días del año.
¿Puedo pagar un código QR de Pix estático?
Sí, si la lista de métodos y el formulario lo aceptan para tu cuenta. Un código estático puede no traer monto, así que acuerda antes el monto en BRL con tu destinatario.
¿Qué hago si el código QR venció?
Pídele a tu destinatario un código nuevo. Un código dinámico sin vencimiento definido dura 24 horas, y el proveedor del destinatario puede dejar de servir cobros vencidos.
¿Mi destinatario puede recibir dólares en lugar de reales?
No con Pix, que liquida en BRL. Los métodos de Yativo para Brasil también incluyen SWIFT, gateway 547, que paga en USD. Revisa la lista en vivo para ver qué puede usar tu cuenta.
Empieza a pagar códigos QR de Pix desde tu saldo en USDC
Los códigos QR dinámicos ya inician cerca del 40% de todos los pagos Pix, así que cada vez más facturas brasileñas llegarán con uno. Yativo te permite fondear en USDC o USD y pagar esos códigos en BRL con un socio de pago local licenciado. Tu cotización muestra el tipo de cambio, las comisiones y el tiempo de entrega antes de confirmar. Agenda una demo para configurar tu primer pago con QR de Pix.
Fuentes
- Banco Central do Brasil: Relatório de Gestão do Pix 2023-2025
- Ministério da Fazenda: Pix consolida liderança nos pagamentos digitais e projeta novas evoluções até 2030
- Banco Central do Brasil: Manual de Padrões para Iniciação do Pix
- Banco do Nordeste: Pix: pagamentos e transferências instantâneas
- Banco Mundial: Remittance Prices Worldwide
- Yativo: Documentación de la API de Yativo
- Yativo: Safer API access, three new virtual accounts and new payment links
- Yativo: Important Update: Streamlining Our Rail Network Effective September 2, 2026