Activate Subscription
POST/subscriptions/:id/activate
Activates a subscription by attaching a payment method and initiating the billing cycle.
Activation Process:
- This endpoint transitions a
PENDING
subscription toACTIVE
status - An initial payment is created to validate the payment method:
- For regular subscriptions: First billing cycle payment is processed immediately
- For trial subscriptions: A zero-amount payment is created to verify the payment method
Payment Method Updates: If the subscription is already active, this endpoint can be used to update the payment method. The update process creates a zero-amount payment to verify the new payment method works correctly.
Important Notes:
- Subscription billing begins immediately upon successful activation (unless in trial period)
- The payment method provided will be used for all future recurring charges
- Activation failures (due to invalid payment method) will keep the subscription in
PENDING
status
Request
Responses
- 200
- 400
- 401
- 404
- 422
- 500
- 503
A subscription object
The request is incorrect or could not be processed
Unauthorized error. Please check your auth credentials
The specified resource was not found
The request was well-formed but could not be processed due to semantic errors
Unexpected server error
The service is temporarily unavailable