Pause a subscription
Pauses a subscription using its ID.
By default, subscriptions are paused at the end of the billing period. When you send a request to pause, Paddle creates a scheduled_change
against the subscription entity to say that it should pause at the end of the current billing period. Its status
remains active
until after the effective date of the scheduled change, at which point it changes to paused
.
You can pause a subscription right away by including effective_from
in your request, setting the value to immediately
. If successful, your response includes a copy of the updated subscription entity with the status
of paused
.
To set a resume date, include the resume_at
field in your request. The subscription remains paused until the resume date, or until you send a resume request. Omit to create an open-ended pause. The subscription remains paused indefinitely, until you send a resume request.
Path Parameters
Paddle ID of the subscription entity to work with.
Request Body
When this subscription change should take effect from. Defaults to next_billing_period
for active subscriptions, which creates a scheduled_change
to apply the subscription change at the end of the billing period.
RFC 3339 datetime string of when the paused subscription should resume. Omit to pause indefinitely until resumed.
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.
Public URLs that customers can use to make changes to this subscription. For security, the token
appended to each link is temporary. You shouldn't store these links.
Represents a subscription item.
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.
12341{
2 "effective_from": "next_billing_period",
3 "resume_at": "2024-09-01T16:30:00Z"
4}