El ciclo de vida de un vistazo
Obtener y listar
Pausar y reanudar
Pausar detiene el siguiente ciclo de facturación. El usuario conserva su acceso actual hasta que termine el periodo en curso, pero la renovación no se ejecutará. Pasauntil para programar una reanudación automática.
Cancelar
Hay dos modos de cancelación.cancel_at_period_end: true mantiene el acceso hasta la fecha de renovación actual y luego desactiva la membresía. Omítelo (o pasa false) para revocar el acceso de inmediato.
cancel_at_period_end: true cambia cancel_at_period_end a true en la membresía. El usuario conserva el acceso hasta la renovación; después la membresía se desactiva y se dispara membership.updated con previous_attributes.status establecido en el estado que dejó. Omitir el campo revoca el acceso de inmediato, así que envíalo explícitamente siempre que quieras cancelar al final del periodo.Revertir una cancelación
Si el usuario cambia de opinión antes de que termine el periodo, elimina la cancelación pendiente al final del periodo con una actualización. No tiene efecto si la membresía no estaba programada para cancelarse.Añadir días gratis
Regala al usuario tiempo extra en su periodo actual. La próxima fecha de renovación se retrasadays días. Es útil para interrupciones del servicio, gestos de atención al cliente o recompensas por referidos.
days acepta valores de 1 a 1095 (3 años).
Actualizar metadatos
Modifica metadatos arbitrarios u otros campos editables de la membresía.Escucha los eventos del ciclo de vida
Suscríbete mediante webhooks. Estos son los eventos que se disparan a lo largo del ciclo de vida:
Con
pause / resume / extend, el estado de la membresía no cambia, así que no se dispara ningún evento de activación/desactivación. Si necesitas confirmar que la mutación se completó, obtén la membresía después de la llamada o consulta periódicamente según tu propio calendario.
Próximos pasos
Acepta pagos
De dónde vienen las membresías. Checkouts de pago único y recurrentes.
Guardar métodos de pago
Tarjetas guardadas para futuras renovaciones y cobros fuera de sesión.
Escucha webhooks
Reacciona a activaciones, desactivaciones y cambios en la cancelación.
Referencia de la API de membresías
El recurso completo: campos, estados y todos los endpoints.

