Desarrollo

API QR en Bolivia: OpenBCB y cómo cobrar desde tu sistema

David Morales Vega7 de noviembre de 202611 min de lectura
black android smartphone displaying qr code
Foto: Markus Winkler en Unsplash

Quien busca «API QR» en Bolivia casi nunca quiere una API por gusto. Quiere que su tienda, su app o su sistema de cuotas haga lo mismo que hace la app del banco cuando generas un QR de cobro, pero solo: un QR por cada venta, con el monto exacto, y un aviso cuando el cliente pagó. Sin capturas por WhatsApp ni extractos revisados a mano.

El problema es que la información está desparramada: el Banco Central lanzó OpenBCB en 2025, los bancos hablan de QR para personas y casi ninguno publica su API para empresas. Aquí lo ordenamos: el ecosistema, OpenBCB, qué hace una API QR, qué publica cada banco, qué te van a pedir y cuándo conviene integrar directo. Revisamos las fuentes oficiales en noviembre de 2026. Si buscas el paso a paso de un cobro y sus trampas, eso ya está en cómo cobrar con QR desde tu propio sistema.

¿Qué es una API QR?

Una API QR es la puerta por la que un sistema le pide a un banco que genere un QR de cobro y le pregunta si ya se pagó. Hace por programa lo que tú haces en la app del banco, pero para cada venta, con su monto y su referencia, y sin que nadie toque nada.

La diferencia con el QR impreso es la referencia: el del mostrador es el mismo para todos, y cuando entra un pago de Bs 150 nadie sabe de qué pedido es. El que genera una API es único para cada cobro, así que tu sistema sabe qué pedido liberar.

Cómo funciona el QR interoperable en Bolivia

En Bolivia, un QR generado por un banco se puede pagar desde la app de cualquier otro. Por eso a un negocio le basta conectar una sola entidad para cobrarle a clientes de todo el sistema financiero.

Las piezas, en orden:

  • 2019: el QR entra a la norma. El BCB incorporó el QR como instrumento de pago con la Resolución de Directorio N° 137/2019, que modificó su reglamento de servicios de pago, según explica la ASFI. Ese mismo año los bancos de ASOBAN lanzaron QR Simple, la marca con la que el QR llegó a las apps bancarias (según ASOBAN, citada por Los Tiempos).
  • 2022: QR BCB Bolivia. El 12 de diciembre de 2022 el Banco Central lanzó el QR BCB Bolivia, pensado para llegar también a clientes de entidades no tradicionales, que se fue sumando banco por banco.
  • 2023: interoperabilidad en producción. Con la Circular Externa CIEX N° 41/2023, el BCB informó que la interoperabilidad de los pagos inmediatos con QR estaba en producción y que, desde el 12 de octubre de 2023, los pagos QR del sector público debían procesarse con el método QR BCB Bolivia.
  • 2025: gratuidad hasta Bs 69.600. Desde el 1 de marzo de 2025, las transferencias electrónicas de hasta Bs 69.600 son gratuitas por banca electrónica y móvil (RD 019/2025). Explicamos los límites de cada banco en límite del QR en Bolivia por banco.

El uso ya es masivo: según datos del BCB publicados por Los Tiempos el 14 de junio de 2026, en el país se hacen 28 pagos con QR por segundo.

Para quien integra, lo importante es esto: no hace falta una API por cada banco de tus clientes. Hace falta una buena integración con el banco donde tu empresa tiene su cuenta.

¿Qué es OpenBCB?

OpenBCB es una herramienta del Banco Central de Bolivia, basada en API, para que instituciones públicas y privadas automaticen sus cobros con QR sin costo. Se lanzó con el comunicado CP 44/2025 del 8 de octubre de 2025.

Según ese comunicado, OpenBCB está pensada para instituciones «que, por limitaciones presupuestarias o tecnológicas, no han podido automatizar» su cobranza, y sus funciones principales son:

  1. Generación gratuita de códigos QR BCB Bolivia.
  2. Consulta de estado del QR, con información en tiempo real sobre la validez de la operación.
  3. Procesamiento de órdenes de pago.
  4. Notificación de pagos, sin costo.

El BCB estima que beneficiará a más de 100.000 usuarios y llegará a cerca de 30 instituciones públicas o privadas, sobre todo con población en zonas periurbanas y rurales. También anuncia que está prevista la integración con empresas de tecnología financiera (fintech) mediante una conexión directa con el BCB.

El servicio se enmarca en la Ley N° 1670 del BCB y en el Reglamento de Cuentas Transitorias de Liquidación para Entidades o Empresas Públicas y Privadas en el Ente Emisor. En su sitio, el BCB publica la declaración de aceptación y cumplimiento de ese reglamento, que firma el representante legal de la entidad o empresa: acepta el reglamento y las normas que el BCB emita después, asume la responsabilidad de las operaciones y se obliga a dar al BCB la información que pida para control.

Lo que no está publicado

Al consultar el sitio del BCB en noviembre de 2026 no encontramos documentación técnica pública de OpenBCB, ni la lista de requisitos completa, ni cuántas instituciones ya la usan, ni si la integración con fintech ya está activa. Si te interesa, pregunta directo al BCB:

  • ¿Mi tipo de institución puede adherirse, y con qué requisitos?
  • ¿En qué cuenta se acredita el dinero cobrado y en qué plazo llega a la cuenta operativa de la empresa?
  • ¿Hay ambiente de pruebas y documentación técnica?

OpenBCB o la API de tu banco

OpenBCB apunta a instituciones que no pudieron automatizar su cobranza; la API de un banco es el camino habitual de una empresa que ya tiene su cuenta y quiere cobrar desde su sistema. Las dos generan un QR interoperable que se paga desde cualquier banco.

Lo que inclina la balanza es dónde cae el dinero (con la API de tu banco, directo en la cuenta de tu empresa; con OpenBCB, pregunta cómo funciona la cuenta transitoria de liquidación), quién te atiende (tu ejecutivo o el BCB) y qué está disponible hoy: una API bancaria en producción tiene documentación y pruebas; de OpenBCB, lo público por ahora es el comunicado.

No son excluyentes. Un sistema bien hecho separa «generar el cobro» de «quién lo genera», y así puede cambiar de banco, o sumar OpenBCB, sin rehacer todo.

¿Qué hace la API QR de un banco?

Casi todas hacen las mismas cinco cosas: autenticarse, generar el QR, consultar su estado, anularlo y avisar del pago. Cambian los nombres y los formatos, no la idea.

  1. Autenticación. Tu sistema se identifica con las credenciales que el banco emite para tu empresa (usuario, clave y a veces una llave para cifrar). Hay unas para pruebas y otras para producción.
  2. Generar el QR. Envías el monto, la moneda, una glosa (lo que el cliente ve en su app), tu referencia y el vencimiento. Recibes la imagen del QR y un identificador.
  3. Consultar el estado. Preguntas por el identificador: pendiente, pagado, vencido o anulado.
  4. Anular. Das de baja un QR que ya no debe pagarse (porque el cliente canceló o porque generaste otro).
  5. Aviso de pago. El banco llama a tu servidor cuando alguien paga. Algunos bancos lo ofrecen y otros no, y no conviene depender solo de él.

Algunos bancos suman una lista de QR pagados por fecha, que es la base para conciliar cada día.

API QR por banco: qué publica cada uno

Ningún banco que revisamos publica en su sitio la documentación de su API QR para empresas. Lo que sí publican es su QR para negocios desde la app. El acceso por API se negocia con la banca empresarial de cada entidad. Consultado en noviembre de 2026:

Banco Económico

Es el banco con el que tenemos nuestra conexión certificada y en producción. Por eso sabemos que el Banco Económico ofrece a empresas un servicio de cobro QR por API, con ambiente de pruebas, credenciales por empresa y certificación antes de salir a producción. Los detalles técnicos los entrega el banco a cada empresa al habilitar el servicio; no están publicados en su web.

BNB (Banco Nacional de Bolivia)

El BNB tiene una página para solicitar el QR de tu negocio, físico o digital, con el requisito de tener una caja de ahorros o cuenta corriente activa. No menciona una API: eso se conversa con tu ejecutivo de banca empresas.

BCP (Banco de Crédito de Bolivia)

La página de QR del BCP habla del QR desde la app (monto y moneda editables, un QR que acepta múltiples pagos) y no menciona una API para empresas.

Banco Unión

El QR BCB Bolivia debutó en diciembre de 2022 con los clientes del Banco Unión, para la compra de los Bonos BCB Navideño, según el comunicado del BCB. En su sitio no encontramos documentación pública de una API QR para empresas. Si tu cuenta está ahí, pregunta en banca empresarial.

BancoSol

En su banca por internet para empresas, BancoSol ofrece una «herramienta de cobro QR» para hacer seguimiento de los pagos recibidos. Es una herramienta de su banca, no una API publicada.

Banco BISA y Banco Mercantil Santa Cruz

Los dos ofrecen cobro con QR desde sus apps y bancas por internet. En sus sitios no encontramos documentación pública de una API QR para empresas.

Que un banco no publique su API no significa que no la tenga. Significa que el primer paso es una reunión, no una página de desarrolladores.

Requisitos para cobrar con la API QR de un banco

Lo de siempre: una cuenta a nombre de la empresa, un contrato con el banco, credenciales de pruebas y producción, y pasar sus pruebas. El detalle cambia de banco a banco; esto es lo que vimos en la práctica.

  1. Cuenta empresarial en el banco, a nombre de la empresa, con su NIT y la documentación legal al día.
  2. Representante con facultades. Alguien con poder suficiente para firmar el contrato o la adhesión al servicio.
  3. Solicitud y contrato del servicio de cobro QR, con las condiciones y, si aplica, la tarifa del banco.
  4. Credenciales de pruebas. El banco habilita un ambiente donde se generan y pagan QR sin dinero real.
  5. Pruebas o certificación. El banco revisa que tu integración funcione: generar, consultar, anular y, si existe, recibir el aviso.
  6. Credenciales de producción y un primer pago real de verificación antes de abrirlo a tus clientes.
  7. Un servidor propio que llame a la API (nunca el navegador ni la app del cliente) y, si el banco avisa los pagos, una dirección pública con HTTPS.

La parte lenta casi nunca es la técnica: es el trámite, que sigue la agenda del banco. Conviene empezarlo antes que el desarrollo.

Integración propia o pasarela de pagos

Con una integración propia, el QR lo genera tu banco con tus credenciales y el dinero entra directo a tu cuenta. Con una pasarela, un tercero cobra por ti y te transfiere después. Las dos sirven; dependen de cuánto cobras y de cuánto control necesitas.

Una pasarela conviene si quieres QR y tarjeta en el mismo lugar o si tu volumen es bajo. A cambio, el dinero pasa primero por el intermediario, con su comisión y sus plazos.

Una integración directa conviene si cobras todos los días y el cobro es parte del sistema (cuotas, pedidos, aportes). A cambio, alguien tiene que hacer lo que el banco no hace: confirmar cada pago aunque el aviso falle, conciliar a diario y resolver pagos tardíos o con otro monto. Eso lo contamos en conciliar los cobros QR con tu caja y tu contabilidad.

Hay una tercera vía: conectar tu sistema a una plataforma de cobros que ya tiene la conexión bancaria certificada. El dinero sigue entrando directo a tu cuenta, con tus credenciales, pero no empiezas de cero con el banco ni con las reglas de cobro. Es como trabajamos en Bemorex.

Errores comunes al integrar una API QR

  • Llamar a la API desde el navegador o la app. Las credenciales quedan a la vista de cualquiera. Siempre desde el servidor.
  • Confiar solo en el aviso de pago. Puede no llegar o llegar dos veces. Hay que consultar el estado y conciliar.
  • Atarse a un solo banco en el código. Si el día de mañana cambias de banco, debería cambiar un conector, no el sistema entero.

Dos casos en producción

En la app del Canastón SIB, los afiliados de la Sociedad de Ingenieros de Bolivia en Oruro pagan sus puntos extra con un QR que el banco genera para ese monto exacto, válido por quince minutos y pagable desde cualquier banco. El banco avisa con una notificación firmada, el servidor suma los puntos y el canastón se confirma solo. Si el aviso no llega, una conciliación periódica encuentra el pago igual.

En el Colegio de Ingenieros en Tecnologías de la Información de Oruro, cada afiliado entra a su portal, ve cuánto debe, elige cuántos meses pagar y genera el QR para la app de su banco. Los aportes en efectivo y por QR generan su comprobante, y los pagos en línea se concilian con lo que reporta el banco.

Si quieres cobrar así desde tu sistema, con una conexión bancaria ya certificada y sin depender de un solo banco, mira cobros con QR desde tu sistema. Lo que hacemos para empresas e instituciones del país está en desarrollo de software en Bolivia, y el panorama general, en la guía de pagos QR en Bolivia. Para conversar tu caso, escríbenos.

Sigue leyendo

¿Quieres aplicarlo en tu empresa?

Cuéntanos qué necesitas: lo vemos juntos y te proponemos un camino por escrito, en español o en inglés.

[email protected]