Skip to main content
Una membresía es la relación activa entre un usuario y un producto. Registra el acceso, el estado de facturación y el calendario de renovación. No creas membresías directamente porque el checkout lo hace por ti. Una vez que existe una membresía, puedes consultarla, pausar o cancelar la facturación, regalar tiempo o actualizar los metadatos.
La mayoría de las apps no necesitan gestionar membresías en absoluto. Recurre a estos métodos cuando crees herramientas de administración, flujos de atención al cliente o paneles de autoservicio que permitan a los usuarios pausar o cancelar.

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á. Pasa until 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 retrasa days 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.