paddle-python-sdk 1.9.0__tar.gz → 1.11.0__tar.gz

{paddle_python_sdk-1.9.0/paddle_python_sdk.egg-info → paddle_python_sdk-1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paddle-python-sdk
-Version: 1.9.0
+Version: 1.11.0
 Summary: Paddle's Python SDK for Paddle Billing
 Home-page: https://developer.paddle.com/api-reference/overview
 Author: Paddle and contributors
@@ -20,7 +20,7 @@ Requires-Dist: requests>=2.31
 Requires-Dist: urllib3>=1.26.18
 Provides-Extra: dev
 Requires-Dist: pytest<8.5.0,>=7.4.4; extra == "dev"
-Requires-Dist: pytest-cov<6.3,>=4.1; extra == "dev"
+Requires-Dist: pytest-cov<7.1,>=4.1; extra == "dev"
 Requires-Dist: requests-mock~=1.11.0; extra == "dev"
 Requires-Dist: setuptools>=69.0.3; extra == "dev"
 Requires-Dist: pre-commit>=3.8.0; extra == "dev"
@@ -183,6 +183,22 @@ paddle = Client('PADDLE_API_SECRET_KEY')
 deleted_product = paddle.products.delete('PRODUCT_ID')
 ```
 
+### Error Handling
+
+If a request fails, Paddle raises an `ApiError` that contains the same information as [errors returned by the API](https://developer.paddle.com/api-reference/about/errors?utm_source=dx&utm_medium=paddle-python-sdk). You can use the `code` attribute to search an error in [the error reference](https://developer.paddle.com/errors/overview?utm_source=dx&utm_medium=paddle-python-sdk) and to handle the error in your app. Validation errors also return an array of `errors` that tell you which fields failed validation. The `retry_after` property will be set for `too_many_requests` errors.
+
+This example shows how to handle an error with the code `conflict`:
+
+```python
+from paddle_billing.Exceptions.ApiError import ApiError
+
+try:
+    # Call functions from the SDK
+except ApiError as error:
+    # error.error_code will always follow the error code defined in our documentation
+    if error.error_code == 'conflict':
+        # Handle Conflict error
+```
 
 ## Resources
 

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/README.md

@@ -141,6 +141,22 @@ paddle = Client('PADDLE_API_SECRET_KEY')
 deleted_product = paddle.products.delete('PRODUCT_ID')
 ```
 
+### Error Handling
+
+If a request fails, Paddle raises an `ApiError` that contains the same information as [errors returned by the API](https://developer.paddle.com/api-reference/about/errors?utm_source=dx&utm_medium=paddle-python-sdk). You can use the `code` attribute to search an error in [the error reference](https://developer.paddle.com/errors/overview?utm_source=dx&utm_medium=paddle-python-sdk) and to handle the error in your app. Validation errors also return an array of `errors` that tell you which fields failed validation. The `retry_after` property will be set for `too_many_requests` errors.
+
+This example shows how to handle an error with the code `conflict`:
+
+```python
+from paddle_billing.Exceptions.ApiError import ApiError
+
+try:
+    # Call functions from the SDK
+except ApiError as error:
+    # error.error_code will always follow the error code defined in our documentation
+    if error.error_code == 'conflict':
+        # Handle Conflict error
+```
 
 ## Resources
 

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/examples/get_products.py

@@ -32,6 +32,7 @@ except ApiError as error:
     print(f"detail: {error.detail}")
     print(f"field_errors: {error.field_errors}")
     print(f"response.status_code: {error.response.status_code}")
+    print(f"retry_after: {error.retry_after}")
 except Exception as error:
     log.error(f"We received an error listing products: {error}")
 

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Client.py

@@ -200,7 +200,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.9.0",
+                "User-Agent": "PaddleSDK/python 1.11.0",
             }
         )
 

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Entities/Shared/AdjustmentTotals.py

@@ -13,6 +13,7 @@ class AdjustmentTotals:
     fee: str
     earnings: str
     currency_code: CurrencyCode
+    retained_fee: str
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> AdjustmentTotals:
@@ -23,4 +24,5 @@ class AdjustmentTotals:
             fee=data["fee"],
             earnings=data["earnings"],
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data["retained_fee"],
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Entities/Shared/PaymentMethodType.py

@@ -5,11 +5,15 @@ class PaymentMethodType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     Alipay: "PaymentMethodType" = "alipay"
     ApplePay: "PaymentMethodType" = "apple_pay"
     Bancontact: "PaymentMethodType" = "bancontact"
+    Blik: "PaymentMethodType" = "blik"
     Card: "PaymentMethodType" = "card"
     GooglePay: "PaymentMethodType" = "google_pay"
     Ideal: "PaymentMethodType" = "ideal"
     KoreaLocal: "PaymentMethodType" = "korea_local"
+    MbWay: "PaymentMethodType" = "mb_way"
     Offline: "PaymentMethodType" = "offline"
     Paypal: "PaymentMethodType" = "paypal"
+    Pix: "PaymentMethodType" = "pix"
     Unknown: "PaymentMethodType" = "unknown"
+    Upi: "PaymentMethodType" = "upi"
     WireTransfer: "PaymentMethodType" = "wire_transfer"

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Entities/Shared/PayoutTotalsAdjustment.py

@@ -15,6 +15,7 @@ class PayoutTotalsAdjustment:
     chargeback_fee: ChargebackFee | None
     earnings: str
     currency_code: CurrencyCodePayouts
+    retained_fee: str
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> PayoutTotalsAdjustment:
@@ -26,4 +27,5 @@ class PayoutTotalsAdjustment:
             chargeback_fee=ChargebackFee.from_dict(data["chargeback_fee"]) if data.get("chargeback_fee") else None,
             earnings=data["earnings"],
             currency_code=CurrencyCodePayouts(data["currency_code"]),
+            retained_fee=data["retained_fee"],
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Entities/Shared/SavedPaymentMethodType.py

@@ -4,7 +4,11 @@ from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
 class SavedPaymentMethodType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     Alipay: "SavedPaymentMethodType" = "alipay"
     ApplePay: "SavedPaymentMethodType" = "apple_pay"
+    Blik: "SavedPaymentMethodType" = "blik"
     Card: "SavedPaymentMethodType" = "card"
     GooglePay: "SavedPaymentMethodType" = "google_pay"
     KoreaLocal: "SavedPaymentMethodType" = "korea_local"
+    MbWay: "SavedPaymentMethodType" = "mb_way"
     Paypal: "SavedPaymentMethodType" = "paypal"
+    Pix: "SavedPaymentMethodType" = "pix"
+    Upi: "SavedPaymentMethodType" = "upi"

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Entities/Shared/TransactionPayoutTotalsAdjusted.py

@@ -16,6 +16,7 @@ class TransactionPayoutTotalsAdjusted:
     earnings: str
     currency_code: CurrencyCodePayouts
     exchange_rate: str
+    retained_fee: str
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> TransactionPayoutTotalsAdjusted:
@@ -28,4 +29,5 @@ class TransactionPayoutTotalsAdjusted:
             earnings=data["earnings"],
             currency_code=CurrencyCodePayouts(data["currency_code"]),
             exchange_rate=data["exchange_rate"],
+            retained_fee=data["retained_fee"],
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Entities/Shared/TransactionTotalsAdjusted.py

@@ -14,6 +14,7 @@ class TransactionTotalsAdjusted:
     fee: str | None
     earnings: str | None
     currency_code: CurrencyCode
+    retained_fee: str
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> TransactionTotalsAdjusted:
@@ -25,4 +26,5 @@ class TransactionTotalsAdjusted:
             fee=data.get("fee"),
             earnings=data.get("earnings"),
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data["retained_fee"],
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Exceptions/ApiError.py

@@ -1,16 +1,18 @@
 from paddle_billing.Exceptions.FieldError import FieldError
 
-from requests import HTTPError
+from requests import HTTPError, Response
 
 
 class ApiError(HTTPError):
-    def __init__(self, response, error_type, error_code, detail, docs_url, *field_errors):
+    def __init__(self, response: Response, error_type: str, error_code: str, detail: str, docs_url: str, *field_errors):
         super().__init__(detail, response=response)
         self.error_type = error_type
         self.error_code = error_code
         self.detail = detail
         self.docs_url = docs_url
         self.field_errors = field_errors
+        retry_after = response.headers.get("Retry-After")
+        self.retry_after = int(retry_after) if retry_after else None
 
     def __repr__(self):
         return (
@@ -19,6 +21,6 @@ class ApiError(HTTPError):
         )
 
     @classmethod
-    def from_error_data(cls, response, error):
+    def from_error_data(cls, response: Response, error):
         field_errors = [FieldError(fe["field"], fe["message"]) for fe in error.get("errors", [])]
         return cls(response, error["type"], error["code"], error["detail"], error["documentation_url"], *field_errors)

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Notifications/Entities/Shared/AdjustmentTotals.py

@@ -13,6 +13,7 @@ class AdjustmentTotals:
     fee: str
     earnings: str
     currency_code: CurrencyCode
+    retained_fee: str | None
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> AdjustmentTotals:
@@ -23,4 +24,5 @@ class AdjustmentTotals:
             fee=data["fee"],
             earnings=data["earnings"],
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data.get("retained_fee"),
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Notifications/Entities/Shared/PaymentMethodType.py

@@ -5,11 +5,15 @@ class PaymentMethodType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     Alipay: "PaymentMethodType" = "alipay"
     ApplePay: "PaymentMethodType" = "apple_pay"
     Bancontact: "PaymentMethodType" = "bancontact"
+    Blik: "PaymentMethodType" = "blik"
     Card: "PaymentMethodType" = "card"
     GooglePay: "PaymentMethodType" = "google_pay"
     Ideal: "PaymentMethodType" = "ideal"
     KoreaLocal: "PaymentMethodType" = "korea_local"
+    MbWay: "PaymentMethodType" = "mb_way"
     Offline: "PaymentMethodType" = "offline"
     Paypal: "PaymentMethodType" = "paypal"
+    Pix: "PaymentMethodType" = "pix"
     Unknown: "PaymentMethodType" = "unknown"
+    Upi: "PaymentMethodType" = "upi"
     WireTransfer: "PaymentMethodType" = "wire_transfer"

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Notifications/Entities/Shared/PayoutTotalsAdjustment.py

@@ -15,6 +15,7 @@ class PayoutTotalsAdjustment:
     chargeback_fee: ChargebackFee | None
     earnings: str
     currency_code: CurrencyCodePayouts
+    retained_fee: str | None
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> PayoutTotalsAdjustment:
@@ -26,4 +27,5 @@ class PayoutTotalsAdjustment:
             chargeback_fee=ChargebackFee.from_dict(data["chargeback_fee"]) if data.get("chargeback_fee") else None,
             earnings=data["earnings"],
             currency_code=CurrencyCodePayouts(data["currency_code"]),
+            retained_fee=data.get("retained_fee"),
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Notifications/Entities/Shared/SavedPaymentMethodType.py

@@ -4,7 +4,11 @@ from paddle_billing.PaddleStrEnum import PaddleStrEnum, PaddleStrEnumMeta
 class SavedPaymentMethodType(PaddleStrEnum, metaclass=PaddleStrEnumMeta):
     Alipay: "SavedPaymentMethodType" = "alipay"
     ApplePay: "SavedPaymentMethodType" = "apple_pay"
+    Blik: "SavedPaymentMethodType" = "blik"
     Card: "SavedPaymentMethodType" = "card"
     GooglePay: "SavedPaymentMethodType" = "google_pay"
     KoreaLocal: "SavedPaymentMethodType" = "korea_local"
+    MbWay: "SavedPaymentMethodType" = "mb_way"
     Paypal: "SavedPaymentMethodType" = "paypal"
+    Pix: "SavedPaymentMethodType" = "pix"
+    Upi: "SavedPaymentMethodType" = "upi"

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Notifications/Entities/Shared/TransactionPayoutTotalsAdjusted.py

@@ -16,6 +16,7 @@ class TransactionPayoutTotalsAdjusted:
     earnings: str
     currency_code: CurrencyCodePayouts
     exchange_rate: str | None
+    retained_fee: str | None
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> TransactionPayoutTotalsAdjusted:
@@ -28,4 +29,5 @@ class TransactionPayoutTotalsAdjusted:
             earnings=data["earnings"],
             currency_code=CurrencyCodePayouts(data["currency_code"]),
             exchange_rate=data.get("exchange_rate"),
+            retained_fee=data.get("retained_fee"),
         )

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Notifications/Entities/Shared/TransactionTotalsAdjusted.py

@@ -14,6 +14,7 @@ class TransactionTotalsAdjusted:
     fee: str | None
     earnings: str | None
     currency_code: CurrencyCode
+    retained_fee: str | None
 
     @staticmethod
     def from_dict(data: dict[str, Any]) -> TransactionTotalsAdjusted:
@@ -25,4 +26,5 @@ class TransactionTotalsAdjusted:
             fee=data.get("fee"),
             earnings=data.get("earnings"),
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data.get("retained_fee"),
         )

paddle_python_sdk-1.11.0/paddle_billing/Resources/Events/Operations/ListEvents.py

@@ -0,0 +1,29 @@
+from paddle_billing.Entities.Events.EventTypeName import EventTypeName
+from paddle_billing.EnumStringify import enum_stringify
+from paddle_billing.Exceptions.SdkExceptions.InvalidArgumentException import InvalidArgumentException
+from paddle_billing.HasParameters import HasParameters
+from paddle_billing.Resources.Shared.Operations import Pager
+
+
+class ListEvents(HasParameters):
+    def __init__(self, pager: Pager | None = None, event_types: list[EventTypeName] | None = None):
+        self.pager = pager
+        self.event_types = event_types if event_types is not None else []
+
+        for field_name, field_value, field_type in [
+            ("event_types", self.event_types, EventTypeName),
+        ]:
+            invalid_items = [item for item in field_value if not isinstance(item, field_type)]
+            if invalid_items:
+                raise InvalidArgumentException.array_contains_invalid_types(
+                    field_name, field_type.__name__, invalid_items
+                )
+
+    def get_parameters(self) -> dict[str, str]:
+        parameters = {}
+        if self.pager:
+            parameters.update(self.pager.get_parameters())
+        if self.event_types:
+            parameters["event_type"] = ",".join(map(enum_stringify, self.event_types))
+
+        return parameters

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Resources/Transactions/Operations/CreateTransaction.py

@@ -15,6 +15,9 @@ from paddle_billing.Resources.Transactions.Operations.Create import (
     TransactionCreateItemWithPrice,
     CreateBillingDetails,
 )
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)
 
 
 @dataclass
@@ -31,3 +34,4 @@ class CreateTransaction(Operation):
     billing_details: CreateBillingDetails | None | Undefined = Undefined()
     billing_period: TimePeriod | None | Undefined = Undefined()
     checkout: Checkout | None | Undefined = Undefined()
+    discount: TransactionNonCatalogDiscount | None | Undefined = Undefined()

paddle_python_sdk-1.11.0/paddle_billing/Resources/Transactions/Operations/Discount/TransactionNonCatalogDiscount.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+from dataclasses import dataclass
+
+from paddle_billing.Undefined import Undefined
+from paddle_billing.Entities.Shared.CustomData import CustomData
+from paddle_billing.Entities.Discounts.DiscountType import DiscountType
+
+
+@dataclass
+class TransactionNonCatalogDiscount:
+    amount: str
+    description: str
+    type: DiscountType
+    recur: bool | Undefined = Undefined()
+    maximum_recurring_intervals: int | None | Undefined = Undefined()
+    custom_data: CustomData | None | Undefined = Undefined()
+    restrict_to: list[str] | None | Undefined = Undefined()

paddle_python_sdk-1.11.0/paddle_billing/Resources/Transactions/Operations/Discount/__init__.py

@@ -0,0 +1,3 @@
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Resources/Transactions/Operations/PreviewTransaction.py

@@ -7,6 +7,9 @@ from paddle_billing.Resources.Transactions.Operations.Preview import (
     TransactionItemPreviewWithPriceId,
     TransactionItemPreviewWithNonCatalogPrice,
 )
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)
 
 
 @dataclass
@@ -16,3 +19,4 @@ class PreviewTransaction(Operation):
     currency_code: CurrencyCode | None | Undefined = Undefined()
     discount_id: str | None | Undefined = Undefined()
     ignore_trials: bool | Undefined = Undefined()
+    discount: TransactionNonCatalogDiscount | None | Undefined = Undefined()

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Resources/Transactions/Operations/PreviewTransactionByAddress.py

@@ -7,6 +7,9 @@ from paddle_billing.Resources.Transactions.Operations.Preview import (
     TransactionItemPreviewWithPriceId,
     TransactionItemPreviewWithNonCatalogPrice,
 )
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)
 
 
 @dataclass
@@ -17,3 +20,4 @@ class PreviewTransactionByAddress(Operation):
     currency_code: CurrencyCode | None | Undefined = Undefined()
     discount_id: str | None | Undefined = Undefined()
     ignore_trials: bool | Undefined = Undefined()
+    discount: TransactionNonCatalogDiscount | None | Undefined = Undefined()

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Resources/Transactions/Operations/PreviewTransactionByCustomer.py

@@ -7,6 +7,9 @@ from paddle_billing.Resources.Transactions.Operations.Preview import (
     TransactionItemPreviewWithPriceId,
     TransactionItemPreviewWithNonCatalogPrice,
 )
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)
 
 
 @dataclass
@@ -18,3 +21,4 @@ class PreviewTransactionByCustomer(Operation):
     currency_code: CurrencyCode | None | Undefined = Undefined()
     discount_id: str | None | Undefined = Undefined()
     ignore_trials: bool | Undefined = Undefined()
+    discount: TransactionNonCatalogDiscount | None | Undefined = Undefined()

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Resources/Transactions/Operations/PreviewTransactionByIP.py

@@ -7,6 +7,9 @@ from paddle_billing.Resources.Transactions.Operations.Preview import (
     TransactionItemPreviewWithPriceId,
     TransactionItemPreviewWithNonCatalogPrice,
 )
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)
 
 
 @dataclass
@@ -17,3 +20,4 @@ class PreviewTransactionByIP(Operation):
     currency_code: CurrencyCode | None | Undefined = Undefined()
     discount_id: str | None | Undefined = Undefined()
     ignore_trials: bool | Undefined = Undefined()
+    discount: TransactionNonCatalogDiscount | None | Undefined = Undefined()

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_billing/Resources/Transactions/Operations/UpdateTransaction.py

@@ -15,6 +15,9 @@ from paddle_billing.Resources.Transactions.Operations.Update import (
     TransactionUpdateItemWithPrice,
     UpdateBillingDetails,
 )
+from paddle_billing.Resources.Transactions.Operations.Discount.TransactionNonCatalogDiscount import (
+    TransactionNonCatalogDiscount,
+)
 
 
 @dataclass
@@ -31,3 +34,4 @@ class UpdateTransaction(Operation):
     billing_details: UpdateBillingDetails | None | Undefined = Undefined()
     billing_period: TimePeriod | None | Undefined = Undefined()
     checkout: Checkout | None | Undefined = Undefined()
+    discount: TransactionNonCatalogDiscount | None | Undefined = Undefined()

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0/paddle_python_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paddle-python-sdk
-Version: 1.9.0
+Version: 1.11.0
 Summary: Paddle's Python SDK for Paddle Billing
 Home-page: https://developer.paddle.com/api-reference/overview
 Author: Paddle and contributors
@@ -20,7 +20,7 @@ Requires-Dist: requests>=2.31
 Requires-Dist: urllib3>=1.26.18
 Provides-Extra: dev
 Requires-Dist: pytest<8.5.0,>=7.4.4; extra == "dev"
-Requires-Dist: pytest-cov<6.3,>=4.1; extra == "dev"
+Requires-Dist: pytest-cov<7.1,>=4.1; extra == "dev"
 Requires-Dist: requests-mock~=1.11.0; extra == "dev"
 Requires-Dist: setuptools>=69.0.3; extra == "dev"
 Requires-Dist: pre-commit>=3.8.0; extra == "dev"
@@ -183,6 +183,22 @@ paddle = Client('PADDLE_API_SECRET_KEY')
 deleted_product = paddle.products.delete('PRODUCT_ID')
 ```
 
+### Error Handling
+
+If a request fails, Paddle raises an `ApiError` that contains the same information as [errors returned by the API](https://developer.paddle.com/api-reference/about/errors?utm_source=dx&utm_medium=paddle-python-sdk). You can use the `code` attribute to search an error in [the error reference](https://developer.paddle.com/errors/overview?utm_source=dx&utm_medium=paddle-python-sdk) and to handle the error in your app. Validation errors also return an array of `errors` that tell you which fields failed validation. The `retry_after` property will be set for `too_many_requests` errors.
+
+This example shows how to handle an error with the code `conflict`:
+
+```python
+from paddle_billing.Exceptions.ApiError import ApiError
+
+try:
+    # Call functions from the SDK
+except ApiError as error:
+    # error.error_code will always follow the error code defined in our documentation
+    if error.error_code == 'conflict':
+        # Handle Conflict error
+```
 
 ## Resources
 

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_python_sdk.egg-info/SOURCES.txt

@@ -702,6 +702,8 @@ paddle_billing/Resources/Transactions/Operations/Create/CreateBillingDetails.py
 paddle_billing/Resources/Transactions/Operations/Create/TransactionCreateItem.py
 paddle_billing/Resources/Transactions/Operations/Create/TransactionCreateItemWithPrice.py
 paddle_billing/Resources/Transactions/Operations/Create/__init__.py
+paddle_billing/Resources/Transactions/Operations/Discount/TransactionNonCatalogDiscount.py
+paddle_billing/Resources/Transactions/Operations/Discount/__init__.py
 paddle_billing/Resources/Transactions/Operations/List/Includes.py
 paddle_billing/Resources/Transactions/Operations/List/Origin.py
 paddle_billing/Resources/Transactions/Operations/List/__init__.py

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/paddle_python_sdk.egg-info/requires.txt

@@ -3,7 +3,7 @@ urllib3>=1.26.18
 
 [dev]
 pytest<8.5.0,>=7.4.4
-pytest-cov<6.3,>=4.1
+pytest-cov<7.1,>=4.1
 requests-mock~=1.11.0
 setuptools>=69.0.3
 pre-commit>=3.8.0

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 
 setup(
-    version="1.9.0",
+    version="1.11.0",
     author="Paddle and contributors",
     author_email="team-dx@paddle.com",
     description="Paddle's Python SDK for Paddle Billing",
@@ -26,7 +26,7 @@ setup(
     extras_require={
         "dev": [
             "pytest>=7.4.4,<8.5.0",
-            "pytest-cov>=4.1,<6.3",
+            "pytest-cov>=4.1,<7.1",
             "requests-mock~=1.11.0",
             "setuptools>=69.0.3",
             "pre-commit>=3.8.0",

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/tests/Functional/Client/test_Client.py

@@ -19,6 +19,8 @@ class TestClient:
             "expected_reason",
             "expected_response_body",
             "expected_exception",
+            "headers",
+            "expected_retry_after",
         ],
         [
             (
@@ -35,6 +37,8 @@ class TestClient:
                     "meta": {"request_id": "f00bb3ca-399d-4686-889c-50b028f4c912"},
                 },
                 ApiError,
+                {},
+                None,
             ),
             (
                 404,
@@ -49,6 +53,8 @@ class TestClient:
                     "meta": {"request_id": "f00bb3ca-399d-4686-889c-50b028f4c912"},
                 },
                 ApiError,
+                {},
+                None,
             ),
             (
                 400,
@@ -63,12 +69,31 @@ class TestClient:
                     "meta": {"request_id": "f00bb3ca-399d-4686-889c-50b028f4c912"},
                 },
                 AddressApiError,
+                {},
+                None,
+            ),
+            (
+                429,
+                "Too Many Requests",
+                {
+                    "error": {
+                        "type": "request_error",
+                        "code": "too_many_requests",
+                        "detail": "IP address exceeded the allowed rate limit. Retry after the number of seconds in the Retry-After header.",
+                        "documentation_url": "https://developer.paddle.com/errors/shared/too_many_requests",
+                    },
+                    "meta": {"request_id": "f00bb3ca-399d-4686-889c-50b028f4c912"},
+                },
+                ApiError,
+                {"Retry-After": "42"},
+                42,
             ),
         ],
         ids=[
             "Returns bad_request response",
             "Returns not_found response",
             "Returns address_location_not_allowed response",
+            "Returns too_many_requests response",
         ],
     )
     def test_post_raw_returns_error_response(
@@ -80,6 +105,8 @@ class TestClient:
         expected_reason,
         expected_response_body,
         expected_exception,
+        headers,
+        expected_retry_after,
     ):
         expected_request_url = f"{test_client.base_url}/some/url"
         expected_request_body = {"some_property": "some value"}
@@ -88,6 +115,7 @@ class TestClient:
             status_code=expected_response_status,
             text=dumps(expected_response_body),
             reason=expected_reason,
+            headers=headers,
         )
 
         with raises(expected_exception) as exception_info:
@@ -111,6 +139,7 @@ class TestClient:
         assert api_error.error_code == expected_response_body["error"]["code"]
         assert api_error.detail == expected_response_body["error"]["detail"]
         assert api_error.docs_url == expected_response_body["error"]["documentation_url"]
+        assert api_error.retry_after == expected_retry_after
 
         if "errors" in expected_response_body["error"]:
             assert len(api_error.field_errors) == len(expected_response_body["error"]["errors"])

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/tests/Functional/Resources/ClientToken/test_ClientTokensClient.py

@@ -2,7 +2,7 @@ from json import loads
 from pytest import mark
 from urllib.parse import unquote
 
-from build.lib.paddle_billing.Json import PayloadEncoder
+from paddle_billing.Json import PayloadEncoder
 from paddle_billing.Entities.Collections import ClientTokenCollection
 from paddle_billing.Entities.ClientToken import ClientToken
 from paddle_billing.Entities.ClientTokens import ClientTokenStatus

{paddle_python_sdk-1.9.0 → paddle_python_sdk-1.11.0}/tests/Functional/Resources/Discounts/test_DiscountsClient.py

@@ -2,7 +2,7 @@ from json import loads
 from pytest import mark
 from urllib.parse import unquote
 
-from build.lib.paddle_billing.Json import PayloadEncoder
+from paddle_billing.Json import PayloadEncoder
 from paddle_billing.Entities.Collections import DiscountCollection
 from paddle_billing.Entities.DateTime import DateTime
 from paddle_billing.Entities.Discount import Discount, DiscountMode