Saltearse al contenido
Nappai Documentation

Stripe Subscription

Stripe Subscription gestiona las suscripciones de tu cuenta de Stripe. Una suscripción cobra a un cliente de forma periódica según un precio, por ejemplo una cuota mensual. Desde un flujo puedes suscribir a un cliente, consultar sus suscripciones, programar que una suscripción termine al final del periodo o cancelarla en el momento.

Cuándo usarlo

  • Un cliente elige un plan en tu web y quieres darle de alta la suscripción en Stripe.
  • Quieres ofrecer unos días de prueba gratuita al empezar la suscripción.
  • Un cliente pide la baja y quieres que su suscripción termine al acabar el periodo que ya ha pagado.
  • Cada semana quieres revisar las suscripciones con pagos atrasados para avisar al cliente.

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 una suscripción concreta; All devuelve la lista de suscripciones. Por defecto, By ID.
Subscription IDEl identificador de la suscripción en Stripe (empieza por sub_). Obligatorio en Cancel, Update y Get con By ID.
Customer IDEl identificador del cliente en Stripe (empieza por cus_). Obligatorio en Create. En Get con All, muestra solo las suscripciones de ese cliente.
Price IDSolo en Create, y obligatorio en ella. El precio al que se suscribe el cliente (empieza por price_). Tiene que ser un precio periódico; créalo con Stripe Price y Type en recurring.
Payment Method IDSolo en Create. La forma de pago con la que se cobrará la suscripción (empieza por pm_). Se guarda en el cliente como forma de pago predeterminada. Viene rellenado con pm_card_visa, una tarjeta de pruebas de Stripe: cámbialo por la forma de pago real del cliente cuando uses la clave real, o vacíalo para usar la que el cliente ya tenga.
Trial Period DaysSolo en Create. Días de prueba gratuita antes del primer cobro.
Cancel at Period EndSolo en Update. true hace que la suscripción termine al acabar el periodo actual; false deshace esa baja programada.
Status FilterSolo en Get con All. Devuelve solo las suscripciones en ese estado, por ejemplo active (activa), trialing (en prueba), past_due (pago atrasado), unpaid (impagada) o canceled (cancelada).
LimitSolo en Get con All. Número máximo de suscripciones que se devuelven, entre 1 y 100. Por defecto, 100.

Operaciones

  • Cancel: cancela la suscripción en el momento. Para que termine al final del periodo, usa Update con Cancel at Period End en true.
  • Create: suscribe a un cliente a un precio periódico. Si el precio no es periódico, el componente se detiene y lo explica.
  • Get: con By ID devuelve una suscripción; con All devuelve la lista, filtrada por cliente o estado si lo indicas.
  • Update: programa o deshace la baja al final del periodo.

Resultado

La salida Data devuelve la suscripción con la que has trabajado. Con Get y All, devuelve un elemento por cada suscripción. Cada elemento incluye, entre otros datos de Stripe, el identificador de la suscripción, el cliente, su estado y las fechas del periodo actual.

Puedes conectarla a un correo de bienvenida o de baja, a tu CRM o a una condición que mire el estado. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Un club de vinos da de alta la suscripción mensual de cada socio nuevo con un mes de prueba.

  1. Crea el cliente con Stripe Customer y pasa su identificador a Customer ID.
  2. Añade Stripe Subscription con Operation en Create.
  3. En Price ID, pon el precio mensual del club y, en Payment Method ID, la forma de pago del socio.
  4. Pon Trial Period Days en 30.
  5. Conecta la salida Data a un correo de bienvenida que indique cuándo será el primer cobro.

Buenas prácticas

  • Cuando un cliente pida la baja, usa Update con Cancel at Period End en true en lugar de Cancel, así disfruta del periodo que ya ha pagado.
  • Prueba tus flujos con la clave de pruebas de Stripe antes de usar la clave real.

Componentes relacionados