Conectar con Firux Pay: cobros Bre-B para plataformas con muchos negocios
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
En su plataforma toca el botón "Conectar con Firux Pay".
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.
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."
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:
| Permiso | Qué le permite a la plataforma |
|---|---|
| Crear cobros | Crear cobros Bre-B a nombre del negocio, con el QR o la llave para que el cliente pague. |
| Ver los cobros | Saber si los cobros que creó ya se pagaron. |
| Ver la cuenta | Ver el nombre del negocio, su tope por cobro y su plan. |
| Órdenes de pago | Crear 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 API | Conectar con Firux Pay | |
|---|---|---|
| Para quién | Un negocio que conecta su propio sistema | Una plataforma con muchos negocios |
| Cómo se conecta | El negocio copia la llave y la URL de avisos | El negocio toca un botón y da el permiso |
| Avisos | Una URL por conexión | Una URL para todos tus negocios |
| Permisos | Todo lo de la API | Solo lo que el negocio aprobó |
| Desconectar | Revocar la conexión en Ajustes | Desconectar 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?
¿Qué pasa con mis cobros si desconecto una plataforma?
¿Necesito una cuenta de Firux para conectarme?
Mi plataforma me pidió la llave de API, ¿tengo que cambiar?
¿Cómo consigue una plataforma el botón?
Recibe el resumen del blog
Un correo los martes, solo las semanas en que publicamos algo nuevo. Te das de baja con un clic.