Activate a trialing subscription
Activates a trialing subscription using its ID. Only automatically-collected subscriptions where the status is trialing can be activated.
On activation, Paddle bills for a subscription immediately. Subscription billing dates are recalculated based on the activation date (the time the activation request is made).
If successful, Paddle returns a copy of the updated subscription entity. The subscription status is active, and billing dates are updated to reflect the activation date.
This operation results in an immediate charge, so responses may take longer than usual while a payment attempt is processed.
Path Parameters
Paddle ID of the subscription entity to work with.
Response
Represents a subscription entity.
Unique Paddle ID for this subscription entity, prefixed with sub_.
Status of this subscription. Set automatically by Paddle. Use the pause subscription or cancel subscription operations to change.
Paddle ID of the customer that this subscription is for, prefixed with ctm_.
Paddle ID of the address that this subscription is for, prefixed with add_.
Paddle ID of the business that this subscription is for, prefixed with biz_.
Supported three-letter ISO 4217 currency code. Transactions for this subscription are created in this currency. Must be USD, EUR, or GBP if collection_mode is manual.
RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
RFC 3339 datetime string of when this subscription started. This may be different from first_billed_at if the subscription started in trial.
RFC 3339 datetime string of when this subscription was first billed. This may be different from started_at if the subscription started in trial.
RFC 3339 datetime string of when this subscription is next scheduled to be billed.
RFC 3339 datetime string of when this subscription was paused. Set automatically by Paddle when the pause subscription operation is used. null if not paused.
RFC 3339 datetime string of when this subscription was canceled. Set automatically by Paddle when the cancel subscription operation is used. null if not canceled.
Details of the discount applied to this subscription.
How payment is collected for transactions created for this subscription. automatic for checkout, manual for invoices.
Details for invoicing. Required if collection_mode is manual.
Current billing period for this subscription. Set automatically by Paddle based on the billing cycle. null for paused and canceled subscriptions.
How often this subscription renews. Set automatically by Paddle based on the prices on this subscription.
Change that's scheduled to be applied to a subscription. Use the pause subscription, cancel subscription, and resume subscription operations to create scheduled changes. null if no scheduled changes.
Customer portal deep links for this subscription.
Authenticated links are only returned when your API key has Customer portal session (Write) permission. For security, the token appended to authenticated links is temporary. You shouldn't store them.
List of items on this subscription. Only recurring items are returned.
Your own structured key-value data.
Import information for this entity. null if this entity is not imported.
Information about this response.
Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.