feat: add customers resource, deprecate receivers (v2.3.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "blindpay"
-version = "2.2.0"
+version = "2.3.0"
 description = "Official Python SDK for the Blindpay API — Global payments infrastructure"
 readme = "README.md"
 authors = [{ name = "Blindpay", email = "alves@blindpay.com" }]

src/blindpay/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.2.0"
+__version__ = "2.3.0"
 
 from ._internal.exceptions import BlindPayError
 from .client import BlindPay, BlindPaySync
@@ -27,6 +27,7 @@
     TrackingTransaction,
     TransactionDocumentType,
     TransactionStatus,
+    WebhookEvent,
 )
 
 __all__ = [
@@ -46,6 +47,7 @@
     "StablecoinToken",
     "TransactionDocumentType",
     "TransactionStatus",
+    "WebhookEvent",
     "BlindpayApiResponse",
     "BlindpayErrorResponse",
     "BlindpaySuccessResponse",

src/blindpay/client.py

@@ -1,6 +1,7 @@
 import base64
 import hashlib
 import hmac
+import warnings
 from functools import cached_property
 from typing import TYPE_CHECKING, Any, Dict, Literal, Mapping, Optional, TypeVar
 
@@ -24,6 +25,7 @@
     from blindpay.resources.payins.quotes import PayinQuotesResource, PayinQuotesResourceSync
     from blindpay.resources.payouts.payouts import PayoutsResource, PayoutsResourceSync
     from blindpay.resources.quotes.quotes import QuotesResource, QuotesResourceSync
+    from blindpay.resources.customers.customers import CustomersResource, CustomersResourceSync
     from blindpay.resources.receivers.receivers import ReceiversResource, ReceiversResourceSync
     from blindpay.resources.terms_of_service.terms_of_service import (
         TermsOfServiceResource,
@@ -39,7 +41,12 @@
     from blindpay.resources.wallets.offramp import OfframpWalletsResource, OfframpWalletsResourceSync
     from blindpay.resources.webhooks.webhooks import WebhookEndpointsResource, WebhookEndpointsResourceSync
 
-__version__ = "2.2.0"
+__version__ = "2.3.0"
+
+_RECEIVERS_DEPRECATION_MESSAGE = (
+    "Use 'customers' instead. 'receivers' is deprecated and will be removed in "
+    "v3.0.0. See https://www.blindpay.com/changelog/2026-06-04-customers-rename"
+)
 
 T = TypeVar("T")
 
@@ -203,6 +210,27 @@ def __getattr__(self, name: str) -> Any:
         return getattr(self._base, name)
 
 
+class _CustomersNamespace:
+    def __init__(self, instance_id: str, api_client: ApiClientImpl) -> None:
+        self._instance_id = instance_id
+        self._api = api_client
+
+    @cached_property
+    def _base(self) -> "CustomersResource":
+        from blindpay.resources.customers.customers import create_customers_resource
+
+        return create_customers_resource(self._instance_id, self._api)
+
+    @cached_property
+    def bank_accounts(self) -> "BankAccountsResource":
+        from blindpay.resources.bank_accounts.bank_accounts import create_bank_accounts_resource
+
+        return create_bank_accounts_resource(self._instance_id, self._api)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._base, name)
+
+
 class _ReceiversNamespace:
     def __init__(self, instance_id: str, api_client: ApiClientImpl) -> None:
         self._instance_id = instance_id
@@ -305,8 +333,13 @@ def payouts(self) -> "PayoutsResource":
 
         return create_payouts_resource(self._instance_id, self._api)
 
+    @cached_property
+    def customers(self) -> _CustomersNamespace:
+        return _CustomersNamespace(self._instance_id, self._api)
+
     @cached_property
     def receivers(self) -> _ReceiversNamespace:
+        warnings.warn(_RECEIVERS_DEPRECATION_MESSAGE, DeprecationWarning, stacklevel=2)
         return _ReceiversNamespace(self._instance_id, self._api)
 
     @cached_property
@@ -433,6 +466,27 @@ def __getattr__(self, name: str) -> Any:
         return getattr(self._base, name)
 
 
+class _CustomersNamespaceSync:
+    def __init__(self, instance_id: str, api_client: ApiClientImplSync) -> None:
+        self._instance_id = instance_id
+        self._api = api_client
+
+    @cached_property
+    def _base(self) -> "CustomersResourceSync":
+        from blindpay.resources.customers.customers import create_customers_resource_sync
+
+        return create_customers_resource_sync(self._instance_id, self._api)
+
+    @cached_property
+    def bank_accounts(self) -> "BankAccountsResourceSync":
+        from blindpay.resources.bank_accounts.bank_accounts import create_bank_accounts_resource_sync
+
+        return create_bank_accounts_resource_sync(self._instance_id, self._api)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._base, name)
+
+
 class _ReceiversNamespaceSync:
     def __init__(self, instance_id: str, api_client: ApiClientImplSync) -> None:
         self._instance_id = instance_id
@@ -535,8 +589,13 @@ def payouts(self) -> "PayoutsResourceSync":
 
         return create_payouts_resource_sync(self._instance_id, self._api)
 
+    @cached_property
+    def customers(self) -> _CustomersNamespaceSync:
+        return _CustomersNamespaceSync(self._instance_id, self._api)
+
     @cached_property
     def receivers(self) -> _ReceiversNamespaceSync:
+        warnings.warn(_RECEIVERS_DEPRECATION_MESSAGE, DeprecationWarning, stacklevel=2)
         return _ReceiversNamespaceSync(self._instance_id, self._api)
 
     @cached_property

src/blindpay/resources/bank_accounts/__init__.py

@@ -19,6 +19,8 @@
     CreatePixSafeResponse,
     CreateRtpInput,
     CreateRtpResponse,
+    CreateSepaInput,
+    CreateSepaResponse,
     CreateSpeiInput,
     CreateSpeiResponse,
     CreateTedInput,
@@ -27,7 +29,6 @@
     CreateWireResponse,
     GetBankAccountResponse,
     ListBankAccountsResponse,
-    OfframpNetwork,
     PixSafeType,
     PixType,
     RtpType,
@@ -53,12 +54,12 @@
     "CreateWireInput",
     "CreateInternationalSwiftInput",
     "CreateRtpInput",
+    "CreateSepaInput",
     "CreateTedInput",
     "AchCopBitsoType",
     "AchCopDocument",
     "AchType",
     "ArgentinaTransfers",
-    "OfframpNetwork",
     "PixType",
     "PixSafeType",
     "TransfersBitsoType",
@@ -75,6 +76,7 @@
     "CreatePixResponse",
     "CreatePixSafeResponse",
     "CreateRtpResponse",
+    "CreateSepaResponse",
     "CreateSpeiResponse",
     "CreateTedResponse",
     "CreateWireResponse",