Para cobrar con QR dentro de una tienda en línea o una app, tu servidor pide un QR dinámico (con monto y referencia del pedido) a la API de un banco, a OpenBCB del Banco Central de Bolivia (BCB) o a una pasarela de pagos. Lo muestras al cliente, que lo paga desde la app de cualquier banco o cooperativa, y marcas el pedido como pagado solo cuando la API confirma el abono. Esta guía resume lo que cada opción documenta en su sitio oficial, verificado el 10 de noviembre de 2026.
Cómo viaja un pago QR
El QR BCB Bolivia es la especificación que el BCB fija para que los pagos con QR sean interoperables, según el glosario de su Informe de Vigilancia del Sistema de Pagos 2025. La norma de fondo es el Reglamento de Servicios de Pago, Instrumentos Electrónicos de Pago, Compensación y Liquidación, aprobado con la RD 079/2022 y modificado por la RD 111/2024 y la RD 140/2025. Ese reglamento define el pago inmediato como una transferencia cuyo mensaje, respuesta y disponibilidad de fondos ocurren en tiempo real, las 24 horas, los 7 días de la semana.
El dinero sale del banco del cliente y viaja por el Módulo de Liquidación Diferida (MLD) del BCB o por una cámara de compensación. Según la lista de la ASFI al 30 de septiembre de 2026, hay dos administradoras de cámaras de compensación y liquidación con licencia: ACCL S.A. y UNILINK S.A.
Un dato que afecta a tu integración: la RD 019/2025 obliga a los bancos a habilitar por defecto los pagos con QR hasta Bs69.600, y el cliente puede cambiar ese límite. Si un pago grande falla, puede ser el límite del que paga, no tu sistema.
Tres caminos para integrarlo
| Camino | Qué documenta públicamente | Requisito principal |
|---|---|---|
| API de tu banco | BNB, BCP y BISA describen servicios para generar QR desde tu sistema | Ser cliente y firmar contrato con el banco |
| OpenBCB (BCB) | Generación de QR, consulta de estado, órdenes de pago y notificaciones | Cuenta transitoria en el BCB y conexión por VPN o IP fija |
| Pasarela de pagos | Depende de cada empresa | Contrato con la pasarela |
Fuentes: sitios oficiales de cada entidad y guía de Open BCB, consultados el 10/11/2026.
API de un banco
- BNB. Su página de Open Banking ofrece la «API QR Simple» y describe el proceso: contacto, acceso a la API, pruebas y contrato. Su sandbox público muestra los métodos: un token con identificadores que entrega el banco, la generación de un QR con moneda, monto, glosa, fecha de vencimiento y uso único, la consulta de estado (no usado, usado, expirado o con error) y la lista de QR generados en una fecha.
- BCP. Su página APIs Pagos QR Simple lista la generación de QR, la consulta de pagos y la información para generar pagos. La página no publica la documentación técnica ni el precio: hay que pedirlos al banco.
- BISA. Bisa QR para Empresas menciona una API Key para integrar el cobro en tiendas virtuales, QR por transacción o en lotes, cajas y reportes.
Otras entidades pueden ofrecer integraciones por su área comercial. Aquí solo listamos las que encontramos documentadas en su sitio.
OpenBCB
El BCB lanzó OpenBCB en octubre de 2025 (comunicado CP44/2025) para instituciones públicas y privadas que no habían podido automatizar su cobranza. Funciona con el Reglamento de Cuentas Transitorias de Liquidación (RD 031/2025, modificada por la RD 088/2025). Según la guía de adhesión:
- La empresa envía una nota firmada por su gerente general o máxima autoridad, con razón social y NIT, más una declaración de aceptación del reglamento. Los modelos están en la página de Open BCB.
- Si el BCB la ve viable, la empresa llena un formulario de conexión: VPN sitio a sitio (preferente) o IP pública fija, con un contacto de redes y otro de infraestructura. La conexión se reacredita cada seis meses.
- El BCB entrega credenciales, la empresa integra sus servicios web y se hacen pruebas antes de habilitar la cuenta.
El cliente paga a la cuenta transitoria en el BCB, OpenBCB notifica a la empresa y luego transfiere el dinero a su cuenta bancaria de forma asíncrona. El mantenimiento de la cuenta no tiene costo. Ojo: si la cuenta pasa más de dos meses sin movimiento, el BCB puede suspenderla hasta siete días.
Pasarela de pagos
El reglamento del BCB distingue dos tipos de pasarela: el agregador, que recibe los pagos, los agrupa y los transfiere al comercio en un plazo, y el facilitador, que solo enruta la transacción, de modo que el dinero va directo a la cuenta del comercio. El contrato entre el banco y la pasarela debe fijar la liquidación al comercio en 48 horas como máximo, salvo fines de semana y feriados, cuando el abono puede pasar al día hábil siguiente (artículo 37 de la RD 079/2022). Con la RD 140/2025, las empresas de tecnología financiera que canalizan pagos electrónicos deben adecuarse al reglamento de Empresas de Tecnología Financiera (ETF) de la ASFI, en los plazos que esta disponga. Antes de firmar, revisa si la empresa figura en la lista de ETF en proceso de adecuación o ya tiene licencia.
Las administradoras de tarjetas también procesan QR en sus POS y plataformas de comercio electrónico. Lo explicamos en cobrar con tarjeta, POS o enlace de pago.
El flujo técnico, paso a paso
- Crea el pedido en tu base de datos con un identificador único, el monto y el estado «pendiente».
- Pide el QR desde tu servidor, nunca desde el navegador o la app, para que las credenciales no queden expuestas. Usa monto fijo, uso único, un vencimiento corto y el número de pedido en la glosa o referencia.
- Muestra el QR. Si el cliente compra desde el mismo celular, no puede escanear su propia pantalla. Ofrece descargar la imagen para que la abra en la app de su banco, si esta lo permite.
- Espera la confirmación por notificación (webhook) si tu proveedor la ofrece, y consulta el estado como respaldo, por ejemplo cada pocos segundos mientras el cliente está en la página de pago.
- Valida antes de marcar «pagado»: que el identificador del QR, el monto y la moneda coincidan con el pedido. Procesa cada pago una sola vez, aunque la notificación llegue repetida.
- Si el QR vence, genera uno nuevo y anula el anterior en tu sistema.
- Concilia cada día tus pedidos pagados contra el reporte o el extracto del banco. Revisa sobre todo los pagos que llegaron después de cancelar un pedido, porque tendrás que devolverlos.
Seguridad
La ASFI señala entre los riesgos del QR la falsificación de comprobantes, la suplantación de códigos y las fallas técnicas que generan operaciones fallidas o duplicadas (nota de la ASFI). En una integración eso se traduce en estas reglas:
- La captura de pantalla no confirma nada. Solo la respuesta de la API del banco o de OpenBCB.
- No confíes en lo que llega del navegador, como un parámetro «pagado=true» en la URL de retorno.
- Autentica las notificaciones. Pregunta a tu proveedor cómo firma o identifica sus avisos (token, firma, IP de origen) y rechaza los demás.
- Guarda las credenciales en el servidor, con permisos mínimos y rotación.
- Usa QR de uso único para la tienda en línea. Un QR fijo reutilizable no te dice qué pedido se pagó.
Cuánto cuesta
- Para el que paga: la RD 019/2025 fija como tarifa máxima por banca móvil o internet Bs0 hasta Bs69.600, Bs5 entre Bs69.601 y Bs100.000, y Bs10 por encima de Bs100.000.
- OpenBCB: la generación de QR y las notificaciones son gratuitas, según el comunicado del BCB.
- API de un banco: las páginas de BNB, BCP y BISA no publican el precio del servicio. La RD 019/2025 prohíbe cobrar por generar el QR y por las notificaciones solo a empresas y entidades del sector público. Si tu empresa es privada, pide la tarifa por escrito.
- Pasarela: la comisión se fija en el contrato.
Facturación y bancarización
El comprobante del QR no es una factura. Lo práctico es emitir la factura cuando la API confirma el pago y guardar la referencia del pago junto al número de factura. Si facturas desde tu propio sistema, revisa cómo conectarlo al SIAT.
Para ventas de Bs50.000 o más, el pago debe respaldarse con un documento de una entidad financiera, y la separata de bancarización del SIN incluye el QR entre las transferencias válidas. Más detalles en la guía de bancarización.
Errores comunes
- Marcar el pedido como pagado al mostrar el QR o al recibir una captura.
- Pedir el QR desde el frontend y dejar las credenciales en el código del cliente.
- No manejar el vencimiento ni los pagos que llegan tarde.
- Olvidar el límite de Bs69.600 que traen por defecto las apps de los clientes.
- Tratar el comprobante del QR como si fuera la factura.
Si buscas cobrar con QR en un local, sin integración, lee la guía de cobros con QR para negocios. Para el marco legal de vender por internet, revisa esta guía.
