dodopayments 1.56.0__tar.gz → 1.56.3__tar.gz

dodopayments-1.56.3/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.56.3"
+}

{dodopayments-1.56.0 → dodopayments-1.56.3}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.56.3 (2025-10-29)
+
+Full Changelog: [v1.56.2...v1.56.3](https://github.com/dodopayments/dodopayments-python/compare/v1.56.2...v1.56.3)
+
+### Features
+
+* **api:** updated openapi spec to v1.56.3 ([b0e5768](https://github.com/dodopayments/dodopayments-python/commit/b0e576841bb7d01e43521bf4d62d518267ce140f))
+
+## 1.56.2 (2025-10-27)
+
+Full Changelog: [v1.56.0...v1.56.2](https://github.com/dodopayments/dodopayments-python/compare/v1.56.0...v1.56.2)
+
+### Features
+
+* **api:** updated to openapi spec v1.56.0 ([f142f07](https://github.com/dodopayments/dodopayments-python/commit/f142f078dd7740c4538c8b267ff0f548d7de745e))
+
 ## 1.56.0 (2025-10-25)
 
 Full Changelog: [v1.55.7...v1.56.0](https://github.com/dodopayments/dodopayments-python/compare/v1.55.7...v1.56.0)

{dodopayments-1.56.0 → dodopayments-1.56.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dodopayments
-Version: 1.56.0
+Version: 1.56.3
 Summary: The official Python library for the Dodo Payments API
 Project-URL: Homepage, https://github.com/dodopayments/dodopayments-python
 Project-URL: Repository, https://github.com/dodopayments/dodopayments-python

{dodopayments-1.56.0 → dodopayments-1.56.3}/api.md

@@ -3,12 +3,17 @@
 Types:
 
 ```python
-from dodopayments.types import CheckoutSessionRequest, CheckoutSessionResponse
+from dodopayments.types import (
+    CheckoutSessionRequest,
+    CheckoutSessionResponse,
+    CheckoutSessionStatus,
+)
 ```
 
 Methods:
 
 - <code title="post /checkouts">client.checkout_sessions.<a href="./src/dodopayments/resources/checkout_sessions.py">create</a>(\*\*<a href="src/dodopayments/types/checkout_session_create_params.py">params</a>) -> <a href="./src/dodopayments/types/checkout_session_response.py">CheckoutSessionResponse</a></code>
+- <code title="get /checkouts/{id}">client.checkout_sessions.<a href="./src/dodopayments/resources/checkout_sessions.py">retrieve</a>(id) -> <a href="./src/dodopayments/types/checkout_session_status.py">CheckoutSessionStatus</a></code>
 
 # Payments
 

{dodopayments-1.56.0 → dodopayments-1.56.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dodopayments"
-version = "1.56.0"
+version = "1.56.3"
 description = "The official Python library for the Dodo Payments API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "dodopayments"
-__version__ = "1.56.0"  # x-release-please-version
+__version__ = "1.56.3"  # x-release-please-version

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/resources/checkout_sessions.py

@@ -21,6 +21,7 @@ from .._base_client import make_request_options
 from ..types.currency import Currency
 from ..types.payment_method_types import PaymentMethodTypes
 from ..types.customer_request_param import CustomerRequestParam
+from ..types.checkout_session_status import CheckoutSessionStatus
 from ..types.checkout_session_response import CheckoutSessionResponse
 
 __all__ = ["CheckoutSessionsResource", "AsyncCheckoutSessionsResource"]
@@ -134,6 +135,37 @@ class CheckoutSessionsResource(SyncAPIResource):
             cast_to=CheckoutSessionResponse,
         )
 
+    def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> CheckoutSessionStatus:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/checkouts/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=CheckoutSessionStatus,
+        )
+
 
 class AsyncCheckoutSessionsResource(AsyncAPIResource):
     @cached_property
@@ -243,6 +275,37 @@ class AsyncCheckoutSessionsResource(AsyncAPIResource):
             cast_to=CheckoutSessionResponse,
         )
 
+    async def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> CheckoutSessionStatus:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/checkouts/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=CheckoutSessionStatus,
+        )
+
 
 class CheckoutSessionsResourceWithRawResponse:
     def __init__(self, checkout_sessions: CheckoutSessionsResource) -> None:
@@ -251,6 +314,9 @@ class CheckoutSessionsResourceWithRawResponse:
         self.create = to_raw_response_wrapper(
             checkout_sessions.create,
         )
+        self.retrieve = to_raw_response_wrapper(
+            checkout_sessions.retrieve,
+        )
 
 
 class AsyncCheckoutSessionsResourceWithRawResponse:
@@ -260,6 +326,9 @@ class AsyncCheckoutSessionsResourceWithRawResponse:
         self.create = async_to_raw_response_wrapper(
             checkout_sessions.create,
         )
+        self.retrieve = async_to_raw_response_wrapper(
+            checkout_sessions.retrieve,
+        )
 
 
 class CheckoutSessionsResourceWithStreamingResponse:
@@ -269,6 +338,9 @@ class CheckoutSessionsResourceWithStreamingResponse:
         self.create = to_streamed_response_wrapper(
             checkout_sessions.create,
         )
+        self.retrieve = to_streamed_response_wrapper(
+            checkout_sessions.retrieve,
+        )
 
 
 class AsyncCheckoutSessionsResourceWithStreamingResponse:
@@ -278,3 +350,6 @@ class AsyncCheckoutSessionsResourceWithStreamingResponse:
         self.create = async_to_streamed_response_wrapper(
             checkout_sessions.create,
         )
+        self.retrieve = async_to_streamed_response_wrapper(
+            checkout_sessions.retrieve,
+        )

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/resources/refunds.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Union, Iterable, Optional
+from typing import Dict, Union, Iterable, Optional
 from datetime import datetime
 from typing_extensions import Literal
 
@@ -52,6 +52,7 @@ class RefundsResource(SyncAPIResource):
         *,
         payment_id: str,
         items: Optional[Iterable[refund_create_params.Item]] | Omit = omit,
+        metadata: Dict[str, str] | Omit = omit,
         reason: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -66,6 +67,8 @@ class RefundsResource(SyncAPIResource):
 
           items: Partially Refund an Individual Item
 
+          metadata: Additional metadata associated with the refund.
+
           reason: The reason for the refund, if any. Maximum length is 3000 characters. Optional.
 
           extra_headers: Send extra headers
@@ -82,6 +85,7 @@ class RefundsResource(SyncAPIResource):
                 {
                     "payment_id": payment_id,
                     "items": items,
+                    "metadata": metadata,
                     "reason": reason,
                 },
                 refund_create_params.RefundCreateParams,
@@ -210,6 +214,7 @@ class AsyncRefundsResource(AsyncAPIResource):
         *,
         payment_id: str,
         items: Optional[Iterable[refund_create_params.Item]] | Omit = omit,
+        metadata: Dict[str, str] | Omit = omit,
         reason: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -224,6 +229,8 @@ class AsyncRefundsResource(AsyncAPIResource):
 
           items: Partially Refund an Individual Item
 
+          metadata: Additional metadata associated with the refund.
+
           reason: The reason for the refund, if any. Maximum length is 3000 characters. Optional.
 
           extra_headers: Send extra headers
@@ -240,6 +247,7 @@ class AsyncRefundsResource(AsyncAPIResource):
                 {
                     "payment_id": payment_id,
                     "items": items,
+                    "metadata": metadata,
                     "reason": reason,
                 },
                 refund_create_params.RefundCreateParams,

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/resources/subscriptions.py

@@ -206,6 +206,7 @@ class SubscriptionsResource(SyncAPIResource):
         *,
         billing: Optional[BillingAddressParam] | Omit = omit,
         cancel_at_next_billing_date: Optional[bool] | Omit = omit,
+        customer_name: Optional[str] | Omit = omit,
         disable_on_demand: Optional[subscription_update_params.DisableOnDemand] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         next_billing_date: Union[str, datetime, None] | Omit = omit,
@@ -238,6 +239,7 @@ class SubscriptionsResource(SyncAPIResource):
                 {
                     "billing": billing,
                     "cancel_at_next_billing_date": cancel_at_next_billing_date,
+                    "customer_name": customer_name,
                     "disable_on_demand": disable_on_demand,
                     "metadata": metadata,
                     "next_billing_date": next_billing_date,
@@ -702,6 +704,7 @@ class AsyncSubscriptionsResource(AsyncAPIResource):
         *,
         billing: Optional[BillingAddressParam] | Omit = omit,
         cancel_at_next_billing_date: Optional[bool] | Omit = omit,
+        customer_name: Optional[str] | Omit = omit,
         disable_on_demand: Optional[subscription_update_params.DisableOnDemand] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         next_billing_date: Union[str, datetime, None] | Omit = omit,
@@ -734,6 +737,7 @@ class AsyncSubscriptionsResource(AsyncAPIResource):
                 {
                     "billing": billing,
                     "cancel_at_next_billing_date": cancel_at_next_billing_date,
+                    "customer_name": customer_name,
                     "disable_on_demand": disable_on_demand,
                     "metadata": metadata,
                     "next_billing_date": next_billing_date,

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/types/__init__.py

@@ -75,6 +75,7 @@ from .customer_request_param import CustomerRequestParam as CustomerRequestParam
 from .customer_update_params import CustomerUpdateParams as CustomerUpdateParams
 from .discount_create_params import DiscountCreateParams as DiscountCreateParams
 from .discount_update_params import DiscountUpdateParams as DiscountUpdateParams
+from .checkout_session_status import CheckoutSessionStatus as CheckoutSessionStatus
 from .customer_portal_session import CustomerPortalSession as CustomerPortalSession
 from .license_activate_params import LicenseActivateParams as LicenseActivateParams
 from .license_key_list_params import LicenseKeyListParams as LicenseKeyListParams

dodopayments-1.56.3/src/dodopayments/types/checkout_session_status.py

@@ -0,0 +1,35 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+from .intent_status import IntentStatus
+
+__all__ = ["CheckoutSessionStatus"]
+
+
+class CheckoutSessionStatus(BaseModel):
+    id: str
+    """Id of the checkout session"""
+
+    created_at: datetime
+    """Created at timestamp"""
+
+    customer_email: Optional[str] = None
+    """Customer email: prefers payment's customer, falls back to session"""
+
+    customer_name: Optional[str] = None
+    """Customer name: prefers payment's customer, falls back to session"""
+
+    payment_id: Optional[str] = None
+    """Id of the payment created by the checkout sessions.
+
+    Null if checkout sessions is still at the details collection stage.
+    """
+
+    payment_status: Optional[IntentStatus] = None
+    """status of the payment.
+
+    Null if checkout sessions is still at the details collection stage.
+    """

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/types/payment_method_types.py

@@ -17,6 +17,7 @@ PaymentMethodTypes: TypeAlias = Literal[
     "eps",
     "ideal",
     "przelewy24",
+    "paypal",
     "affirm",
     "klarna",
     "sepa",

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/types/refund.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from .._models import BaseModel
@@ -24,6 +24,9 @@ class Refund(BaseModel):
     is_partial: bool
     """If true the refund is a partial refund"""
 
+    metadata: Dict[str, str]
+    """Additional metadata stored with the refund."""
+
     payment_id: str
     """The unique identifier of the payment associated with the refund."""
 

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/types/refund_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Iterable, Optional
+from typing import Dict, Iterable, Optional
 from typing_extensions import Required, TypedDict
 
 __all__ = ["RefundCreateParams", "Item"]
@@ -15,6 +15,9 @@ class RefundCreateParams(TypedDict, total=False):
     items: Optional[Iterable[Item]]
     """Partially Refund an Individual Item"""
 
+    metadata: Dict[str, str]
+    """Additional metadata associated with the refund."""
+
     reason: Optional[str]
     """The reason for the refund, if any. Maximum length is 3000 characters. Optional."""
 

{dodopayments-1.56.0 → dodopayments-1.56.3}/src/dodopayments/types/subscription_update_params.py

@@ -19,6 +19,8 @@ class SubscriptionUpdateParams(TypedDict, total=False):
     cancel_at_next_billing_date: Optional[bool]
     """When set, the subscription will remain active until the end of billing period"""
 
+    customer_name: Optional[str]
+
     disable_on_demand: Optional[DisableOnDemand]
 
     metadata: Optional[Dict[str, str]]

{dodopayments-1.56.0 → dodopayments-1.56.3}/tests/api_resources/test_checkout_sessions.py

@@ -9,7 +9,10 @@ import pytest
 
 from tests.utils import assert_matches_type
 from dodopayments import DodoPayments, AsyncDodoPayments
-from dodopayments.types import CheckoutSessionResponse
+from dodopayments.types import (
+    CheckoutSessionStatus,
+    CheckoutSessionResponse,
+)
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
@@ -121,6 +124,44 @@ class TestCheckoutSessions:
 
         assert cast(Any, response.is_closed) is True
 
+    @parametrize
+    def test_method_retrieve(self, client: DodoPayments) -> None:
+        checkout_session = client.checkout_sessions.retrieve(
+            "id",
+        )
+        assert_matches_type(CheckoutSessionStatus, checkout_session, path=["response"])
+
+    @parametrize
+    def test_raw_response_retrieve(self, client: DodoPayments) -> None:
+        response = client.checkout_sessions.with_raw_response.retrieve(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        checkout_session = response.parse()
+        assert_matches_type(CheckoutSessionStatus, checkout_session, path=["response"])
+
+    @parametrize
+    def test_streaming_response_retrieve(self, client: DodoPayments) -> None:
+        with client.checkout_sessions.with_streaming_response.retrieve(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            checkout_session = response.parse()
+            assert_matches_type(CheckoutSessionStatus, checkout_session, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_retrieve(self, client: DodoPayments) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.checkout_sessions.with_raw_response.retrieve(
+                "",
+            )
+
 
 class TestAsyncCheckoutSessions:
     parametrize = pytest.mark.parametrize(
@@ -230,3 +271,41 @@ class TestAsyncCheckoutSessions:
             assert_matches_type(CheckoutSessionResponse, checkout_session, path=["response"])
 
         assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_method_retrieve(self, async_client: AsyncDodoPayments) -> None:
+        checkout_session = await async_client.checkout_sessions.retrieve(
+            "id",
+        )
+        assert_matches_type(CheckoutSessionStatus, checkout_session, path=["response"])
+
+    @parametrize
+    async def test_raw_response_retrieve(self, async_client: AsyncDodoPayments) -> None:
+        response = await async_client.checkout_sessions.with_raw_response.retrieve(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        checkout_session = await response.parse()
+        assert_matches_type(CheckoutSessionStatus, checkout_session, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_retrieve(self, async_client: AsyncDodoPayments) -> None:
+        async with async_client.checkout_sessions.with_streaming_response.retrieve(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            checkout_session = await response.parse()
+            assert_matches_type(CheckoutSessionStatus, checkout_session, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_retrieve(self, async_client: AsyncDodoPayments) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.checkout_sessions.with_raw_response.retrieve(
+                "",
+            )

{dodopayments-1.56.0 → dodopayments-1.56.3}/tests/api_resources/test_refunds.py

@@ -37,6 +37,7 @@ class TestRefunds:
                     "tax_inclusive": True,
                 }
             ],
+            metadata={"foo": "string"},
             reason="reason",
         )
         assert_matches_type(Refund, refund, path=["response"])
@@ -164,6 +165,7 @@ class TestAsyncRefunds:
                     "tax_inclusive": True,
                 }
             ],
+            metadata={"foo": "string"},
             reason="reason",
         )
         assert_matches_type(Refund, refund, path=["response"])

{dodopayments-1.56.0 → dodopayments-1.56.3}/tests/api_resources/test_subscriptions.py

@@ -179,6 +179,7 @@ class TestSubscriptions:
                 "zipcode": "zipcode",
             },
             cancel_at_next_billing_date=True,
+            customer_name="customer_name",
             disable_on_demand={"next_billing_date": parse_datetime("2019-12-27T18:11:19.117Z")},
             metadata={"foo": "string"},
             next_billing_date=parse_datetime("2019-12-27T18:11:19.117Z"),
@@ -602,6 +603,7 @@ class TestAsyncSubscriptions:
                 "zipcode": "zipcode",
             },
             cancel_at_next_billing_date=True,
+            customer_name="customer_name",
             disable_on_demand={"next_billing_date": parse_datetime("2019-12-27T18:11:19.117Z")},
             metadata={"foo": "string"},
             next_billing_date=parse_datetime("2019-12-27T18:11:19.117Z"),

dodopayments-1.56.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.56.0"
-}