Saltearse al contenido
Nappai Documentation

Stripe Coupon

Este componente te permite gestionar los cupones de descuento de tu plataforma de pagos Stripe directamente desde tu flujo de automatización en Nappai. Es ideal si quieres ofrecer descuentos a tus clientes, probar nuevas promociones o limpiar cupones que ya no sean válidos.

¿Cómo funciona?

El componente actúa como un intermediario inteligente entre tu sistema de automatización y la API de Stripe. Dependiendo de lo que necesites hacer (crear un cupón nuevo o buscar uno existente), el componente te pedirá que selecciones una Operación.

Una vez seleccionada la operación, podrás configurar los detalles del cupón, como el tipo de descuento (porcentaje o monto fijo), la moneda, la fecha de vencimiento y el límite de uso. Al ejecutar el flujo, el componente se comunicará con los servidores de Stripe de forma segura para realizar la acción y te devolverá el resultado (por ejemplo, el ID del cupón creado o una lista con los cupones encontrados).

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 (como tu API Key privada).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Puedes dejar muchos de ellos vacíos si no los vas a usar en la operación seleccionada.

  • Get Mode: Permite elegir entre recuperar un solo cupón específico usando su ID o listar todos los cupones existentes en tu cuenta.
  • Coupon ID: Identificador único del cupón. Es obligatorio si seleccionas la opción de “Get Mode” para recuperar un solo cupón.
  • Name: El nombre legible del cupón que aparecerá en los recibos y correos electrónicos de tus clientes.
  • Duration: Indica cuánto tiempo estará vigente el descuento. Puede ser único (“once”) o repetitivo.
  • Duration in Months: Número de meses que durará el descuento si seleccionaste “Duration” como repetitivo.
  • Percent Off: El porcentaje de descuento que otorgará el cupón (ejemplo: 10 para un 10% de descuento).
  • Amount Off: La cantidad fija a descontar en la moneda más pequeña (ejemplo: centavos). Debes usarlo junto con el campo “Currency”.
  • Currency: El código de tres letras de la moneda ISO (ejemplo: “usd”, “eur”). Es necesario si usas un “Amount Off”.
  • Max Redemptions: El número máximo de veces que este cupón puede ser utilizado en total.
  • Redeem By: Una marca de tiempo Unix que indica la fecha límite después de la cual el cupón ya no se puede usar.
  • Limit: El número máximo de cupones a devolver cuando listás cupones (valor recomendado entre 1 y 100).

Salidas

Después de ejecutar el componente, recibirás la siguiente información que puedes usar en pasos siguientes de tu automatización:

  • Coupon ID: El identificador único del cupón que acabas de crear o recuperar.
  • Status: Indica si la operación fue exitosa (ej. “success”) o si hubo un error.
  • Details: Un resumen completo con toda la información del cupón (descuentos, fechas, límite de usos, etc.).
  • Error: Si la operación falló, aquí aparecerá un mensaje explicando el motivo (ej. “Cupón ya existe” o “Fecha inválida”).

Ejemplo de Respuesta JSON

Cuando creas un cupón con éxito, el componente devuelve una estructura similar a esta: json { “coupon_id”: “20PERCENTOFF”, “status”: “success”, “details”: { “id”: “20PERCENTOFF”, “name”: “Verano 2024”, “percent_off”: 20.0, “duration”: “once”, “currency”: “usd”, “created”: 1715600000 } }

Conectividad

Este componente se conecta lógamente con nodos posteriores en tu flujo que necesiten validar si un cupón existe antes de aplicar un pago, o bien con nodos de notificación para avisar al equipo de administración cuando se han creado nuevas promociones. La salida Coupon ID es especialmente útil para rastrear campañas específicas en análisis posteriores.

Ejemplo de Uso

Imagina que quieres crear un cupón de descuento del 10% para tus clientes frecuentes.

  1. En el componente Stripe Coupon, seleccionas el modo de operación para Crear Cupón (implícito en la configuración de los campos de descuento).
  2. En Name, escribes “ClientesFrecuentes10”.
  3. En Percent Off, escribes “10”.
  4. En Currency, seleccionas “usd” (o tu moneda local).
  5. Al ejecutar el flujo, el sistema creará este cupón en Stripe automáticamente. Si el paso es exitoso, recibirás el Coupon ID para usarlo en futuros pasos (por ejemplo, aplicando ese cupón a una factura de cliente).

Consejos y Mejores Prácticas

  • Un tipo de descuento a la vez: Recuerda que puedes usar Percent Off (porcentaje) O Amount Off (monto fijo), pero no ambos al mismo tiempo.
  • Moneda necesaria para montos fijos: Si vas a usar Amount Off, es obligatorio rellenar el campo Currency con el código de tu moneda (ej. USD, EUR).
  • Fechas futuras: Al configurar Redeem By, asegúrate de que la fecha sea posterior a la actual para evitar que el cupón sea invalidado inmediatamente.
  • Gestión de errores: Si al listar cupones no recibes resultados, revisa los campos Limit y Offset (si estuviera disponible en tu versión base) para asegurar que no hay un filtro demasiado estricto aplicándose.

Consideraciones de Seguridad

Asegúrate de utilizar siempre credenciales de tipo Stripe API con los permisos adecuados (usualmente lectura/escritura de cupones) pero evita compartir estas credenciales públicamente. Nappai gestiona estas claves de forma segura, pero es buena práctica revisar periódicamente las claves API en tu panel de Stripe para detectar cualquier uso no autorizado.