Medios de pago · Argentina · Bolivia · Guatemala · Perú
Pagos con QR en Argentina, Bolivia, Guatemala y Perú
Muestra un QR en el checkout en Argentina, Bolivia, Perú o Guatemala. Tu cliente aprueba en la app de su banco o billetera y recibes el estado final por webhook.
- QR
- Argentina, Bolivia, Guatemala y Perú
- Pay-in
QREscanea el QR · vence en 29:59
Ya paguéDatos clave
QR con transferencia en Argentina
Cifras para Argentina, el mayor de los cuatro mercados QR de esta página (BCRA, Informe de Pagos Minoristas Anual 2025).
841,2 millones
Pagos interoperables por transferencia (PCT, principalmente QR; transacciones, 2025)
80 millones
Viajes de transporte público pagados con QR, VQR (poco menos de, 2025)
64,1%
Participación de los pagos inmediatos en las operaciones de pago minoristas (% de las operaciones, 2025)
61%
Participación de las transferencias push inmediatas que involucran una cuenta CVU (% de las transferencias, más de, 2025)
Qué es
Un método QR, cuatro mercados locales
QR es un método de pago alternativo en el que el pagador escanea un código y aprueba el pago en la app de su banco o billetera. No interviene ningún dato de tarjeta. Es asíncrono: el estado final siempre te llega por webhook firmado. Localpayment lo ofrece en Argentina, Bolivia y Perú, y en Guatemala como QR Fri (SoyFri). Los límites varían por país; revisa la tabla de datos clave.
- Argentina (1050), Bolivia (1150), Perú (6080) y Guatemala QR Fri (1870)
- El pagador aprueba en la app de su banco o billetera; sin datos de tarjeta
- Estado final por webhook firmado con el mismo endpoint Create Payin
Escanea el QR · vence en 29:59
Ya paguéCómo funciona
Cómo funciona un pago con QR
Los actores y pasos siguen el flujo documentado. El estado final siempre llega por webhook firmado.
- 1
Tu empresaLocalpayment:
Genera el QR
POST /api/payin/ con país, moneda, monto y datos del pagador. La respuesta devuelve el código QR para que el pagador lo escanee, y el pago queda pendiente hasta que llega el estado final.
- 2
ClienteBanco · QR:
El cliente escanea en la app de su banco o billetera
El pagador escanea el QR en la app de su banco o billetera y aprueba el pago.
- 3
Banco · QRLocalpayment:
Pago
Localpayment recibe la confirmación y actualiza la transacción.
- 4
LocalpaymentTu empresa:
Webhook
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
Mira QR en acción
Un recorrido simplificado y ficticio. Los nombres y montos son ejemplos.
- 1QRSe muestra al pagador un código QR (o un código para copiar y pegar).
- 2Banco EjemploEl pagador revisa PEN 120,00 y aprueba en la app de su banco o billetera.
- 3Pago confirmadoTu sistema recibe el webhook firmado y libera la orden.
Datos clave
QR: datos clave
Países
- Detalle
- 🇦🇷 Argentina · 🇧🇴 Bolivia · 🇬🇹 Guatemala · 🇵🇪 Perú
Moneda
- Detalle
- ARS · BOB · GTQ · PEN
Dirección
- Detalle
- Solo pay-in
Argentina · Pagos con QR
- Detalle
- Asíncrono, confirmado por webhook · ARS 1 – 10.000.000
Bolivia · Pagos con QR
- Detalle
- Asíncrono, confirmado por webhook · BOB 1 – 1.000.000
Guatemala · QR Fri (SoyFri)
- Detalle
- Asíncrono, confirmado por webhook · GTQ 1 – 10.000
Perú · Pagos con QR
- Detalle
- Asíncrono, confirmado por webhook · PEN 1 – 500
Estado
- Detalle
- Webhook
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 QR
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, elige la cuenta a debitar (tú nunca envías sus datos bancarios), revisa el monto y confirma. Cada QR trae una fecha de vencimiento en la respuesta: en Guatemala el código QR Fri vence cinco minutos después de generado, así que muestra una cuenta regresiva y regenéralo cuando haga falta.
Límites documentados
Pagos con QR (Pay-in): ARS 1 – 10.000.000 · Pagos con QR (Pay-in): BOB 1 – 1.000.000 · QR Fri (SoyFri) (Pay-in): GTQ 1 – 10.000 · Pagos con QR (Pay-in): PEN 1 – 500. 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 QR en cinco pasos
La misma secuencia para todos los rieles. Mira el checkout animado de este país antes de construir.
Obtén credenciales de Stage
Solicita acceso, recibe credenciales de sandbox y obtén un JWT con POST /api/token/.
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.
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.
Verifica el webhook
Valida x-Signature (HMAC-SHA256), libera la orden con el estado 200 y deduplica por externalId.
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 el QR se volvió interoperable en la región
Fuentes: BCRA, Informe de Pagos Minoristas Anual 2025; Banco Central de Bolivia; BCRP, Circular 024-2022-BCRP; Banco de Guatemala.
Argentina: Transferencias 3.0
El BCRA hace interoperables los pagos con QR por transferencia: cualquier billetera o app bancaria puede pagar cualquier QR, obligatorio desde fines de 2021.
Perú: circular de interoperabilidad
El BCRP ordena a billeteras y bancos interoperar; desde 2023 los códigos QR pueden leerse tanto desde apps bancarias como desde billeteras.
Bolivia: el QR crece 48 veces
El esquema de QR interoperable del Banco Central de Bolivia lleva el valor pagado con QR de BOB 3,2 mil millones en 2021 a BOB 157 mil millones en 2024.
Argentina: 841 millones de transferencias QR
Los pagos con transferencia (PCT, principalmente QR) alcanzan 841 millones de operaciones, +40,7% en el año, más casi 80 millones de viajes en transporte pagados con QR.
Por qué Localpayment
Por qué usar QR con Localpayment
Una API para pay-ins y payouts
QR 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.
Sigue explorando
Pay-ins
Cobra en moneda local con los métodos que la gente realmente usa.
Pay-ins —Argentina
Métodos, rieles, monedas y licencias en Argentina.
Argentina —CVU & COELSA
Rieles, límites y flujo, paso a paso.
CVU & COELSA —Debin
Rieles, límites y flujo, paso a paso.
Debin —Métodos por país
El directorio completo de pay-ins y rieles de payout documentados.
Métodos por país —
Preguntas frecuentes
QR: preguntas frecuentes
¿Dónde está disponible QR?
En Argentina (código 1050), Bolivia (1150), Perú (6080) y Guatemala, donde se llama QR Fri o SoyFri (1870).
¿Cómo se confirma el pago?
QR es asíncrono. El pagador aprueba en la app de su banco o billetera y 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?
Bolivia: de BOB 1 a 1.000.000. Perú: de PEN 1 a 500. Guatemala: de GTQ 1 a 10.000. Argentina: de ARS 1 a 10.000.000. Confirma tus límites con tu ejecutivo de cuenta.
¿Necesito la cuenta bancaria del pagador para crear un QR?
No. En Argentina la documentación es explícita: no envías la cuenta del pagador; el cliente la selecciona al escanear. Lo mismo aplica a los flujos QR de Bolivia y Perú.
¿De qué tamaño debe ser el QR?
Muéstralo con un mínimo de 250×250 píxeles (como documenta Bolivia) y buen contraste, y coloca el monto al lado para que el pagador lo verifique antes de confirmar.
¿Cómo se gestionan los reembolsos de QR?
Solo totales, con PATCH /api/payin/{externalId}/refund sobre un pay-in completado. En Argentina la solicitud de reembolso lleva los datos bancarios del pagador para devolver el dinero por la red local.
¿Qué apps pueden pagar un QR Fri en Guatemala?
La documentación enumera la billetera Fri y las apps de los bancos participantes y de las cooperativas Micoope; dos grandes bancos están excluidos. Revisa la lista vigente en la documentación antes de salir a producción.
Suma QR a tus cobros
Cuéntanos tus mercados y volúmenes. Empiezas con credenciales de Stage (sandbox) y te acompañamos hasta el go-live.