Skip to main content
POST
cURL
Reactivates a subscription. A past_due subscription retries its outstanding renewal charge (recovering to active on success). A canceled subscription generates a fresh invoice, charges the saved card, and resets the billing period. On a successful charge the subscription becomes active; a declined charge returns an error with a recoveryUrl in the error details that can be sent to the customer to update their card. A canceled subscription may apply an Offer by offerId; past-due recovery cannot.

Autorizaciones

x-api-key
string
header
requerido

Encabezados

Idempotency-Key
string

Unique key used to safely retry this write for 24 hours without applying it twice.

Required string length: 1 - 200
Commet-Version
string
predeterminado:2026-08-27

API version used by this reference. Send this header to select this contract explicitly.

Parámetros de ruta

id
string
requerido

Cuerpo

application/json
offerId
string
Minimum string length: 1

Respuesta

Success

subscriptionId
string
requerido
invoiceId
string
requerido
status
enum<string>
requerido
Opciones disponibles:
processing,
succeeded
object
string
requerido
Allowed value: "subscription_reactivation"
livemode
boolean
requerido
offerApplication
object