Referencia APISubscriptions

Actualizar una suscripción

Actualiza una suscripción. Puedes: - **Cambiar el método de pago**: Envía `payment_method_id` con el ID de un método de pago activo del suscriptor. Si la suscripción tiene un pago pendiente, se intentará cobrar automáticamente con el nuevo método de pago. - **Pausar**: Envía `act: "pause"`. Opcionalmente, incluye `resumes_on` para reactivación automática. - **Reactivar**: Envía `act: "unpause"`.

Authentication

X-PUBLIC-KEYstring

Tu llave pública de API

X-SECRET-KEYstring
Tu llave secreta de API

Path parameters

idstringRequired

ID de la suscripción

Request

This endpoint expects an object.
Cambiar método de pagoobjectRequired
OR
Pausar o reactivarobjectRequired

Response

Suscripción actualizada

idstring

ID único de la suscripción

descriptionstring

Descripción de la suscripción

statusenum

Estado de la suscripción

Allowed values:
created_atdatetime

Fecha de creación

updated_atdatetime

Última actualización

current_period_startdatetime or null

Inicio del período de facturación actual

current_period_enddatetime or null

Fin del período de facturación actual

tax_namestring or null
Nombre fiscal del suscriptor
tax_idstring or null
ID fiscal del suscriptor
resumes_ondate or null

Fecha de reactivación automática (si está pausada)

next_payment_attempt_atdatetime or null

Próximo intento de cobro automático (solo cuando el estado es past_due)

payment_retriesinteger

Número de reintentos de cobro realizados para el período actual

default_payment_methodobject or null

Método de pago predeterminado de la suscripción

subscriberobject
checkoutobject or null
productobject

Errors

400
Bad Request Error
404
Not Found Error
422
Unprocessable Entity Error