Occurs when a subscription is paused. Its status field changes to paused.
If you choose to pause a subscription immediately, the subscription status changes to paused and subscription.paused occurs.
If you choose to pause a subscription on the next billing period, Paddle creates a scheduled change to say the subscription should be paused on the next billing date. subscription.updated occurs at this point. On the next billing date, the subscription status changes to paused and subscription.paused occurs.
Payload includes the complete subscription entity, except management_urls. Subscription management links are temporary, so they're not included. Get a subscription using the API to get management links for a subscription.
evt_01gks14ge726w50ch2tmaw2a1xevt_.^evt_[a-z\d]{26}$entity.event_type.address.createdAnaddress.createdevent.address.importedAnaddress.importedevent.address.updatedAnaddress.updatedevent.adjustment.createdAnadjustment.createdevent.adjustment.updatedAnadjustment.updatedevent.
+ Show all values− Hide values
api_key.createdAnapi_key.createdevent.api_key.expiredAnapi_key.expiredevent.api_key.expiringAnapi_key.expiringevent.api_key.revokedAnapi_key.revokedevent.api_key.updatedAnapi_key.updatedevent.api_key_exposure.createdAnapi_key_exposure.createdevent.business.createdAbusiness.createdevent.business.importedAbusiness.importedevent.business.updatedAbusiness.updatedevent.client_token.createdAclient_token.createdevent.client_token.revokedAclient_token.revokedevent.client_token.updatedAclient_token.updatedevent.customer.createdAcustomer.createdevent.customer.importedAcustomer.importedevent.customer.updatedAcustomer.updatedevent.discount.createdAdiscount.createdevent.discount.importedAdiscount.importedevent.discount.updatedAdiscount.updatedevent.discount_group.createdAdiscount_group.createdevent.discount_group.updatedAdiscount_group.updatedevent.payment_method.savedApayment_method.savedevent.payment_method.deletedApayment_method.deletedevent.payout.createdApayout.createdevent.payout.paidApayout.paidevent.price.createdAprice.createdevent.price.importedAprice.importedevent.price.updatedAprice.updatedevent.product.createdAproduct.createdevent.product.importedAproduct.importedevent.product.updatedAproduct.updatedevent.report.createdAreport.createdevent.report.updatedAreport.updatedevent.subscription.activatedAsubscription.activatedevent.subscription.canceledAsubscription.canceledevent.subscription.createdAsubscription.createdevent.subscription.importedAsubscription.importedevent.subscription.past_dueAsubscription.past_dueevent.subscription.pausedAsubscription.pausedevent.subscription.resumedAsubscription.resumedevent.subscription.trialingAsubscription.trialingevent.subscription.updatedAsubscription.updatedevent.transaction.billedAtransaction.billedevent.transaction.canceledAtransaction.canceledevent.transaction.completedAtransaction.completedevent.transaction.createdAtransaction.createdevent.transaction.paidAtransaction.paidevent.transaction.past_dueAtransaction.past_dueevent.transaction.payment_failedAtransaction.payment_failedevent.transaction.readyAtransaction.readyevent.transaction.revisedAtransaction.revisedevent.transaction.updatedAtransaction.updatedevent.
2024-10-12T07:20:50.52Zntf_01ghbkd0frb9k95cnhwd1bxpvkntf_.^ntf_[a-z\d]{26}$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}$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-12T07: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.
automatic 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.52ZactiveThis 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.52Zsubconreq_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.52Z{"customer_reference_id":"abcd1234"}null if this entity is not imported.9b95b0b8-e10f-441a-862e-1936a6d818abpaddle_classic{ "event_id": "evt_01hv95bn2k322d8y74ks0ppgmk", "event_type": "subscription.paused", "occurred_at": "2024-04-12T12:43:44.083397Z", "notification_id": "ntf_01hv95bn52k92r8je00te7wfke", "data": { "id": "sub_01hv8x29kz0t586xy6zn1a62ny", "items": [ { "price": { "id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "name": "Monthly (per seat)", "type": "standard", "status": "active", "quantity": { "maximum": 999, "minimum": 1 }, "tax_mode": "account_setting", "created_at": "2023-02-23T13:55:22.538367Z", "product_id": "pro_01gsz4t5hdjse780zja8vvr7jg", "unit_price": { "amount": "3000", "currency_code": "USD" }, "updated_at": "2024-04-11T13:54:52.254748Z", "custom_data": null, "description": "Monthly", "import_meta": null, "trial_period": null, "billing_cycle": { "interval": "month", "frequency": 1 }, "unit_price_overrides": [] }, "product": { "id": "pro_01gsz4t5hdjse780zja8vvr7jg", "name": "AeroEdit Pro", "type": "standard", "tax_category": "standard", "description": "Designed for professional pilots, including all features plus in Basic plus compliance monitoring, route optimization, and third-party integrations.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png", "custom_data": { "features": { "aircraft_performance": true, "compliance_monitoring": true, "flight_log_management": true, "payment_by_invoice": false, "route_planning": true, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": "Move from Basic to Pro to take advantage of aircraft performance, advanced route planning, and compliance monitoring." }, "status": "active", "import_meta": null, "created_at": "2023-02-23T12:43:46.605Z", "updated_at": "2024-04-05T15:53:44.687Z" }, "status": "active", "quantity": 10, "recurring": true, "created_at": "2024-04-12T12:42:27.89Z", "updated_at": "2024-04-12T12:42:27.89Z", "trial_dates": null, "next_billed_at": null, "previously_billed_at": "2024-04-12T12:42:27.185672Z" }, { "price": { "id": "pri_01h1vjfevh5etwq3rb416a23h2", "name": "Monthly (recurring addon)", "type": "standard", "status": "active", "quantity": { "maximum": 100, "minimum": 1 }, "tax_mode": "account_setting", "created_at": "2023-06-01T13:31:12.625056Z", "product_id": "pro_01h1vjes1y163xfj1rh1tkfb65", "unit_price": { "amount": "10000", "currency_code": "USD" }, "updated_at": "2024-04-12T10:42:45.476453Z", "custom_data": null, "description": "Monthly", "import_meta": null, "trial_period": null, "billing_cycle": { "interval": "month", "frequency": 1 }, "unit_price_overrides": [] }, "product": { "id": "pro_01h1vjes1y163xfj1rh1tkfb65", "name": "Analytics addon", "type": "standard", "tax_category": "standard", "description": "Unlock advanced insights into your flight data with enhanced analytics and reporting features. Includes customizable reporting templates and trend analysis across flights.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/97dRpA6SXzcE6ekK9CAr_analytics.png", "custom_data": null, "status": "active", "import_meta": null, "created_at": "2023-06-01T13:30:50.302Z", "updated_at": "2024-04-05T15:47:17.163Z" }, "status": "active", "quantity": 1, "recurring": true, "created_at": "2024-04-12T12:42:27.89Z", "updated_at": "2024-04-12T12:42:27.89Z", "trial_dates": null, "next_billed_at": null, "previously_billed_at": "2024-04-12T12:42:27.185672Z" } ], "status": "paused", "discount": null, "paused_at": "2024-04-12T12:43:43.214Z", "address_id": "add_01hv8gq3318ktkfengj2r75gfx", "created_at": "2024-04-12T12:42:27.89Z", "started_at": "2024-04-12T12:42:27.185672Z", "updated_at": "2024-04-12T12:43:43.219Z", "business_id": null, "canceled_at": null, "custom_data": null, "customer_id": "ctm_01hv6y1jedq4p1n0yqn5ba3ky4", "import_meta": null, "billing_cycle": { "interval": "month", "frequency": 1 }, "currency_code": "USD", "next_billed_at": null, "billing_details": null, "collection_mode": "automatic", "first_billed_at": "2024-04-12T12:42:27.185672Z", "scheduled_change": null, "consent_requirements": [], "current_billing_period": null }}