diff --git a/CHANGELOG.md b/CHANGELOG.md
index cca7677..442cbd2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,9 @@ Check our main [developer changelog](https://developer.paddle.com/?utm_source=dx
 - Added support for `wechat_pay` payment method type. See [related changelog](https://developer.paddle.com/changelog/2025/wechat-pay-payment-method?utm_source=dx&utm_medium=paddle-python-sdk)
 - Added `grand_total_tax` to transaction totals and adjusted totals. See [related changelog](https://developer.paddle.com/changelog/2026/grand-total-tax-field?utm_source=dx&utm_medium=paddle-python-sdk)
 
+### Deprecated
+- `CreateBalanceReport` is deprecated, use `CreatePayoutReconciliationReport` instead, see [changelog](https://developer.paddle.com/changelog/2025/payout-reconciliation-report?utm_source=dx&utm_medium=paddle-python-sdk)
+
 ## 1.12.0 - 2025-11-12
 
 ### Added
diff --git a/paddle_billing/Resources/Reports/Operations/CreateBalanceReport.py b/paddle_billing/Resources/Reports/Operations/CreateBalanceReport.py
index 849fbb8..a07b9fa 100644
--- a/paddle_billing/Resources/Reports/Operations/CreateBalanceReport.py
+++ b/paddle_billing/Resources/Reports/Operations/CreateBalanceReport.py
@@ -14,6 +14,10 @@
 
 @dataclass
 class CreateBalanceReport(CreateReport):
+    """
+    Deprecated: Use CreatePayoutReconciliationReport instead.
+    """
+
     type: BalanceReportType
     filters: list[UpdatedAtFilter] = field(default_factory=list)