Merge branch 'main' into feat/too-many-requests-error

Author: davidgrayston-paddle

CHANGELOG.md

@@ -11,6 +11,8 @@ Check our main [developer changelog](https://developer.paddle.com/?utm_source=dx
 ### Added
 
 - `ApiError` will now have `retry_after` property set for [too_many_requests](https://developer.paddle.com/errors/shared/too_many_requests?utm_source=dx&utm_medium=paddle-python-sdk) errors
+- Support `retained_fee` field on totals objects to show the fees retained by Paddle for the adjustment.
+- Added support for new payment methods `blik`, `mb_way`, `pix` and `upi`. See [related changelog](https://developer.paddle.com/changelog/2025/blik-mbway-payment-methods?utm_source=dx&utm_medium=paddle-python-sdk).
 
 ## 1.10.0 - 2025-08-15
 

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 @@ def from_dict(data: dict[str, Any]) -> AdjustmentTotals:
             fee=data["fee"],
             earnings=data["earnings"],
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data["retained_fee"],
         )

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_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 @@ def from_dict(data: dict[str, Any]) -> 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_billing/Entities/Shared/SavedPaymentMethodType.py

@@ -4,7 +4,11 @@
 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_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 @@ def from_dict(data: dict[str, Any]) -> TransactionPayoutTotalsAdjusted:
             earnings=data["earnings"],
             currency_code=CurrencyCodePayouts(data["currency_code"]),
             exchange_rate=data["exchange_rate"],
+            retained_fee=data["retained_fee"],
         )

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 @@ def from_dict(data: dict[str, Any]) -> TransactionTotalsAdjusted:
             fee=data.get("fee"),
             earnings=data.get("earnings"),
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data["retained_fee"],
         )

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 @@ def from_dict(data: dict[str, Any]) -> AdjustmentTotals:
             fee=data["fee"],
             earnings=data["earnings"],
             currency_code=CurrencyCode(data["currency_code"]),
+            retained_fee=data.get("retained_fee"),
         )

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_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 @@ def from_dict(data: dict[str, Any]) -> 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"),
         )