Guías de Firux Pay

Conectar con Firux Pay: cobros Bre-B para plataformas con muchos negocios

En cortoConectar con Firux Pay es un botón para tiendas en línea, POS y software con muchos negocios: cada negocio conecta su cuenta con un clic y la plataforma cobra por Bre-B a su nombre. Te contamos cómo se ve, qué puede hacer la plataforma y qué no.
Ilustración de una plataforma con el botón Conectar con Firux Pay y la pantalla del permiso del negocio con sus permisos aprobados

Conectar con Firux Pay es un botón para las plataformas que atienden muchos negocios: una tienda en línea, un POS, un software de reservas o de facturación. Cada negocio conecta su cuenta de Firux con un clic, sin copiar llaves, y la plataforma puede crear cobros Bre-B a su nombre y saber al instante cuándo se pagaron.

Qué es Conectar con Firux Pay

Es la misma idea de cuando una app te pide permiso para usar tu cuenta: ves quién la pide, qué podrá hacer y decides. En este caso, el negocio le da permiso a su plataforma para cobrar por Bre-B a su nombre.

Hasta ahora, conectar un negocio a una plataforma pedía tres pasos a mano: crear una conexión en el panel de Firux, copiar la llave de API y pegarla en la plataforma, y configurar la dirección donde llegan los avisos de pago. Con un negocio, eso toma unos minutos. Con cientos, son cientos de llaves copiadas a mano, errores de una letra y horas de soporte.

Con el botón, el negocio no copia nada. Toca "Conectar con Firux Pay", entra a su cuenta, revisa los permisos y elige Permitir. Por debajo funciona con OAuth 2.0 y PKCE, el estándar que usan las plataformas grandes para conectar cuentas de forma segura.

Para quién sirve

Para cualquier software que usen varios negocios y que necesite cobrarles a sus clientes:

  • Tiendas en línea y creadores de tiendas. Cada tienda cobra sus pedidos por Bre-B y el pedido se marca pagado solo.

  • POS y software de caja. Al cobrar sale el QR con el monto exacto y la venta se cierra cuando llega la confirmación.

  • Reservas y agendas. Consultorios, peluquerías y gimnasios que cobran la reserva o el anticipo al agendar.

  • Facturación y cobranza. Cada factura o cuota lleva su cobro, y queda pagada en el sistema cuando el cliente paga.

  • Domicilios y marketplaces. Cada restaurante o vendedor cobra con su propia cuenta, dentro de la misma plataforma.

Si tienes un solo negocio y quieres conectar tu propio sistema, la llave de API sigue siendo lo más simple: la creas en tu panel, en Ajustes, Conexiones API, y la pegas en tu sistema.

Cómo se ve para el negocio

  1. En su plataforma toca el botón "Conectar con Firux Pay".

  2. Entra a Firux con su correo. Si todavía no tiene cuenta, la crea ahí mismo, gratis, y al terminar vuelve a la pantalla del permiso.

  3. Ve el nombre y el logo de la plataforma y qué podrá hacer, en palabras claras. Por ejemplo: "podrá crear cobros Bre-B a nombre de tu negocio y ver si se pagaron. No podrá retirar ni mover tu dinero."

  4. Toca Permitir y vuelve a la plataforma, ya conectado. Si toca Cancelar, no se conecta nada.

Solo el dueño del negocio o un administrador puede dar el permiso; un cajero no. Y el negocio tiene el control después: en Ajustes, "Aplicaciones conectadas", ve qué plataformas conectó, desde cuándo y con qué permisos, y puede desconectar cualquiera con un toque.

Qué puede hacer la plataforma, y qué no

La plataforma solo puede hacer lo que el negocio aprobó. Los permisos son cuatro:

PermisoQué le permite a la plataforma
Crear cobrosCrear cobros Bre-B a nombre del negocio, con el QR o la llave para que el cliente pague.
Ver los cobrosSaber si los cobros que creó ya se pagaron.
Ver la cuentaVer el nombre del negocio, su tope por cobro y su plan.
Órdenes de pagoCrear los pagos que espera, para que los que llegan a la cuenta del negocio se crucen solos con sus pedidos.

Lo que ningún permiso permite: retirar, dispersar ni mover el saldo del negocio. La plata de cada cobro queda en el saldo del negocio y solo el negocio la retira a su banco, desde su panel. Firux no es titular de la cuenta recaudadora donde entra el dinero: lleva el registro de lo que es de cada negocio.

Además, cada plataforma solo ve los cobros que ella misma creó. Si un negocio usa dos plataformas, ninguna ve los cobros de la otra.

Cómo funciona para la plataforma

  • Una aplicación por plataforma. Firux la crea y la aprueba, con tu nombre, tu logo y las direcciones exactas a las que vuelve el negocio después de dar el permiso. Ninguna aplicación se conecta sin esa aprobación.

  • Un acceso por negocio. Cuando el negocio permite, tu servidor recibe un acceso que dura una hora y se renueva solo. Con él usas la misma API de cobros que ya conocen los integradores.

  • Una sola dirección para los avisos. Los avisos de todos tus negocios llegan firmados a la misma URL, y cada uno dice de qué negocio es.

  • Los avisos que importan. El cobro pagado, el cobro que venció sin pago, los cambios de la cuenta del negocio (por ejemplo, cuando verifica su identidad y le sube el tope) y la desconexión, para que sepas si un negocio te desconectó.

  • Un modo de prueba. Con una aplicación de prueba simulas el pago de un cobro y recibes el aviso firmado, sin mover dinero real.

Los detalles técnicos, con ejemplos en PHP y Node.js y una colección de Postman, están en la guía para plataformas de developers.firux.co.

Un ejemplo con números

Piensa en una plataforma de domicilios con 120 restaurantes. Un cliente pide $85.000 en uno de ellos. La plataforma crea el cobro a nombre del restaurante y le muestra al cliente el QR o la llave para pagar desde su banco, sin datáfono.

En segundos llega a la plataforma el aviso de cobro pagado. El pedido pasa a cocina sin que nadie revise un pantallazo. Si el cliente no paga a tiempo, el cobro vence, llega el aviso de cobro vencido y la plataforma libera el pedido.

El restaurante paga lo mismo que cualquier negocio de Firux: el 1 % + IVA por cobro, con un mínimo de $500 + IVA. En este pedido, la tarifa es de $850 más IVA. El pago queda en el saldo del restaurante, menos la tarifa, y lo retira a su banco cuando quiera. Si la plataforma es aliada de Firux, recibe una parte de la utilidad de cada cobro de sus negocios: está explicado en el programa para integradores.

Errores comunes al integrarlo

  • Poner el secreto de la aplicación en el navegador o en la app. Ese secreto va solo en tu servidor. El botón lleva a tu servidor y es tu servidor el que arma el enlace del permiso.

  • No guardar la renovación nueva. Cada vez que renuevas el acceso recibes una renovación nueva, y la anterior deja de servir. Si usas una vieja, la conexión se revoca por seguridad.

  • Renovar desde dos lugares a la vez. Por la misma razón, renueva siempre desde un solo proceso.

  • No verificar la firma de los avisos. Cada aviso llega firmado: verifícalo antes de marcar un pedido como pagado.

  • Ignorar la desconexión. Si el negocio te desconecta, te llega un aviso. Muéstraselo en tu plataforma y ofrécele conectar de nuevo.

Llave de API o Conectar con Firux Pay

Llave de APIConectar con Firux Pay
Para quiénUn negocio que conecta su propio sistemaUna plataforma con muchos negocios
Cómo se conectaEl negocio copia la llave y la URL de avisosEl negocio toca un botón y da el permiso
AvisosUna URL por conexiónUna URL para todos tus negocios
PermisosTodo lo de la APISolo lo que el negocio aprobó
DesconectarRevocar la conexión en AjustesDesconectar en Aplicaciones conectadas

Las dos funcionan sobre la misma API y la misma confirmación en el riel de Bre-B. Las conexiones que ya existen con llave de API siguen funcionando igual.

Cómo empezar

  • Si tienes una plataforma: escríbenos a soporte@firux.co para tu aplicación de prueba, con el nombre, el logo, el sitio, las direcciones de regreso y la URL de tus avisos. Mientras tanto, revisa la guía para plataformas.

  • Si tienes un negocio y tu plataforma ya tiene el botón: tócalo y da el permiso. Si todavía no tienes cuenta, la creas en el mismo paso.

  • Si tu plataforma todavía no lo tiene: cuéntales que existe, o registra tu negocio y conecta tu sistema con la llave de API.

En resumen

  • Conectar con Firux Pay deja que una plataforma cobre por Bre-B a nombre de cada negocio, sin que el negocio copie llaves.

  • El negocio ve qué permisos pide la plataforma, decide y puede desconectarla cuando quiera.

  • Ningún permiso permite retirar ni mover la plata del negocio, que queda en su saldo.

  • La plataforma recibe los avisos de todos sus negocios en una sola dirección, firmados.

Fuentes

Preguntas frecuentes

¿La plataforma puede sacar plata de mi saldo?
No. Ningún permiso de Conectar con Firux Pay permite retirar, dispersar ni mover tu saldo. La plata de tus cobros queda en tu saldo de Firux y solo tú la retiras a tu banco, desde tu panel.
¿Qué pasa con mis cobros si desconecto una plataforma?
Nada: tus cobros pagados y tu saldo siguen igual. Desde ese momento la plataforma ya no puede crear cobros nuevos ni ver tu cuenta.
¿Necesito una cuenta de Firux para conectarme?
Sí. Si no la tienes, la creas gratis en el mismo paso del permiso. Cobros Base no tiene mensualidad: pagas el 1 % + IVA por cobro, con un mínimo de $500 + IVA.
Mi plataforma me pidió la llave de API, ¿tengo que cambiar?
No. Las conexiones con llave de API siguen funcionando igual. Si tu plataforma agrega el botón, te puedes conectar con él cuando quieras.
¿Cómo consigue una plataforma el botón?
Escribiendo a soporte@firux.co. Firux crea y aprueba su aplicación, primero de prueba, y la plataforma integra el botón con la guía de developers.firux.co.
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