adila-pay 0.3.0__tar.gz

adila_pay-0.3.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: adila-pay
+Version: 0.3.0
+Summary: SDK Adila Pay para Python, com clientes síncrono e assíncrono
+Project-URL: Documentation, https://docs.adila.co/sdk
+Project-URL: Repository, https://github.com/adila-sh/payment-sdks
+Project-URL: Issues, https://github.com/adila-sh/payment-sdks/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1,>=0.28.1
+Requires-Dist: pydantic<3,>=2.11
+Requires-Dist: typing_extensions<5,>=4.12
+
+# Adila Pay para Python
+
+SDK Python 3.10+ com clientes síncrono e assíncrono, gerado a partir do mesmo
+contrato financeiro dos SDKs Node.js/Bun. O módulo se chama `adila_pay`.
+
+## Instalação
+
+```bash
+python -m pip install adila-pay
+# ou
+uv add adila-pay
+```
+
+## Uso no servidor
+
+```python
+import os
+import httpx
+from adila_pay import AdilaPayClient
+
+with httpx.Client(follow_redirects=False) as transport:
+    client = AdilaPayClient(
+        base_url=os.environ["ADILA_PAY_BASE_URL"],
+        api_key=os.environ["ADILA_PAY_API_KEY"],
+        timeout=30,
+        max_retries=2,
+        httpx_client=transport,
+    )
+    customers = client.customers.list(
+        organization_id=os.environ["ADILA_PAY_ORGANIZATION_ID"],
+        limit=10,
+    )
+    customer = client.customers.create(
+        organization_id=os.environ["ADILA_PAY_ORGANIZATION_ID"],
+        idempotency_key="cliente-integracao-001",
+        name="Cliente de exemplo",
+    )
+```
+
+Para async, importe `AsyncAdilaPayClient`, use `httpx.AsyncClient` com
+`async with` e aguarde os métodos com `await`. O contexto fecha o transporte.
+Erros HTTP derivam de `adila_pay.core.api_error.ApiError` e expõem `status_code`.
+Configure a URL da sua instalação; API keys pertencem somente ao servidor.
+
+São 43 operações financeiras, incluindo links de pagamento, códigos promocionais e configuração de repasses.
+Criação de conta, onboarding e cadastro humano
+ficam fora do cliente. Respostas Stripe continuam abertas, com modelos Pydantic
+para os envelopes de lista. A aplicação controla `starting_after` e `has_more`.
+Mutações exigem chave de idempotência de 8 a 255 caracteres. Reutilize a mesma
+chave e corpo somente para repetir a mesma operação lógica.
+
+Consulte [a documentação](https://docs.adila.co/sdk) para o exemplo assíncrono
+completo e os limites de ambiente. O módulo contém `openapi.json`,
+`provenance.json` e `py.typed`.

adila_pay-0.3.0/README.md

@@ -0,0 +1,54 @@
+# Adila Pay para Python
+
+SDK Python 3.10+ com clientes síncrono e assíncrono, gerado a partir do mesmo
+contrato financeiro dos SDKs Node.js/Bun. O módulo se chama `adila_pay`.
+
+## Instalação
+
+```bash
+python -m pip install adila-pay
+# ou
+uv add adila-pay
+```
+
+## Uso no servidor
+
+```python
+import os
+import httpx
+from adila_pay import AdilaPayClient
+
+with httpx.Client(follow_redirects=False) as transport:
+    client = AdilaPayClient(
+        base_url=os.environ["ADILA_PAY_BASE_URL"],
+        api_key=os.environ["ADILA_PAY_API_KEY"],
+        timeout=30,
+        max_retries=2,
+        httpx_client=transport,
+    )
+    customers = client.customers.list(
+        organization_id=os.environ["ADILA_PAY_ORGANIZATION_ID"],
+        limit=10,
+    )
+    customer = client.customers.create(
+        organization_id=os.environ["ADILA_PAY_ORGANIZATION_ID"],
+        idempotency_key="cliente-integracao-001",
+        name="Cliente de exemplo",
+    )
+```
+
+Para async, importe `AsyncAdilaPayClient`, use `httpx.AsyncClient` com
+`async with` e aguarde os métodos com `await`. O contexto fecha o transporte.
+Erros HTTP derivam de `adila_pay.core.api_error.ApiError` e expõem `status_code`.
+Configure a URL da sua instalação; API keys pertencem somente ao servidor.
+
+São 43 operações financeiras, incluindo links de pagamento, códigos promocionais e configuração de repasses.
+Criação de conta, onboarding e cadastro humano
+ficam fora do cliente. Respostas Stripe continuam abertas, com modelos Pydantic
+para os envelopes de lista. A aplicação controla `starting_after` e `has_more`.
+Mutações exigem chave de idempotência de 8 a 255 caracteres. Reutilize a mesma
+chave e corpo somente para repetir a mesma operação lógica.
+
+Consulte [a documentação](https://docs.adila.co/sdk) para o exemplo assíncrono
+completo e os limites de ambiente. O módulo contém `openapi.json`,
+`provenance.json` e `py.typed`.

adila_pay-0.3.0/adila_pay/__init__.py

@@ -0,0 +1,232 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import StripeList, StripeObject
+    from .errors import (
+        BadGatewayError,
+        BadRequestError,
+        ConflictError,
+        ForbiddenError,
+        InternalServerError,
+        NotFoundError,
+        PaymentRequiredError,
+        ServiceUnavailableError,
+        TooManyRequestsError,
+        UnauthorizedError,
+        UnprocessableEntityError,
+    )
+    from . import (
+        account,
+        balance,
+        balance_transactions,
+        billing_portal,
+        charges,
+        checkout,
+        customers,
+        disputes,
+        invoices,
+        payment_intents,
+        payment_links,
+        payout_settings,
+        payouts,
+        prices,
+        products,
+        promotion_codes,
+        refunds,
+        subscriptions,
+    )
+    from ._default_clients import DefaultAioHttpClient, DefaultAsyncHttpxClient
+    from .checkout import CreateCheckoutRequestLineItemsItem, CreateCheckoutRequestMode
+    from .client import AdilaPayClient, AsyncAdilaPayClient
+    from .environment import AdilaPayClientEnvironment
+    from .payment_links import (
+        CreatePaymentLinksRequestLineItemsItem,
+        CreatePaymentLinksRequestLineItemsItemAdjustableQuantity,
+    )
+    from .prices import (
+        CreatePricesRequestBillingScheme,
+        CreatePricesRequestCustomUnitAmount,
+        CreatePricesRequestProductData,
+        CreatePricesRequestRecurring,
+        CreatePricesRequestRecurringInterval,
+        CreatePricesRequestTaxBehavior,
+        CreatePricesRequestTiersItem,
+        CreatePricesRequestTiersItemUpTo,
+        CreatePricesRequestTiersItemUpToZero,
+        CreatePricesRequestTiersMode,
+        CreatePricesRequestTransformQuantity,
+        CreatePricesRequestTransformQuantityRound,
+    )
+    from .products import (
+        CreateProductsRequestDefaultPriceData,
+        CreateProductsRequestDefaultPriceDataRecurring,
+        CreateProductsRequestDefaultPriceDataRecurringInterval,
+        CreateProductsRequestMarketingFeaturesItem,
+        UpdateProductsRequestMarketingFeaturesItem,
+    )
+    from .promotion_codes import (
+        CreatePromotionCodesRequestDiscount,
+        CreatePromotionCodesRequestDiscountAmountOff,
+        CreatePromotionCodesRequestDiscountPercentOff,
+        CreatePromotionCodesRequestDuration,
+    )
+    from .refunds import CreateRefundsRequestReason
+    from .subscriptions import ListSubscriptionsRequestStatus
+_dynamic_imports: typing.Dict[str, str] = {
+    "AdilaPayClient": ".client",
+    "AdilaPayClientEnvironment": ".environment",
+    "AsyncAdilaPayClient": ".client",
+    "BadGatewayError": ".errors",
+    "BadRequestError": ".errors",
+    "ConflictError": ".errors",
+    "CreateCheckoutRequestLineItemsItem": ".checkout",
+    "CreateCheckoutRequestMode": ".checkout",
+    "CreatePaymentLinksRequestLineItemsItem": ".payment_links",
+    "CreatePaymentLinksRequestLineItemsItemAdjustableQuantity": ".payment_links",
+    "CreatePricesRequestBillingScheme": ".prices",
+    "CreatePricesRequestCustomUnitAmount": ".prices",
+    "CreatePricesRequestProductData": ".prices",
+    "CreatePricesRequestRecurring": ".prices",
+    "CreatePricesRequestRecurringInterval": ".prices",
+    "CreatePricesRequestTaxBehavior": ".prices",
+    "CreatePricesRequestTiersItem": ".prices",
+    "CreatePricesRequestTiersItemUpTo": ".prices",
+    "CreatePricesRequestTiersItemUpToZero": ".prices",
+    "CreatePricesRequestTiersMode": ".prices",
+    "CreatePricesRequestTransformQuantity": ".prices",
+    "CreatePricesRequestTransformQuantityRound": ".prices",
+    "CreateProductsRequestDefaultPriceData": ".products",
+    "CreateProductsRequestDefaultPriceDataRecurring": ".products",
+    "CreateProductsRequestDefaultPriceDataRecurringInterval": ".products",
+    "CreateProductsRequestMarketingFeaturesItem": ".products",
+    "CreatePromotionCodesRequestDiscount": ".promotion_codes",
+    "CreatePromotionCodesRequestDiscountAmountOff": ".promotion_codes",
+    "CreatePromotionCodesRequestDiscountPercentOff": ".promotion_codes",
+    "CreatePromotionCodesRequestDuration": ".promotion_codes",
+    "CreateRefundsRequestReason": ".refunds",
+    "DefaultAioHttpClient": "._default_clients",
+    "DefaultAsyncHttpxClient": "._default_clients",
+    "ForbiddenError": ".errors",
+    "InternalServerError": ".errors",
+    "ListSubscriptionsRequestStatus": ".subscriptions",
+    "NotFoundError": ".errors",
+    "PaymentRequiredError": ".errors",
+    "ServiceUnavailableError": ".errors",
+    "StripeList": ".types",
+    "StripeObject": ".types",
+    "TooManyRequestsError": ".errors",
+    "UnauthorizedError": ".errors",
+    "UnprocessableEntityError": ".errors",
+    "UpdateProductsRequestMarketingFeaturesItem": ".products",
+    "account": ".account",
+    "balance": ".balance",
+    "balance_transactions": ".balance_transactions",
+    "billing_portal": ".billing_portal",
+    "charges": ".charges",
+    "checkout": ".checkout",
+    "customers": ".customers",
+    "disputes": ".disputes",
+    "invoices": ".invoices",
+    "payment_intents": ".payment_intents",
+    "payment_links": ".payment_links",
+    "payout_settings": ".payout_settings",
+    "payouts": ".payouts",
+    "prices": ".prices",
+    "products": ".products",
+    "promotion_codes": ".promotion_codes",
+    "refunds": ".refunds",
+    "subscriptions": ".subscriptions",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = [
+    "AdilaPayClient",
+    "AdilaPayClientEnvironment",
+    "AsyncAdilaPayClient",
+    "BadGatewayError",
+    "BadRequestError",
+    "ConflictError",
+    "CreateCheckoutRequestLineItemsItem",
+    "CreateCheckoutRequestMode",
+    "CreatePaymentLinksRequestLineItemsItem",
+    "CreatePaymentLinksRequestLineItemsItemAdjustableQuantity",
+    "CreatePricesRequestBillingScheme",
+    "CreatePricesRequestCustomUnitAmount",
+    "CreatePricesRequestProductData",
+    "CreatePricesRequestRecurring",
+    "CreatePricesRequestRecurringInterval",
+    "CreatePricesRequestTaxBehavior",
+    "CreatePricesRequestTiersItem",
+    "CreatePricesRequestTiersItemUpTo",
+    "CreatePricesRequestTiersItemUpToZero",
+    "CreatePricesRequestTiersMode",
+    "CreatePricesRequestTransformQuantity",
+    "CreatePricesRequestTransformQuantityRound",
+    "CreateProductsRequestDefaultPriceData",
+    "CreateProductsRequestDefaultPriceDataRecurring",
+    "CreateProductsRequestDefaultPriceDataRecurringInterval",
+    "CreateProductsRequestMarketingFeaturesItem",
+    "CreatePromotionCodesRequestDiscount",
+    "CreatePromotionCodesRequestDiscountAmountOff",
+    "CreatePromotionCodesRequestDiscountPercentOff",
+    "CreatePromotionCodesRequestDuration",
+    "CreateRefundsRequestReason",
+    "DefaultAioHttpClient",
+    "DefaultAsyncHttpxClient",
+    "ForbiddenError",
+    "InternalServerError",
+    "ListSubscriptionsRequestStatus",
+    "NotFoundError",
+    "PaymentRequiredError",
+    "ServiceUnavailableError",
+    "StripeList",
+    "StripeObject",
+    "TooManyRequestsError",
+    "UnauthorizedError",
+    "UnprocessableEntityError",
+    "UpdateProductsRequestMarketingFeaturesItem",
+    "account",
+    "balance",
+    "balance_transactions",
+    "billing_portal",
+    "charges",
+    "checkout",
+    "customers",
+    "disputes",
+    "invoices",
+    "payment_intents",
+    "payment_links",
+    "payout_settings",
+    "payouts",
+    "prices",
+    "products",
+    "promotion_codes",
+    "refunds",
+    "subscriptions",
+]

adila_pay-0.3.0/adila_pay/_default_clients.py

@@ -0,0 +1,30 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import httpx
+
+SDK_DEFAULT_TIMEOUT = 60
+
+try:
+    import httpx_aiohttp  # type: ignore[import-not-found]
+except ImportError:
+
+    class DefaultAioHttpClient(httpx.AsyncClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            raise RuntimeError("To use the aiohttp client, install the aiohttp extra: pip install adila_pay[aiohttp]")
+
+else:
+
+    class DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+            kwargs.setdefault("follow_redirects", True)
+            super().__init__(**kwargs)
+
+
+class DefaultAsyncHttpxClient(httpx.AsyncClient):
+    def __init__(self, **kwargs: typing.Any) -> None:
+        kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+        kwargs.setdefault("follow_redirects", True)
+        super().__init__(**kwargs)

adila_pay-0.3.0/adila_pay/account/__init__.py

@@ -0,0 +1,4 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+

adila_pay-0.3.0/adila_pay/account/client.py

@@ -0,0 +1,114 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.stripe_object import StripeObject
+from .raw_client import AsyncRawAccountClient, RawAccountClient
+
+
+class AccountClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAccountClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAccountClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAccountClient
+        """
+        return self._raw_client
+
+    def retrieve(
+        self, *, organization_id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> StripeObject:
+        """
+        Permissão: `payment-account:read`. A conta Stripe é resolvida no servidor a partir da organização autorizada.
+
+        Parameters
+        ----------
+        organization_id : str
+            UUID da organização vinculada à API key ou à sessão autorizada.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StripeObject
+            Objeto Stripe retornado pelo backend. Campos de resposta ainda não possuem schema detalhado neste contrato.
+
+        Examples
+        --------
+        from adila_pay import AdilaPayClient
+
+        client = AdilaPayClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.account.retrieve(
+            organization_id="organizationId",
+        )
+        """
+        _response = self._raw_client.retrieve(organization_id=organization_id, request_options=request_options)
+        return _response.data
+
+
+class AsyncAccountClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAccountClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAccountClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAccountClient
+        """
+        return self._raw_client
+
+    async def retrieve(
+        self, *, organization_id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> StripeObject:
+        """
+        Permissão: `payment-account:read`. A conta Stripe é resolvida no servidor a partir da organização autorizada.
+
+        Parameters
+        ----------
+        organization_id : str
+            UUID da organização vinculada à API key ou à sessão autorizada.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StripeObject
+            Objeto Stripe retornado pelo backend. Campos de resposta ainda não possuem schema detalhado neste contrato.
+
+        Examples
+        --------
+        import asyncio
+
+        from adila_pay import AsyncAdilaPayClient
+
+        client = AsyncAdilaPayClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.account.retrieve(
+                organization_id="organizationId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.retrieve(organization_id=organization_id, request_options=request_options)
+        return _response.data