paddle-python-sdk 1.14.1__tar.gz → 1.15.0__tar.gz

{paddle_python_sdk-1.14.1/paddle_python_sdk.egg-info → paddle_python_sdk-1.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paddle-python-sdk
-Version: 1.14.1
+Version: 1.15.0
 Summary: Paddle's Python SDK for Paddle Billing
 Home-page: https://developer.paddle.com/api-reference/overview
 Author: Paddle and contributors

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/examples/catalog_management.py

@@ -11,6 +11,7 @@ from paddle_billing.Entities.Shared import (
     Duration,
     Money,
     PriceQuantity,
+    PriceTrialPeriod,
     UnitPriceOverride,
     Interval,
     Status,
@@ -86,7 +87,7 @@ try:
             description="Bear Hug",
             product_id=product.id,
             unit_price=Money("1000", CurrencyCode.GBP),
-            trial_period=Duration(Interval.Week, 1),
+            trial_period=PriceTrialPeriod(Interval.Week, 1),
             billing_cycle=Duration(Interval.Year, 1),
             quantity=PriceQuantity(1, 1),
             custom_data=CustomData({"foo": "bar"}),

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Client.py

@@ -18,6 +18,7 @@ from paddle_billing.Logger.NullHandler import NullHandler
 from paddle_billing.Resources.Addresses.AddressesClient import AddressesClient
 from paddle_billing.Resources.Adjustments.AdjustmentsClient import AdjustmentsClient
 from paddle_billing.Resources.Businesses.BusinessesClient import BusinessesClient
+from paddle_billing.Resources.CheckoutDomains.CheckoutDomainsClient import CheckoutDomainsClient
 from paddle_billing.Resources.ClientTokens.ClientTokensClient import ClientTokensClient
 from paddle_billing.Resources.Customers.CustomersClient import CustomersClient
 from paddle_billing.Resources.CustomerPortalSessions.CustomerPortalSessionsClient import CustomerPortalSessionsClient
@@ -73,6 +74,7 @@ class Client:
         self.addresses = AddressesClient(self)
         self.adjustments = AdjustmentsClient(self)
         self.businesses = BusinessesClient(self)
+        self.checkout_domains = CheckoutDomainsClient(self)
         self.client_tokens = ClientTokensClient(self)
         self.customers = CustomersClient(self)
         self.customer_portal_sessions = CustomerPortalSessionsClient(self)
@@ -203,7 +205,7 @@ class Client:
                 "Authorization": f"Bearer {self.__api_key}",
                 "Content-Type": "application/json",
                 "Paddle-Version": str(self.use_api_version),
-                "User-Agent": "PaddleSDK/python 1.14.1",
+                "User-Agent": "PaddleSDK/python 1.15.0",
             }
         )
 

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomain.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Any
+
+from paddle_billing.Entities.Entity import Entity
+from paddle_billing.Entities.CheckoutDomains import CheckoutDomainPaymentMethodVerification, CheckoutDomainStatus
+
+
+@dataclass
+class CheckoutDomain(Entity):
+    id: str
+    domain: str
+    status: CheckoutDomainStatus
+    payment_method_verification: CheckoutDomainPaymentMethodVerification
+    created_at: datetime
+    updated_at: datetime
+
+    @staticmethod
+    def from_dict(data: dict[str, Any]) -> CheckoutDomain:
+        return CheckoutDomain(
+            id=data["id"],
+            domain=data["domain"],
+            status=CheckoutDomainStatus(data["status"]),
+            payment_method_verification=CheckoutDomainPaymentMethodVerification.from_dict(
+                data["payment_method_verification"]
+            ),
+            created_at=datetime.fromisoformat(data["created_at"]),
+            updated_at=datetime.fromisoformat(data["updated_at"]),
+        )

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomains/CheckoutDomainApplePayVerification.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import Any
+
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainPaymentMethodVerificationStatus import (
+    CheckoutDomainPaymentMethodVerificationStatus,
+)
+
+
+@dataclass
+class CheckoutDomainApplePayVerification:
+    status: CheckoutDomainPaymentMethodVerificationStatus
+
+    @staticmethod
+    def from_dict(data: dict[str, Any]) -> CheckoutDomainApplePayVerification:
+        return CheckoutDomainApplePayVerification(
+            status=CheckoutDomainPaymentMethodVerificationStatus(data["status"]),
+        )

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomains/CheckoutDomainPaymentMethod.py

@@ -0,0 +1,5 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class CheckoutDomainPaymentMethod(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    ApplePay: "CheckoutDomainPaymentMethod" = "apple_pay"

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomains/CheckoutDomainPaymentMethodVerification.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import Any
+
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainApplePayVerification import (
+    CheckoutDomainApplePayVerification,
+)
+
+
+@dataclass
+class CheckoutDomainPaymentMethodVerification:
+    apple_pay: CheckoutDomainApplePayVerification
+
+    @staticmethod
+    def from_dict(data: dict[str, Any]) -> CheckoutDomainPaymentMethodVerification:
+        return CheckoutDomainPaymentMethodVerification(
+            apple_pay=CheckoutDomainApplePayVerification.from_dict(data["apple_pay"]),
+        )

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomains/CheckoutDomainPaymentMethodVerificationStatus.py

@@ -0,0 +1,6 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class CheckoutDomainPaymentMethodVerificationStatus(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    Verified: "CheckoutDomainPaymentMethodVerificationStatus" = "verified"
+    Unverified: "CheckoutDomainPaymentMethodVerificationStatus" = "unverified"

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomains/CheckoutDomainStatus.py

@@ -0,0 +1,9 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class CheckoutDomainStatus(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    PendingReview: "CheckoutDomainStatus" = "pending_review"
+    Approved: "CheckoutDomainStatus" = "approved"
+    Rejected: "CheckoutDomainStatus" = "rejected"
+    InReview: "CheckoutDomainStatus" = "in_review"
+    ActionRequired: "CheckoutDomainStatus" = "action_required"

paddle_python_sdk-1.15.0/paddle_billing/Entities/CheckoutDomains/__init__.py

@@ -0,0 +1,11 @@
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainStatus import CheckoutDomainStatus
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainPaymentMethod import CheckoutDomainPaymentMethod
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainPaymentMethodVerificationStatus import (
+    CheckoutDomainPaymentMethodVerificationStatus,
+)
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainApplePayVerification import (
+    CheckoutDomainApplePayVerification,
+)
+from paddle_billing.Entities.CheckoutDomains.CheckoutDomainPaymentMethodVerification import (
+    CheckoutDomainPaymentMethodVerification,
+)

paddle_python_sdk-1.15.0/paddle_billing/Entities/Collections/CheckoutDomainCollection.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from typing import Any
+
+from paddle_billing.Entities.Collections.Collection import Collection
+from paddle_billing.Entities.Collections.Paginator import Paginator
+from paddle_billing.Entities.CheckoutDomain import CheckoutDomain
+
+
+class CheckoutDomainCollection(Collection[CheckoutDomain]):
+    @classmethod
+    def from_list(
+        cls, items_data: list[dict[str, Any]], paginator: Paginator | None = None
+    ) -> CheckoutDomainCollection:
+        items: list[CheckoutDomain] = [CheckoutDomain.from_dict(item) for item in items_data]
+
+        return CheckoutDomainCollection(items, paginator)

paddle_python_sdk-1.15.0/paddle_billing/Entities/Collections/SubscriptionHistoryCollection.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from typing import Any
+
+from paddle_billing.Entities.Collections.Collection import Collection
+from paddle_billing.Entities.Collections.Paginator import Paginator
+from paddle_billing.Entities.Subscriptions.History.SubscriptionHistory import SubscriptionHistory
+
+
+class SubscriptionHistoryCollection(Collection[SubscriptionHistory]):
+    @classmethod
+    def from_list(
+        cls, items_data: list[dict[str, Any]], paginator: Paginator | None = None
+    ) -> SubscriptionHistoryCollection:
+        items: list[SubscriptionHistory] = [SubscriptionHistory.from_dict(item) for item in items_data]
+
+        return SubscriptionHistoryCollection(items, paginator)

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Collections/__init__.py

@@ -1,6 +1,7 @@
 from paddle_billing.Entities.Collections.AddressCollection import AddressCollection
 from paddle_billing.Entities.Collections.AdjustmentCollection import AdjustmentCollection
 from paddle_billing.Entities.Collections.BusinessCollection import BusinessCollection
+from paddle_billing.Entities.Collections.CheckoutDomainCollection import CheckoutDomainCollection
 from paddle_billing.Entities.Collections.ClientTokenCollection import ClientTokenCollection
 from paddle_billing.Entities.Collections.Collection import Collection
 from paddle_billing.Entities.Collections.CreditBalanceCollection import CreditBalanceCollection
@@ -22,6 +23,7 @@ from paddle_billing.Entities.Collections.SimulationRunCollection import Simulati
 from paddle_billing.Entities.Collections.SimulationRunEventCollection import SimulationRunEventCollection
 from paddle_billing.Entities.Collections.SimulationTypeCollection import SimulationTypeCollection
 from paddle_billing.Entities.Collections.SubscriptionCollection import SubscriptionCollection
+from paddle_billing.Entities.Collections.SubscriptionHistoryCollection import SubscriptionHistoryCollection
 from paddle_billing.Entities.Collections.SubscriptionPreviewCollection import SubscriptionPreviewCollection
 from paddle_billing.Entities.Collections.TransactionCollection import TransactionCollection
 from paddle_billing.Entities.Collections.TransactionPreviewCollection import TransactionPreviewCollection

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Price.py

@@ -11,6 +11,7 @@ from paddle_billing.Entities.Shared import (
     ImportMeta,
     Money,
     PriceQuantity,
+    PriceTrialPeriod,
     Status,
     TaxMode,
     UnitPriceOverride,
@@ -25,7 +26,7 @@ class Price(Entity):
     description: str
     type: CatalogType | None
     billing_cycle: Duration | None
-    trial_period: Duration | None
+    trial_period: PriceTrialPeriod | None
     tax_mode: TaxMode
     unit_price: Money
     unit_price_overrides: list[UnitPriceOverride]
@@ -55,7 +56,7 @@ class Price(Entity):
             ],
             type=CatalogType(data.get("type")) if data.get("type") else None,
             billing_cycle=Duration.from_dict(data["billing_cycle"]) if data.get("billing_cycle") else None,
-            trial_period=Duration.from_dict(data["trial_period"]) if data.get("trial_period") else None,
+            trial_period=PriceTrialPeriod.from_dict(data["trial_period"]) if data.get("trial_period") else None,
             custom_data=CustomData(data["custom_data"]) if data.get("custom_data") else None,
             import_meta=ImportMeta.from_dict(data["import_meta"]) if data.get("import_meta") else None,
             product=Product.from_dict(data["product"]) if data.get("product") else None,

paddle_python_sdk-1.15.0/paddle_billing/Entities/Reports/BalanceMovementType.py

@@ -0,0 +1,13 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class BalanceMovementType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    Rebate: "BalanceMovementType" = "rebate"
+    SwiftFee: "BalanceMovementType" = "swift_fee"
+    Sale: "BalanceMovementType" = "sale"
+    Refund: "BalanceMovementType" = "refund"
+    ChargebackWarning: "BalanceMovementType" = "chargeback_warning"
+    ChargebackWarningReverse: "BalanceMovementType" = "chargeback_warning_reverse"
+    Chargeback: "BalanceMovementType" = "chargeback"
+    ChargebackReverse: "BalanceMovementType" = "chargeback_reverse"
+    Credit: "BalanceMovementType" = "credit"

paddle_python_sdk-1.15.0/paddle_billing/Entities/Reports/CheckoutsReportType.py

@@ -0,0 +1,7 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+from paddle_billing.Entities.Reports.ReportType import ReportType
+
+
+class CheckoutsReportType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    Checkouts: "CheckoutsReportType" = ReportType.Checkouts.value

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Reports/ReportFilterName.py

@@ -3,8 +3,12 @@ from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
 
 class ReportFilterName(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     Action: "ReportFilterName" = "action"
+    BalanceMovementDate: "ReportFilterName" = "balance_movement_date"
+    BalanceMovementType: "ReportFilterName" = "balance_movement_type"
+    CheckoutCreatedAt: "ReportFilterName" = "checkout_created_at"
     CollectionMode: "ReportFilterName" = "collection_mode"
     CurrencyCode: "ReportFilterName" = "currency_code"
+    CustomerCountryCode: "ReportFilterName" = "customer_country_code"
     Origin: "ReportFilterName" = "origin"
     PriceStatus: "ReportFilterName" = "price_status"
     PriceType: "ReportFilterName" = "price_type"

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Reports/ReportType.py

@@ -10,3 +10,4 @@ class ReportType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     TransactionLineItems: "ReportType" = "transaction_line_items"
     Balance: "ReportType" = "balance"
     PayoutReconciliation: "ReportType" = "payout_reconciliation"
+    Checkouts: "ReportType" = "checkouts"

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Reports/__init__.py

@@ -1,5 +1,7 @@
 from paddle_billing.Entities.Reports.AdjustmentsReportType import AdjustmentsReportType
+from paddle_billing.Entities.Reports.BalanceMovementType import BalanceMovementType
 from paddle_billing.Entities.Reports.BalanceReportType import BalanceReportType
+from paddle_billing.Entities.Reports.CheckoutsReportType import CheckoutsReportType
 from paddle_billing.Entities.Reports.DiscountsReportType import DiscountsReportType
 from paddle_billing.Entities.Reports.PayoutReconciliationReportType import PayoutReconciliationReportType
 from paddle_billing.Entities.Reports.ProductsPricesReportType import ProductsPricesReportType

paddle_python_sdk-1.15.0/paddle_billing/Entities/Shared/ActionSource.py

@@ -0,0 +1,14 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class ActionSource(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    System: "ActionSource" = "system"
+    Api: "ActionSource" = "api"
+    Dashboard: "ActionSource" = "dashboard"
+    CustomerPortal: "ActionSource" = "customer_portal"
+    SupportBot: "ActionSource" = "support_bot"
+    Retain: "ActionSource" = "retain"
+    Checkout: "ActionSource" = "checkout"
+    ExternalProvider: "ActionSource" = "external_provider"
+    PaddleClassic: "ActionSource" = "paddle_classic"
+    Unknown: "ActionSource" = "unknown"

paddle_python_sdk-1.15.0/paddle_billing/Entities/Shared/Actor.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import Any
+
+from paddle_billing.Entities.Shared.ActorType import ActorType
+
+
+@dataclass
+class Actor:
+    type: ActorType
+    id: str | None
+
+    @staticmethod
+    def from_dict(data: dict[str, Any]) -> Actor:
+        return Actor(
+            type=ActorType(data["type"]),
+            id=data.get("id"),
+        )

paddle_python_sdk-1.15.0/paddle_billing/Entities/Shared/ActorType.py

@@ -0,0 +1,10 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class ActorType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    Customer: "ActorType" = "customer"
+    User: "ActorType" = "user"
+    ApiKey: "ActorType" = "api_key"
+    PaddleStaff: "ActorType" = "paddle_staff"
+    Publisher: "ActorType" = "publisher"
+    System: "ActorType" = "system"

{paddle_python_sdk-1.14.1/paddle_billing/Notifications → paddle_python_sdk-1.15.0/paddle_billing}/Entities/Shared/CurrencyCode.py

@@ -14,6 +14,7 @@ class CurrencyCode(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     SEK: "CurrencyCode" = "SEK"
     ARS: "CurrencyCode" = "ARS"
     BRL: "CurrencyCode" = "BRL"
+    CLP: "CurrencyCode" = "CLP"
     CNY: "CurrencyCode" = "CNY"
     COP: "CurrencyCode" = "COP"
     CZK: "CurrencyCode" = "CZK"
@@ -25,6 +26,7 @@ class CurrencyCode(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     MXN: "CurrencyCode" = "MXN"
     NOK: "CurrencyCode" = "NOK"
     NZD: "CurrencyCode" = "NZD"
+    PEN: "CurrencyCode" = "PEN"
     PLN: "CurrencyCode" = "PLN"
     RUB: "CurrencyCode" = "RUB"
     THB: "CurrencyCode" = "THB"

paddle_python_sdk-1.15.0/paddle_billing/Entities/Shared/PriceTrialPeriod.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import Any
+
+from paddle_billing.Entities.Shared.Duration import Duration
+from paddle_billing.Entities.Shared.Interval import Interval
+from paddle_billing.Entities.Shared.Money import Money
+from paddle_billing.Entities.Shared.UnitPriceOverride import UnitPriceOverride
+from paddle_billing.Undefined import Undefined
+
+
+@dataclass
+class PriceTrialPeriod(Duration):
+    requires_payment_method: bool | Undefined = Undefined()
+    unit_price: Money | None | Undefined = Undefined()
+    unit_price_overrides: list[UnitPriceOverride] | Undefined = Undefined()
+
+    @staticmethod
+    def from_dict(data: dict[str, Any]) -> PriceTrialPeriod:
+        return PriceTrialPeriod(
+            interval=Interval(data["interval"]),
+            frequency=data["frequency"],
+            requires_payment_method=data.get("requires_payment_method", True),
+            unit_price=Money.from_dict(data["unit_price"]) if data.get("unit_price") else None,
+            unit_price_overrides=[
+                UnitPriceOverride.from_dict(override) for override in data.get("unit_price_overrides", [])
+            ],
+        )

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Shared/__init__.py

@@ -1,4 +1,7 @@
 from paddle_billing.Entities.Shared.Action import Action
+from paddle_billing.Entities.Shared.ActionSource import ActionSource
+from paddle_billing.Entities.Shared.Actor import Actor
+from paddle_billing.Entities.Shared.ActorType import ActorType
 from paddle_billing.Entities.Shared.AddressPreview import AddressPreview
 from paddle_billing.Entities.Shared.AdjustmentActionType import AdjustmentActionType
 from paddle_billing.Entities.Shared.AdjustmentItemTotals import AdjustmentItemTotals
@@ -40,6 +43,7 @@ from paddle_billing.Entities.Shared.SouthKoreaLocalCardType import SouthKoreaLoc
 from paddle_billing.Entities.Shared.PayoutTotalsAdjustment import PayoutTotalsAdjustment
 from paddle_billing.Entities.Shared.Paypal import Paypal
 from paddle_billing.Entities.Shared.PriceQuantity import PriceQuantity
+from paddle_billing.Entities.Shared.PriceTrialPeriod import PriceTrialPeriod
 from paddle_billing.Entities.Shared.Proration import Proration
 from paddle_billing.Entities.Shared.SavedPaymentMethodOrigin import SavedPaymentMethodOrigin
 from paddle_billing.Entities.Shared.SavedPaymentMethodType import SavedPaymentMethodType

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/Subscription.py

@@ -17,6 +17,7 @@ from paddle_billing.Entities.Shared import (
 )
 
 from paddle_billing.Entities.Subscriptions import (
+    SubscriptionConsentRequirement,
     SubscriptionDiscount,
     SubscriptionItem,
     SubscriptionManagementUrls,
@@ -51,6 +52,7 @@ class Subscription(Entity):
     items: list[SubscriptionItem]
     next_transaction: SubscriptionNextTransaction | None
     recurring_transaction_details: TransactionDetailsPreview | None
+    consent_requirements: list[SubscriptionConsentRequirement]
     import_meta: ImportMeta | None = None
     custom_data: CustomData | None = None
 
@@ -98,4 +100,8 @@ class Subscription(Entity):
                 if data.get("recurring_transaction_details")
                 else None
             ),
+            consent_requirements=[
+                SubscriptionConsentRequirement.from_dict(consent_requirement)
+                for consent_requirement in data.get("consent_requirements", [])
+            ],
         )

{paddle_python_sdk-1.14.1 → paddle_python_sdk-1.15.0}/paddle_billing/Entities/SubscriptionPreview.py

@@ -17,6 +17,7 @@ from paddle_billing.Entities.Shared import (
 from paddle_billing.Entities.Shared.TransactionDetailsPreview import TransactionDetailsPreview
 
 from paddle_billing.Entities.Subscriptions import (
+    SubscriptionConsentRequirement,
     SubscriptionDiscount,
     SubscriptionItem,
     SubscriptionManagementUrls,
@@ -54,6 +55,7 @@ class SubscriptionPreview(Entity):
     next_transaction: SubscriptionNextTransaction | None
     recurring_transaction_details: TransactionDetailsPreview | None
     update_summary: SubscriptionPreviewSubscriptionUpdateSummary | None
+    consent_requirements: list[SubscriptionConsentRequirement]
     import_meta: ImportMeta | None
 
     @staticmethod
@@ -108,5 +110,9 @@ class SubscriptionPreview(Entity):
                 if data.get("update_summary")
                 else None
             ),
+            consent_requirements=[
+                SubscriptionConsentRequirement.from_dict(consent_requirement)
+                for consent_requirement in data.get("consent_requirements", [])
+            ],
             import_meta=ImportMeta.from_dict(data["import_meta"]) if data.get("import_meta") else None,
         )

paddle_python_sdk-1.15.0/paddle_billing/Entities/Subscriptions/History/SubscriptionHistory.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Any
+
+from paddle_billing.Entities.Entity import Entity
+from paddle_billing.Entities.Shared import ActionSource, Actor
+
+from paddle_billing.Entities.Subscriptions.History.SubscriptionHistoryDetail import (
+    SubscriptionHistoryDetail,
+    SubscriptionHistoryDetailUnion,
+)
+from paddle_billing.Entities.Subscriptions.History.SubscriptionHistoryReason import SubscriptionHistoryReason
+
+
+@dataclass
+class SubscriptionHistory(Entity):
+    id: str
+    group_id: str
+    subscription_id: str
+    occurred_at: datetime
+    source: ActionSource
+    actor: Actor
+    reason: SubscriptionHistoryReason | None
+    detail: SubscriptionHistoryDetailUnion
+
+    @staticmethod
+    def from_dict(data: dict[str, Any]) -> SubscriptionHistory:
+        return SubscriptionHistory(
+            id=data["id"],
+            group_id=data["group_id"],
+            subscription_id=data["subscription_id"],
+            occurred_at=datetime.fromisoformat(data["occurred_at"]),
+            source=ActionSource(data["source"]),
+            actor=Actor.from_dict(data["actor"]),
+            reason=SubscriptionHistoryReason(data["reason"]) if data.get("reason") else None,
+            detail=SubscriptionHistoryDetail.from_dict(data["detail"]),
+        )

paddle_python_sdk-1.15.0/paddle_billing/Entities/Subscriptions/History/SubscriptionHistoryAction.py

@@ -0,0 +1,37 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class SubscriptionHistoryAction(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    SubscriptionActivated: "SubscriptionHistoryAction" = "subscription_activated"
+    SubscriptionAddressUpdated: "SubscriptionHistoryAction" = "subscription_address_updated"
+    SubscriptionBillingCycleUpdated: "SubscriptionHistoryAction" = "subscription_billing_cycle_updated"
+    SubscriptionBillingDateUpdated: "SubscriptionHistoryAction" = "subscription_billing_date_updated"
+    SubscriptionBillingDetailsUpdated: "SubscriptionHistoryAction" = "subscription_billing_details_updated"
+    SubscriptionBusinessAdded: "SubscriptionHistoryAction" = "subscription_business_added"
+    SubscriptionBusinessRemoved: "SubscriptionHistoryAction" = "subscription_business_removed"
+    SubscriptionBusinessUpdated: "SubscriptionHistoryAction" = "subscription_business_updated"
+    SubscriptionCanceled: "SubscriptionHistoryAction" = "subscription_canceled"
+    SubscriptionCollectionModeUpdated: "SubscriptionHistoryAction" = "subscription_collection_mode_updated"
+    SubscriptionConsentRequirementGranted: "SubscriptionHistoryAction" = "subscription_consent_requirement_granted"
+    SubscriptionCreated: "SubscriptionHistoryAction" = "subscription_created"
+    SubscriptionCurrencyUpdated: "SubscriptionHistoryAction" = "subscription_currency_updated"
+    SubscriptionCustomDataUpdated: "SubscriptionHistoryAction" = "subscription_custom_data_updated"
+    SubscriptionCustomerUpdated: "SubscriptionHistoryAction" = "subscription_customer_updated"
+    SubscriptionDiscountAdded: "SubscriptionHistoryAction" = "subscription_discount_added"
+    SubscriptionDiscountExpired: "SubscriptionHistoryAction" = "subscription_discount_expired"
+    SubscriptionDiscountRemoved: "SubscriptionHistoryAction" = "subscription_discount_removed"
+    SubscriptionItemAdded: "SubscriptionHistoryAction" = "subscription_item_added"
+    SubscriptionItemQuantityUpdated: "SubscriptionHistoryAction" = "subscription_item_quantity_updated"
+    SubscriptionItemRemoved: "SubscriptionHistoryAction" = "subscription_item_removed"
+    SubscriptionOneOffChargeApplied: "SubscriptionHistoryAction" = "subscription_one_off_charge_applied"
+    SubscriptionPastDue: "SubscriptionHistoryAction" = "subscription_past_due"
+    SubscriptionPaused: "SubscriptionHistoryAction" = "subscription_paused"
+    SubscriptionPaymentAttempted: "SubscriptionHistoryAction" = "subscription_payment_attempted"
+    SubscriptionPaymentMethodAdded: "SubscriptionHistoryAction" = "subscription_payment_method_added"
+    SubscriptionPaymentMethodRemoved: "SubscriptionHistoryAction" = "subscription_payment_method_removed"
+    SubscriptionPaymentMethodUpdated: "SubscriptionHistoryAction" = "subscription_payment_method_updated"
+    SubscriptionRenewed: "SubscriptionHistoryAction" = "subscription_renewed"
+    SubscriptionResumed: "SubscriptionHistoryAction" = "subscription_resumed"
+    SubscriptionScheduledChangeAdded: "SubscriptionHistoryAction" = "subscription_scheduled_change_added"
+    SubscriptionScheduledChangeRemoved: "SubscriptionHistoryAction" = "subscription_scheduled_change_removed"
+    SubscriptionScheduledChangeUpdated: "SubscriptionHistoryAction" = "subscription_scheduled_change_updated"

paddle_python_sdk-1.15.0/paddle_billing/Entities/Subscriptions/History/SubscriptionHistoryCanceledEffectiveFrom.py

@@ -0,0 +1,6 @@
+from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
+
+
+class SubscriptionHistoryCanceledEffectiveFrom(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
+    Immediately: "SubscriptionHistoryCanceledEffectiveFrom" = "immediately"
+    NextBillingPeriod: "SubscriptionHistoryCanceledEffectiveFrom" = "next_billing_period"