Saltearse al contenido
Nappai Documentation

Stripe Price

Bienvenido al componente Stripe Price dentro de tu panel de automatización Nappai. Este componente actúa como tu puente directo hacia la plataforma de pagos Stripe, permitiéndote gestionar cómo cobras a tus clientes.

Imagina que tienes un producto (como una suscripción mensual o un servicio único) y necesitas definir exactamente cuánto cuesta. Este componente te permite crear esos precios en el sistema de Stripe o buscar precios que ya hayas creado anteriormente, todo desde la comodidad de tus flujos de trabajo automatizados.

¿Cómo funciona?

Internamente, este componente se conecta a la API de Stripe. Piensa en la API como un “mensajero” que lleva tus instrucciones a Stripe y trae de vuelta la confirmación.

Cuando usas este componente, puedes hacer dos cosas principales:

  1. Crear o Listar Precios: Puedes definir nuevos precios (por ejemplo, “$10.00 USD mensuales”) o recuperar una lista de precios existentes para ver qué ofertas tienes activas.
  2. Gestión Flexible: Dependiendo de lo que necesites, puedes configurar si el precio es único (un pago solo) o recurrente (una suscripción que se repite cada mes o año).

Al final del proceso, el componente te devuelve un mensaje claro de “Éxito” o “Error” y te proporciona identificadores únicos que podrás usar en pasos siguientes de tu automatización (por ejemplo, para enviar ese precio a un carrito de compras).

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo 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 (específicamente tu API Key secreta, la cual obtienes en tu cuenta de Stripe).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Create: [Permite crear un nuevo precio asociado a un producto específico en Stripe]
  • Get: [Permite recuperar los detalles de un precio específico usando su ID único]
  • List: [Permite obtener una lista de precios que coinciden con ciertos criterios, como el ID de un producto]

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Operation: [Determina si vas a crear, obtener o listar precios. Las opciones disponibles son Create, Get y List].
  • Mode: [Define el tipo de búsqueda cuando usas la operación ‘Get’ o ‘List’. ‘By ID’ busca un registro específico, ‘All’ lista múltiples registros].
  • Price ID: [El identificador único del precio (por ejemplo, price_1M…) que necesitas buscar. Es requerido cuando usas la operación ‘Get’ o para buscar un precio específico].
  • Amount: [El monto del precio en la unidad más pequeña de la moneda (por ejemplo, 1000 centavos para $10.00). Se utiliza al crear precios].
  • Currency: [El código de la moneda de tres letras (como ‘usd’ para dólares de EE.UU. o ‘mxn’ para pesos mexicanos). Es obligatorio al crear un precio].
  • Product ID: [El ID del producto al que pertenece este precio (por ejemplo, prod_…). Es necesario para asociar el precio a un artículo o servicio específico].
  • Type: [Define si el precio es recurrente (suscripción) o único. Elige ‘recurring’ para cobros periódicos].
  • Billing Interval: [Si eliges el tipo ‘recurring’, define la frecuencia: puede ser ‘day’, ‘week’, ‘month’ o ‘year’. Es obligatorio para suscripciones].
  • Limit: [Número máximo de registros a devolver (entre 1 y 100). Útil cuando estás listando múltiples precios para no saturar el sistema].

Salidas

Una vez que el componente ha procesado tu solicitud con Stripe, te devuelve los siguientes datos para que puedas usarlos en el resto de tu automatización:

  • Success: [Un indicador verdadero (True) o falso (False) que te dice si la operación se completó sin problemas].
  • Price ID: [El identificador único generado por Stripe para el precio. Podrás usar este ID en otros pasos para referenciar este precio].
  • Price Object: [La información completa del precio en formato JSON, incluyendo detalles como moneda, cantidad y estado].
  • Error Message: [Si algo sale mal, aquí aparecerá un mensaje explicando el error para que puedas corregirlo].

Ejemplo de Respuesta JSON

json { “success”: true, “price_id”: “price_1N2x3y4z5a6b”, “price_object”: { “id”: “price_1N2x3y4z5a6b”, “product”: “prod_1M1N2O3P4Q5R”, “currency”: “usd”, “unit_amount”: 2000, “nickname”: “Premium Monthly”, “recurring”: { “interval”: “month” } }, “error_message”: "" }

Conectividad

Este componente suele conectarse en flujo con:

  • Componentes de Producto: Antes de crear un precio, necesitas tener un “Producto” creado. Por lo tanto, es común conectar este nodo después de un componente de “Creación de Productos” o usar el ID de un producto ya existente.
  • Componentes de Facturación/Checkout: Una vez creado el precio y obtenido su Price ID, este ID se suele enviar a componentes que generan enlaces de pago, crean facturas o administran suscripciones, ya que Stripe necesita saber qué precio cobrar.

Ejemplo de Uso

Imagina que quieres automatizar la creación de un nuevo plan de suscripción “Premium” para tu servicio.

  1. Configura la Operación: Selecciona Create.
  2. Define la Moneda y Cantidad: En el campo Currency escribe usd y en Amount escribe 2500 (que equivale a $25.00).
  3. Vincula al Producto: En Product ID, pega el ID de tu producto “Servicio Premium” (o mapea la salida de un componente que creó ese producto).
  4. Configura la Suscripción: En Type selecciona recurring y en Billing Interval selecciona month.
  5. Ejecuta: Al ejecutar el flujo, Stripe creará este precio y te devolverá un Price ID. Podrás usar ese ID más adelante para cobrar a tus clientes automáticamente.

Consejos y Mejores Prácticas

  • Monedas Válidas: Asegúrate de usar códigos de moneda válidos (como usd, eur, mxn). Stripe no acepta monedas que no tenga configuradas en tu cuenta.
  • Precios Decimales: Al ingresar la cantidad (Amount), recuerda que Stripe trabaja con la moneda en su unidad más pequeña (centavos). Para $10.00, debes escribir 1000.
  • Gestión de Errores: Si la operación falla, revisa el campo Error Message para entender si el problema es el ID del producto o la moneda.
  • Modo de Mapeo: Utiliza el “Mapping Mode” si tus precios dependen de datos dinámicos (como una tasa de cambio automática) en lugar de valores fijos.

Consideraciones de Seguridad

  • Protección de Claves: Tu API Key de Stripe es una información sensible. Nunca la compartas públicamente ni la almacenes en código visible. Asegúrate de usar siempre las credenciales configuradas en Nappai en lugar de escribirlas manualmente en los campos del flujo.
  • Permisos Mínimos: Asegúrate de que la credencial de Stripe que uses tenga permisos adecuados para leer y crear precios, pero evita dar permisos de administrador completo si no son necesarios.