Cobros con Bre-B

Bre-B por API para empresas: cobra, concilia y recibe la confirmación en tu sistema

En cortoPara una empresa, recibir pagos por Bre-B no es solo que la plata llegue: es que cada pago quede amarrado a su factura y el sistema lo registre solo. Con la API de Firux, tu sistema crea el cobro, el cliente paga desde cualquier banco y tu sistema se entera en segundos, con su referencia.
Ilustración de un servidor que recibe la confirmación de un pago Bre-B

Con la API de Firux, tu sistema crea cada cobro Bre-B con tu referencia (la factura, el pedido o el cliente), tu cliente paga desde cualquier banco y tu sistema recibe en segundos un webhook firmado. La conciliación sale sola. Integrar es gratis; cada cobro confirmado cuesta el 1 % + IVA, con un mínimo de $500 + IVA.

Para una empresa, recibir pagos por Bre-B no es solo que la plata llegue: es que cada pago quede amarrado a su factura, que el sistema lo registre solo y que nadie tenga que revisar extractos a fin de mes. Te explicamos cómo funciona y qué necesitas para empezar.

El ciclo de un cobro

  1. Tu sistema crea el cobro con el valor y tu referencia (el número de factura, de pedido o de cliente).

  2. Firux devuelve el cobro listo para pagar, con su enlace de pago y lo que tu cliente necesita según dónde vaya a pagar.

  3. El cliente paga desde la app de su banco o billetera, con Bre-B.

  4. El pago se confirma en el riel, amarrado a ese cobro.

  5. Tu sistema recibe un webhook firmado con el evento charge.paid, el valor pagado y tu referencia. Marca la factura como pagada sola.

Lo que hace la integración confiable

  • Idempotencia: cada solicitud lleva su propia clave. Si tu sistema reintenta por un corte de red, no se crea un cobro repetido.

  • Webhooks firmados: cada aviso trae una firma que tu sistema verifica, para que nadie pueda fingir un pago.

  • Tu referencia: el campo external_reference viaja con el cobro y con el aviso. La conciliación sale sola.

  • Entorno de prueba: creas conexiones de prueba, simulas pagos y recibes los webhooks sin mover dinero.

Dónde paga tu cliente

Dónde paga tu clienteQué le muestras
En tu punto de ventaEl QR del cobro
En un correo, una factura o por WhatsAppEl enlace de pago, con el QR del cobro

Un ejemplo: una distribuidora con 400 facturas al mes

Una distribuidora de alimentos le factura a 400 tiendas al mes, con un promedio de $480.000 por factura. Hoy le pagan por transferencia a su cuenta, y una persona pasa los primeros días de cada mes cruzando el extracto con las facturas: dos tiendas que pagan el mismo valor, una que paga dos facturas juntas, otra que paga a nombre del hijo.

Con la API, el sistema de la distribuidora crea un cobro por cada factura, con su número como referencia, y le manda el enlace a cada tienda en el correo o por WhatsApp. Cada pago vuelve con su número de factura en el webhook y la factura queda pagada sola. Lo que no se pagó salta a la vista, porque es lo único que sigue pendiente.

Si sus clientes prefieren seguir pagando a la cuenta de siempre, hay otra forma de cruzarlos: lo contamos en "También para lo que ya te pagan", más abajo.

Qué necesitas para empezar

  1. Tu cuenta de Firux con la identidad verificada. Mientras verificas, cobras con un tope menor por cobro; al verificar, sube.

  2. Una conexión de API en Ajustes, Conexiones API, con su llave de prueba y la de producción. Cada llave se muestra una sola vez.

  3. Una URL https para los webhooks y el código que verifica su firma.

  4. Una prueba de punta a punta en el entorno de prueba: crear, simular el pago y recibir el aviso.

Errores comunes al integrar

  • Dar la venta por pagada cuando el cliente vuelve a tu página. El regreso del navegador no prueba nada: lo que vale es el webhook firmado, o consultar el cobro.

  • No verificar la firma. Sin ella, cualquiera que conozca tu URL podría mandarte un "pago".

  • Procesar dos veces el mismo aviso. Los webhooks se reintentan si tu sistema no responde: guarda el id de cada evento y no lo apliques dos veces.

  • Mandar el monto en centavos. La API recibe pesos enteros: $48.000 se manda como 48000.

  • Reintentar sin la misma clave de idempotencia. Si cambias la clave, el reintento crea otro cobro.

También para lo que ya te pagan

Si tus clientes ya te pagan a tu cuenta de siempre, el Verificador de Pagos le avisa a tu sistema de cada pago que tu banco te notifica, con el evento payment.notified. Es el mismo canal de webhooks y la misma llave de API.

Desde el plan Verificador Plus, tu sistema también puede crear órdenes de pago por API, para que esos pagos se crucen solos con tus pedidos. Ese aviso viene de tu banco, no del riel, y por eso es distinto de un cobro confirmado: lo explicamos en un aviso no es un pago.

Lo que cuesta

  • Integrar no cuesta: la API y el entorno de prueba son gratis.

  • Cada cobro confirmado: el 1 % + IVA, con un mínimo de $500 + IVA, hasta $12.000.000 por cobro.

  • Volumen alto: desde 10.000 cobros al mes, en el plan Empresa se negocia una tarifa fija por cobro.

En el ejemplo de la distribuidora, una factura de $480.000 cuesta $4.800 + IVA. El detalle de cada plan está en precios.

Si tu software lo usan otros negocios

Si tienes un POS, un ERP o una plataforma con muchos comercios, cada uno puede conectar su cuenta de Firux con un botón, sin copiar llaves: lo explicamos en Conectar con Firux Pay. Y mira el programa para integradores.

Cómo empezar

La documentación completa, con ejemplos en Node.js y PHP y la especificación OpenAPI, está en developers.firux.co, y el paso a paso con el código del webhook, en cómo integrar pagos Bre-B por API.

Lee también por qué conciliar no es liquidar, y la guía completa en Bre-B para negocios.

Preguntas frecuentes

¿Integrar la API cuesta?
No. La API y el entorno de prueba son gratis. Cada cobro confirmado paga el 1 % + IVA, con un mínimo de $500 + IVA.
¿Cómo se entera mi sistema de un pago?
Recibe un webhook firmado con el evento charge.paid, el valor pagado y tu referencia.
¿Qué pasa si mi sistema reintenta una solicitud?
Cada solicitud lleva su clave de idempotencia, así que un reintento no crea un cobro repetido.
¿Hay tarifa fija para volumen alto?
Sí. Desde 10.000 cobros al mes, en el plan Empresa se negocia una tarifa fija por cobro con cada empresa.
Jeferson Hernández Galván

Jeferson Hernández Galván · CEO y fundador de Firux Pay

Fundador y CEO de Firux Pay, la plataforma de cobros por Bre-B para negocios en Colombia. Trabaja con comercios que quieren cobrar sin datáfono, con la plata en segundos y sin miedo al pantallazo falso.

Más artículos  ·  Cómo escribimos  ·  Nosotros  ·  LinkedIn

Recibe el resumen del blog

Un correo los martes, solo las semanas en que publicamos algo nuevo. Te das de baja con un clic.

Sigue leyendo

Cobra por Bre-B y deja de revisar pantallazos

Cada pago se confirma desde el sistema bancario, no desde una foto. El 1 % por cobro, sin mensualidad para empezar.

Registrar mi negocio