/subscriptions/{subscription_id}/activate 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.
Requires subscription.write
permission.
Path parameters
Response (200)
sub_01h04vsc0qhwtsbsxh3422wjs4sub_.^sub_[a-z\d]{26}$activeSubscription is active. Paddle is billing for this subscription and related transactions aren't past due.canceledSubscription is canceled. Automatically set by Paddle when a subscription is canceled. When a subscription is set to cancel on the next billing period, a scheduled change for the cancellation is created. The subscription status moves to canceled when the scheduled change takes effect.past_dueSubscription has an overdue payment. Automatically set by Paddle when payment fails for an automatically-collected transaction, or when payment terms have elapsed for a manually-collected transaction (an invoice).pausedSubscription is paused. Automatically set by Paddle when a subscription is paused. When a subscription is set to pause on the next billing period, a scheduled change for the pause is created. The subscription status moves topausedwhen the scheduled change takes effect.trialingSubscription is in trial.
ctm_01grnn4zta5a1mf02jjze7y2ysctm_.^ctm_[a-z\d]{26}$add_01gm302t81w94gyjpjpqypkzkfadd_.^add_[a-z\d]{26}$biz_01grrebrzaee2qj2fqqhmcyzajbiz_.^biz_[a-z\d]{26}$USD, EUR, or GBP if collection_mode is manual.USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
2024-10-12T07:20:50.52Z2024-10-13T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Zdsc_01gv5kpg05xp104ek2fmgjwttfdsc_.^dsc_[a-z\d]{26}$2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52ZrecurringDiscount applies to multiple billing periods.one-offDiscount applies to a single billing period only. Returned when a subscription is created in trial with a discount. The discount is removed from the subscription on renewal.
automaticautomatic for checkout, manual for invoices.automaticPayment is collected automatically using a checkout initially, then using a payment method on file.manualPayment is collected manually. Customers are sent an invoice with payment terms and can make a payment offline or using a checkout. Requiresbilling_details.
collection_mode is manual.falsefalse.dayweekmonthyear
null for paused and canceled subscriptions.2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Zdayweekmonthyear
null if no scheduled changes.cancelSubscription is scheduled to cancel. Its status changes tocanceledon theeffective_atdate.pauseSubscription is scheduled to pause. Its status changes topausedon theeffective_atdate.resumeSubscription is scheduled to resume. Its status changes toactiveon theeffective_atdate.
2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52ZCustomer 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.
https://buyer-portal.paddle.com/subscriptions/sub_01gtewvbsyeqyhtp2vtc2mctq8/update-payment-method?token=null for manually-collected subscriptions.https://buyer-portal.paddle.com/subscriptions/sub_01gtewvbsyeqyhtp2vtc2mctq8/cancel?token=activeThis item is active. It is not in trial and Paddle bills for it.inactiveThis item is not active. Set when the related subscription is paused.trialingThis item is in trial. Paddle has not billed for it.
false if one-time.2024-10-12T07:20:50.52Z2024-10-13T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Zpri_01gsz8z1q1n00f12qt82y31smhpri_.^pri_[a-z\d]{26}$pro_01gsz97mq9pa4fkyy0wqenepkzpro_.^pro_[a-z\d]{26}$standardcustomNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
null if price is non-recurring (one-time).dayweekmonthyear
null for no trial period. Requires billing_cycle.dayweekmonthyear
truetrue) or not (false) when trialing. If false, customers can sign up for subscription without entering their payment details, often referred to as a "cardless trial."account_settingaccount_settingPrices use the setting from your account.externalPrices are exclusive of tax.internalPrices are inclusive of tax.locationPrices are inclusive or exclusive of tax, depending on the country of the transaction.
unit_price_overrides.USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
string
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
{"minimum":1,"maximum":100}11maximum set.100100minimum set. Must be greater than or equal to the minimum value.activeactiveEntity is active and can be used.archivedEntity is archived, so can't be used.
{"customer_reference_id":"abcd1234"}null if this entity is not imported.9b95b0b8-e10f-441a-862e-1936a6d818abpaddle_classic2024-10-12T07:20:50.52Z2024-10-13T07:20:50.52Zpro_01gsz97mq9pa4fkyy0wqenepkzpro_.^pro_[a-z\d]{26}$standardcustomNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
digital-goodsNon-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered.ebooksDigital books and educational material which is sold with permanent rights for use by the customer.implementation-servicesRemote configuration, set-up, and integrating software on behalf of a customer.professional-servicesServices that involve the application of your expertise and specialized knowledge of a software product.saasProducts that allow users to connect to and use online or cloud-based applications over the Internet.
+ Show all values− Hide values
software-programming-servicesstandardSoftware products that are pre-written and can be downloaded and installed onto a local device.training-servicesTraining and education services related to software products.website-hostingCloud storage service for personal or corporate information, assets, or intellectual property.
Image Url
null
Empty String
{"customer_reference_id":"abcd1234"}activeactiveEntity is active and can be used.archivedEntity is archived, so can't be used.
null if this entity is not imported.9b95b0b8-e10f-441a-862e-1936a6d818abpaddle_classic2024-10-12T07:20:50.52Z2024-10-13T07:20:50.52Z{"customer_reference_id":"abcd1234"}null if this entity is not imported.9b95b0b8-e10f-441a-862e-1936a6d818abpaddle_classicsubconreq_01gm302t81w94gyjpjpqypkzkfsubconreq_.^subconreq_[a-z\d]{26}$trial_endingConsent required because the trial period is ending.introductory_discount_endingConsent required because an initial discount is ending.
pendingConsent not yet granted. Subscription is canceled on next renewal.grantedConsent granted. Subscription renews normally.voidedConsent voided. Consent requirement is no longer applicable, either because the consent is no longer required, or another consent requirement has replaced it.
2024-10-12T07:20:50.52Znull if there is no next_billed_at or the consent requirement does not apply to the current billing period.2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Z2024-10-12T07:20:50.52Zb15ec92e-8688-40d4-a04d-f44cbec93355{ "data": { "id": "sub_01hv915hmgnwqd9n5yxgy8t60c", "status": "active", "customer_id": "ctm_01hv8wt8nffez4p2t6typn4a5j", "address_id": "add_01hv914saqwe9wk1sbxyy9q7kq", "business_id": null, "currency_code": "USD", "created_at": "2024-04-12T11:30:29.648Z", "updated_at": "2024-04-12T11:31:10.027Z", "started_at": "2024-04-12T11:30:29.637Z", "first_billed_at": "2024-04-12T11:31:09.996Z", "next_billed_at": "2024-05-12T11:31:09.996Z", "paused_at": null, "canceled_at": null, "collection_mode": "automatic", "billing_details": null, "current_billing_period": { "starts_at": "2024-04-12T11:31:09.996Z", "ends_at": "2024-05-12T11:31:09.996Z" }, "billing_cycle": { "frequency": 1, "interval": "month" }, "scheduled_change": null, "items": [ { "status": "active", "quantity": 10, "recurring": true, "created_at": "2024-04-12T11:30:29.648Z", "updated_at": "2024-04-12T11:31:10.029Z", "previously_billed_at": "2024-04-12T11:31:09.996Z", "next_billed_at": "2024-05-12T11:31:09.996Z", "trial_dates": { "starts_at": "2024-04-12T11:30:29.637Z", "ends_at": "2024-04-12T11:31:09.996Z" }, "price": { "id": "pri_01hv0vax6rv18t4tamj848ne4d", "product_id": "pro_01htz88xpr0mm7b3ta2pjkr7w2", "type": "standard", "description": "Monthly (per seat) with 14 day trial", "name": "Monthly (per seat)", "tax_mode": "account_setting", "billing_cycle": { "frequency": 1, "interval": "month" }, "trial_period": { "frequency": 14, "interval": "day", "requires_payment_method": false }, "unit_price": { "amount": "500", "currency_code": "USD" }, "unit_price_overrides": [ { "country_codes": [ "IE", "FR", "DE" ], "unit_price": { "amount": "700", "currency_code": "EUR" } }, { "country_codes": [ "GB" ], "unit_price": { "amount": "600", "currency_code": "GBP" } } ], "custom_data": null, "status": "active", "quantity": { "minimum": 1, "maximum": 100 }, "import_meta": null, "created_at": "2024-04-09T07:14:38.424504Z", "updated_at": "2024-04-09T07:15:53.950721Z" }, "product": { "id": "pro_01htz88xpr0mm7b3ta2pjkr7w2", "name": "AeroEdit for learner pilots", "type": "standard", "tax_category": "standard", "description": "Essential tools for student pilots to manage flight logs, analyze performance, and plan routes, and ensure compliance. Valid student pilot certificate from the FAA required.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png", "custom_data": { "features": { "aircraft_performance": true, "compliance_monitoring": false, "flight_log_management": true, "payment_by_invoice": false, "route_planning": true, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": null }, "status": "active", "import_meta": null, "created_at": "2024-04-08T16:22:16.024Z", "updated_at": "2024-04-08T16:27:59.074Z" } } ], "custom_data": null, "management_urls": { "update_payment_method": "https://buyer-portal.paddle.com/subscriptions/sub_01hv915hmgnwqd9n5yxgy8t60c/update-payment-method", "cancel": "https://buyer-portal.paddle.com/subscriptions/sub_01hv915hmgnwqd9n5yxgy8t60c/cancel" }, "discount": null, "import_meta": null, "consent_requirements": [] }, "meta": { "request_id": "8e6362d5-caaa-43d9-8ec5-f912c35b697d" }}