Saltearse al contenido
Nappai Documentation

Stripe Plan

Stripe Plan gestiona los planes de tu cuenta de Stripe. Un plan define cuánto y cada cuánto se cobra por un producto, por ejemplo 29,00 € al mes, y es lo que se asigna a un cliente cuando se suscribe. Desde un flujo puedes crear planes, consultarlos y eliminarlos.

Los planes y los precios periódicos de Stripe Price cumplen la misma función. Si empiezas de cero, puedes usar cualquiera de los dos.

Cuándo usarlo

  • Lanzas un producto nuevo con cuota mensual y quieres crear su plan desde un flujo.
  • Quieres ofrecer un periodo de prueba gratuito de unos días en un plan.
  • Quieres revisar los planes que tienes en Stripe.
  • Un plan ya no se ofrece y quieres eliminarlo.

Configuración

Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Stripe API de tu cuenta.
Operation (obligatorio)La acción que realiza el componente. Por defecto, Create. Consulta Operaciones.
ModeSolo en Get. By ID consulta un plan concreto; All devuelve la lista de planes. Por defecto, By ID.
Plan IDEl identificador del plan en Stripe. Obligatorio en Delete y en Get con By ID.
AmountSolo en Create, y obligatorio en ella. El importe de cada cobro en la unidad más pequeña de la moneda, por ejemplo céntimos: 2900 son 29,00.
CurrencySolo en Create, y obligatorio en ella. La moneda del plan, como eur o usd. Por defecto, usd.
Billing IntervalSolo en Create, y obligatorio en ella. Cada cuánto se cobra: month (mes), day (día), week (semana) o year (año). Por defecto, month.
Interval CountSolo en Create. Cuántos intervalos pasan entre cobros. Por ejemplo, 3 con month cobra cada tres meses. Por defecto, 1.
Product IDSolo en Create, y obligatorio en ella. El producto de Stripe al que pertenece el plan (empieza por prod_). Créalo antes con Stripe Product.
Trial Period DaysSolo en Create. Días de prueba gratuita antes del primer cobro.
LimitSolo en Get con All. Número máximo de planes que se devuelven, entre 1 y 100. Por defecto, 100.

Operaciones

  • Create: crea un plan para un producto con el importe y la periodicidad indicados.
  • Delete: elimina un plan para que no se pueda asignar a nuevas suscripciones.
  • Get: con By ID devuelve un plan; con All devuelve la lista de planes.

Resultado

La salida Data devuelve el plan creado, consultado o eliminado. Con Get y All, devuelve un elemento por cada plan. Cada elemento incluye el identificador del plan, el importe, la moneda y la periodicidad.

Puedes conectarla a tu catálogo o a un mensaje para el equipo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Una plataforma de cursos lanza una suscripción trimestral con 14 días de prueba.

  1. Crea el producto “Acceso a cursos” con Stripe Product y guarda su identificador.
  2. Añade Stripe Plan con Operation en Create y pasa ese identificador a Product ID.
  3. Pon Amount en 7500, Currency en eur, Billing Interval en month, Interval Count en 3 y Trial Period Days en 14.
  4. Conecta la salida Data a un mensaje para el equipo comercial con el identificador del nuevo plan.

Componentes relacionados