Payin (Ingreso de dinero)

Es el proceso que permite recibir pagos desde los usuarios hacia tu empresa.
Se realiza mediante transferencias bancarias, interoperabilidad o rails locales.
Flöid genera un payment token, que actúa como una cuenta o referencia única para que el usuario pueda transferir dinero.

Ejemplo de uso: cobrar una compra, suscripción, wallet top-up o recaudación de fondos.

Payout (Dispersión de dinero)

Es el proceso opuesto a Payin: permite enviar dinero desde tu empresa hacia una persona o empresa.
Puede ser hacia:

• Cuentas bancarias
• Billeteras como Yape (Perú)

Flöid lo gestiona a través de una API unificada para todos los bancos disponibles.

Ejemplo de uso: pagos masivos, devoluciones, comisiones, billeteras digitales.

Open Banking

Es la capacidad de conectar cuentas bancarias de tus usuarios a través de Flöid, con consentimiento del titular.
Permite obtener información como:

• Saldos
• Movimientos
• Información tributaria
• Validaciones bancarias

Open Banking se puede integrar por API o mediante Widget, sin que tengas que manejar credenciales directamente.

Payment Token

Es un identificador único que genera Flöid en los procesos de Payin.
Funciona como un “alias de pago” temporal, usado para:

• Asociar un pago a un beneficiario
• Asignar un CCI dinámico o un identificador único
• Realizar seguimiento del estado del pago
• Recibir notificaciones por webhook

📘

Importante:

Un payment token no es un usuario ni una cuenta bancaria. Es una referencia única por operación.

Admin de Flöid (Dashboard)

Es el panel administrativo donde podrás:

• Gestionar credenciales (sandbox y producción)
• Habilitar permisos por módulo
• Ver logs y monitorear actividad: transacciones, reportes, descargables, etc.
• Configurar webhooks
• Administrar cuentas de recaudo o dispersión
• Revisar transacciones y casos
• Administrar tus usuarios internos

El Admin es necesario para operar correctamente cualquier servicio de Payments o Open Banking.

Case ID

Es el identificador único que Flöid genera para cada request realizada a la API.
Sirve para:

• Trazabilidad
• Seguimiento de procesos
• Consultas posteriores
• Emparejar respuestas síncronas y asíncronas

Puedes dejar que Flöid lo genere, o enviar tu propio caseid en el body como un parámetro custom.

Ejemplo sintético:

{ "caseid": "abc123-empresa", "callbackUrl": "https://tuwebhook.com" }

Callback URL (Webhook)

Es la URL donde Flöid enviará notificaciones cuando una operación cambie de estado.
Se utiliza en:

• Payin (cuando un pago se confirma)
• Payout (cuando la transferencia cambia de estado)
• Open Banking (cuando un flujo asincrónico termina)
• Cualquier servicio que use el modo asíncrono enviará su resultado final a esta URL.

Credenciales API

Son los tokens que permiten autenticarte contra Flöid una vez tengas contrato áctivo y vigente. Existen dos entornos:

• Sandbox: para pruebas
• Production: para operaciones reales

Tu aplicación debe enviar:

Authorization: Bearer <token>  
Content-Type: application/json

📘

La obtención y administración del token son administrables desde el Admin de Flöid.

Modo Síncrono vs Asíncrono

Síncrono

Recibes la respuesta completa de inmediato como parte del mismo request.

Asíncrono

El request retorna una respuesta breve, pero el proceso final se envía por webhook.
Requiere incluir callbackUrl en el body.

Widget de Conexión Bancaria

Es una interfaz que permite a tus usuarios conectar sus cuentas sin que tú debas manejar claves o credenciales.
Flöid se encarga de la autenticación y entrega de datos posterior.

• Ideal para integraciones de Open Banking sin desarrollo avanzado.

Estados de Operación

Dependiendo del producto, verás estados como:

• PENDING
• PROCESSING
• SUCCESSFUL
• ERROR

📘

Cada uno tiene su detalle en la guía correspondiente (Payin / Payout / Datos).

País / Entorno Operativo

Flöid opera distintos servicios según país:

• Chile 🇨🇱: Payin, Payout, Datos
• Perú 🇵🇪:: Payin, Payout, Validación de cuentas
• USA 🇺🇸: Payin, Datos

Los requisitos comerciales y técnicos pueden variar por país.