Saltearse al contenido
Nappai Documentation

Stripe Balance

Bienvenido a la documentación del componente Stripe Balance en Nappai. Este componente es tu herramienta esencial para obtener una visión clara y actualizada de las finanzas de tu cuenta de Stripe.

Imagina que este componente es como una “foto instantánea” de tus fondos. Te permite saber cuánto dinero tienes listo para usar inmediatamente y cuánto está en proceso de ser transferido. Es ideal para verificar tu liquidez antes de realizar pagos, retiros o simplemente para mantener un control financiero preciso.

¿Cómo funciona?

Este componente actúa como un puente seguro entre Nappai y tu cuenta de Stripe. Cuando lo ejecutas, realiza lo siguiente:

  1. Consulta en Tiempo Real: Se conecta a la API de Stripe para pedir la información más actualizada sobre tus fondos.
  2. Seguridad: Utiliza las credenciales de seguridad que has configurado previamente para asegurar que solo tú y tu equipo puedan ver esta información.
  3. Desglose de Fondos: Devuelve la información dividida en categorías clave (ver sección de Salidas) para que entiendas no solo el total, sino el estado de cada parte de tu dinero (disponible vs. pendiente).

No necesitas configurar parámetros complejos como fechas o IDs específicos; al ejecutar el componente, automáticamente te muestra el estado general de tu cuenta.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio de Stripe.

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Stripe API y guarda los campos requeridos (tu clave API secreta de Stripe).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

No necesitas ingresar datos adicionales para usar este componente. Su funcionamiento es automático una vez que has conectado tu cuenta de Stripe a través de la sección de Credenciales mencionada arriba.

Salidas

Al ejecutar este componente, recibirás una respuesta estructurada que puedes usar en el resto de tu flujo de trabajo. Aquí te explicamos qué información obtendrás:

  • Available Balance (Saldo Disponible): El dinero que ya está en tu cuenta y puedes retirar o usar inmediatamente.
  • Pending Balance (Saldo Pendiente): El dinero que ha sido procesado pero que aún no está disponible para retiro (por ejemplo, pagos recientes que están siendo verificados).
  • Connect Reserve (Reserva de Connect): (Si usas la funcionalidad Connect de Stripe) La cantidad de fondos retenidos por Stripe para cubrir posibles devoluciones o cargos.

Ejemplo de Respuesta JSON

Cuando ejecutas el componente, la salida se verá similar a este ejemplo. Puedes usar estos valores en los siguientes nodos de tu automatización: json { “available”: { “usd”: 1500.50, “eur”: 0.00 }, “pending”: { “usd”: 250.00, “eur”: 100.00 }, “connect_reserve”: { “usd”: 0.00 } }

Nota: Los valores pueden variar según el idioma de moneda (USD, EUR, etc.) que tengas configurado en tu cuenta de Stripe.

Conectividad

Este componente es una fuente de datos de lectura. Por lo tanto:

  • Entradas: No tiene entradas de datos de otros componentes, solo la conexión de credencial.
  • Salidas: Sus salidas (saldo disponible, pendiente, etc.) suelen conectarse a:
    • Nodos de Reportes/Notificaciones: Para enviar un resumen diario o semanal del estado de tus fondos.
    • Condiciones Lógicas: Para tomar decisiones (ej. “Si el saldo disponible es mayor a $1000, entonces procesar el pago”).
    • Hojas de Cálculo/CRM: Para registrar el balance actual en un registro histórico.

Ejemplo de Uso

Escenario: Quieres asegurarte de que tienes fondos suficientes antes de programar una transferencia grande.

  1. Arrastra el componente Stripe Balance a tu flujo.
  2. Selecciona tu credencial de Stripe configurada.
  3. Conecta la salida Available Balance a un nodo de Condiciones (If/Else).
  4. Configura la condición para verificar si el monto es superior a $500.
  5. Si es verdadero, envías una notificación de “Fondos Suficientes”. Si es falso, envías una alerta de “Bajo Saldo”.

Consejos y Mejores Prácticas

  • Actualización Frecuente: El saldo de Stripe puede cambiar rápidamente debido a transacciones en tiempo real. Ejecuta este componente justo antes de tomar decisiones financieras críticas.
  • Manejo de Monedas: Ten en cuenta que Stripe devuelve saldos separados por moneda. Si operas en múltiples divisas, revisa las salidas específicas (USD, EUR, etc.) para un control preciso.
  • Uso en Dashboard: Ideal para colocar este componente en un tablero de control (dashboard) para una vista rápida del estado financiero sin tener que entrar al panel de administración de Stripe.

Consideraciones de Seguridad

  • Acceso Restringido: Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial de Stripe API utilizada por este componente.
  • Solo Lectura: Este componente es de solo lectura. No modifica, transfiere ni borra fondos. Es completamente seguro para verificar saldos sin riesgo de alterar tu cuenta.