Saltearse al contenido
Nappai Documentation

Stripe Customer

Bienvenido al componente Stripe Customer. Este elemento actúa como el puente entre tu sistema de automatización Nappai y tu cuenta de pagos de Stripe. Su función principal es ayudarte a crear, buscar, actualizar o eliminar registros de clientes en Stripe, permitiendo que tu flujo de trabajo mantenga un catálogo actualizado de tus usuarios o compradores.

Piensa en este componente como una oficina de registro digital: cada vez que necesitas saber quién es un cliente, agregar uno nuevo o corregir sus datos, este componente se encarga de hablar con Stripe para hacerlo por ti.

¿Cómo funciona?

Internamente, este componente se conecta a la API oficial de Stripe. Cuando ejecutas el componente, envía la información que le proporcionas (como el nombre o el email) a los servidores seguros de Stripe.

Stripe procesa esta información según la acción que hayas seleccionado (por ejemplo, “buscar” un cliente específico). Una vez que Stripe responde, el componente captura esa información y te la entrega en un formato organizado para que puedas usarla en los siguientes pasos de tu automatización. No necesitas preocuparte por los protocolos de seguridad o las direcciones web; Nappai y este componente se encargan de toda la comunicación técnica en segundo plano.

Conexión y Credenciales

Este componente es parte del ecosistema de pagos y requiere acceso seguro a tu cuenta 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 (como tu API Key).
  3. En tu flujo de trabajo, selecciona la credencial que acabas de crear en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente. Puedes completarlos manualmente o conectarlos con salidas de otros componentes (modo de mapeo).

  • Operation: Selecciona la acción principal que deseas realizar.

    • Visible en: Todas las operaciones

  • Get Mode: Define si quieres buscar un cliente específico por su ID único o si prefieres listar todos los clientes que coinciden con ciertos criterios.

    • Visible en: Retrieve a single customer by ID, List all customers

  • Customer ID: Introduce el identificador único del cliente en Stripe (generalmente empieza con cus_). Este campo es esencial si buscas un cliente específico, lo actualizas o lo eliminas.

    • Visible en: Retrieve a single customer by ID, Update customer, Delete customer

  • Name: Escribe el nombre completo del cliente.

    • Visible en: Create customer, Update customer

  • Email: Introduce la dirección de correo electrónico del cliente. Este dato es útil para identificar al usuario y, en algunas búsquedas, puede actuar como un filtro.

    • Visible en: Create customer, Update customer, List all customers

  • Phone: Ingresa el número de teléfono del cliente.

    • Visible en: Create customer, Update customer

  • Description: Agrega una nota o descripción breve sobre este cliente. Esto es útil para recordar contexto interno (por ejemplo, “Cliente VIP” o “Pendiente de verificación”).

    • Visible en: Create customer, Update customer

  • Limit: Especifica el número máximo de clientes que deseas obtener en una lista (valor recomendado entre 1 y 100). Útil para evitar listas demasiado largas que puedan ralentizar tu automatización.

    • Visible en: List all customers

Salidas

Cuando este componente termina de ejecutarse, produce los siguientes resultados que puedes utilizar en el resto de tu flujo de trabajo:

  • customer: El objeto completo del cliente, que contiene todos sus detalles (ID, email, nombre, etc.). Es la salida principal si necesitas usar la información completa en otro paso.
  • customer_id: El identificador único del cliente. Es muy útil si acabas de crear un cliente y necesitas su ID para realizar otras acciones con él después.
  • status: Indica si la operación fue exitosa o si ocurrió un error.
  • message: Un mensaje detallado que explica el resultado, útil para entender por qué una operación pudo fallar.
  • raw_response: La respuesta cruda del sistema de Stripe, utilizada por usuarios avanzados para depuración técnica.

Ejemplo de Respuesta JSON

Si buscas un cliente por su ID y la operación tiene éxito, recibirás una estructura similar a esta: json { “customer”: { “id”: “cus_123456789”, “email”: “cliente@ejemplo.com”, “name”: “Juan Pérez”, “description”: “Cliente Premium”, “created”: 1698765432 }, “status”: “success”, “customer_id”: “cus_123456789” }

Conectividad

Este componente suele ser el punto de partida o de enlace para gestionar el ciclo de vida del cliente:

  1. Integración con CRM o Bases de Datos: A menudo, se conecta a la salida de un componente “Obtener Usuario” o “Webhook de Registro” para crear automáticamente un perfil en Stripe cuando un nuevo usuario se registra en tu aplicación.
  2. Pasarelas de Pago: Una vez que has creado o recuperado el cliente (customer), este componente suele conectar con componentes de “Creación de Pagos” o “Suscripciones”, donde el ID del cliente se utiliza para procesar cobros o gestionar planes de suscripción.
  3. Gestión de Errores: Si el componente devuelve un status de error, es común conectarlo a nodos de notificación para alertar al equipo de soporte sobre fallas en la gestión de clientes.

Ejemplo de Uso

Escenario: Verificación de Cliente Existente

Imagina que estás automatizando el proceso de onboarding. Cuando un usuario se registra en tu sitio web, quieres asegurarte de que no crees un duplicado en Stripe.

  1. Configuras el Stripe Customer component.
  2. En Operation, seleccionas una acción de búsqueda.
  3. En Get Mode, eliges la opción para recuperar un cliente específico.
  4. En Customer ID, mapeas el ID que viene de tu base de datos de usuarios.
  5. En el siguiente paso, revisas la salida status. Si es “success” y encuentras el cliente, puedes omitir la creación de un nuevo perfil; si es un error o no encontrado, procedes a crear uno nuevo.

Consejos y Mejores Prácticas

  • Usa IDs Reales: Asegúrate de que el campo “Customer ID” contenga identificadores válidos de Stripe (que comienzan con cus_). Los IDs falsos o vacíos generarán errores de ejecución.
  • Limita las Listas: Si usas la opción para listar clientes, mantén el valor de “Limit” bajo (ej. 10 o 20) si solo necesitas verificar datos recientes, para mantener el flujo rápido.
  • Gestiona Emails Únicos: El email es un dato clave. Si actualizas un cliente, asegúrate de que el email sea consistente para evitar confusiones en tu base de datos de Stripe.
  • Validación de Nombres: Asegúrate de que el campo “Name” no contenga caracteres especiales no soportados por Stripe para evitar rechazos en la creación del cliente.

Consideraciones de Seguridad

  • Protección de Credenciales: Nunca compartas tu credencial de Stripe API. Asegúrate de que tu panel de Nappai esté protegido con contraseñas fuertes.
  • Datos Sensibles: El componente maneja información personal como correos electrónicos y teléfonos. Asegúrate de cumplir con las regulaciones de privacidad (como GDPR) al almacenar y procesar estos datos en tus flujos.