Actualizar una suscripción | Documentación API de Recurrente

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"`.

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-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

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

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".

Tu llave secreta de API

ID de la suscripción

This endpoint expects an object.

Suscripción actualizada

ID único de la suscripción

Descripción de la suscripción

Estado de la suscripción

Última actualización

Inicio del período de facturación actual

Fin del período de facturación actual

Nombre fiscal del suscriptor

ID fiscal del suscriptor

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

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

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

Método de pago predeterminado de la suscripción

$	curl -X PUT https://app.recurrente.com/api/subscriptions/id \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"payment_method_id": "pay_m_7v5ie3pw"
>	}'

1	{
2	"id": "su_nehndm7j",
3	"description": "One Free-Testable Banana",
4	"status": "active",
5	"default_payment_method": {
6	"id": "pay_m_7v5ie3pw",
7	"type": "card",
8	"card": {
9	"last4": "4242",
10	"network": "visa"
11	}
12	}
13	}

$	curl -X PUT https://app.recurrente.com/api/subscriptions/id \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"payment_method_id": "pay_m_7v5ie3pw"
>	}'

1	{
2	"id": "su_nehndm7j",
3	"description": "One Free-Testable Banana",
4	"status": "active",
5	"default_payment_method": {
6	"id": "pay_m_7v5ie3pw",
7	"type": "card",
8	"card": {
9	"last4": "4242",
10	"network": "visa"
11	}
12	}
13	}