checkout-intents 0.5.0__tar.gz → 0.6.0__tar.gz

checkout_intents-0.6.0/.release-please-manifest.json

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

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.6.0 (2025-12-22)
+
+Full Changelog: [v0.5.0...v0.6.0](https://github.com/rye-com/checkout-intents-python/compare/v0.5.0...v0.6.0)
+
+### Features
+
+* Include `/purchase` endpoint in our SDKs + docs ([7744f80](https://github.com/rye-com/checkout-intents-python/commit/7744f80e20bc5399d9b29e0bfb11d6b8f9997e38))
+
+
+### Chores
+
+* include polling helpers in raw resp classes ([67b0e3c](https://github.com/rye-com/checkout-intents-python/commit/67b0e3c1899a3d5415b126466fd5f525f61f2529))
+
 ## 0.5.0 (2025-12-19)
 
 Full Changelog: [v0.4.0...v0.5.0](https://github.com/rye-com/checkout-intents-python/compare/v0.4.0...v0.5.0)

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: checkout-intents
-Version: 0.5.0
+Version: 0.6.0
 Summary: The official Python library for the Checkout Intents API
 Project-URL: Homepage, https://github.com/rye-com/checkout-intents-python
 Project-URL: Repository, https://github.com/rye-com/checkout-intents-python

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/api.md

@@ -21,6 +21,7 @@ Methods:
 - <code title="get /api/v1/checkout-intents">client.checkout_intents.<a href="./src/checkout_intents/resources/checkout_intents.py">list</a>(\*\*<a href="src/checkout_intents/types/checkout_intent_list_params.py">params</a>) -> <a href="./src/checkout_intents/types/checkout_intent.py">SyncCursorPagination[CheckoutIntent]</a></code>
 - <code title="post /api/v1/checkout-intents/{id}/payment">client.checkout_intents.<a href="./src/checkout_intents/resources/checkout_intents.py">add_payment</a>(id, \*\*<a href="src/checkout_intents/types/checkout_intent_add_payment_params.py">params</a>) -> <a href="./src/checkout_intents/types/checkout_intent.py">CheckoutIntent</a></code>
 - <code title="post /api/v1/checkout-intents/{id}/confirm">client.checkout_intents.<a href="./src/checkout_intents/resources/checkout_intents.py">confirm</a>(id, \*\*<a href="src/checkout_intents/types/checkout_intent_confirm_params.py">params</a>) -> <a href="./src/checkout_intents/types/checkout_intent.py">CheckoutIntent</a></code>
+- <code title="post /api/v1/checkout-intents/purchase">client.checkout_intents.<a href="./src/checkout_intents/resources/checkout_intents.py">purchase</a>(\*\*<a href="src/checkout_intents/types/checkout_intent_purchase_params.py">params</a>) -> <a href="./src/checkout_intents/types/checkout_intent.py">CheckoutIntent</a></code>
 
 # Brands
 

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "checkout-intents"
-version = "0.5.0"
+version = "0.6.0"
 description = "The official Python library for the Checkout Intents API"
 dynamic = ["readme"]
 license = "MIT"

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/src/checkout_intents/_version.py

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

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/src/checkout_intents/resources/checkout_intents.py

@@ -12,6 +12,7 @@ from ..types import (
     checkout_intent_list_params,
     checkout_intent_create_params,
     checkout_intent_confirm_params,
+    checkout_intent_purchase_params,
     checkout_intent_add_payment_params,
 )
 from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
@@ -287,6 +288,58 @@ class CheckoutIntentsResource(SyncAPIResource):
             ),
         )
 
+    def purchase(
+        self,
+        *,
+        buyer: BuyerParam,
+        product_url: str,
+        quantity: float,
+        variant_selections: Iterable[VariantSelectionParam] | Omit = omit,
+        payment_method: PaymentMethodParam,
+        # 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,
+    ) -> CheckoutIntent:
+        """
+        Create a checkout intent and immediately trigger the purchase workflow.
+   
+        This is a "fire-and-forget" endpoint that combines create + confirm in one step.
+        The workflow handles offer retrieval, payment authorization, and order placement
+        asynchronously. Poll the GET endpoint to check status.
+
+        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
+        """
+        return cast(
+            CheckoutIntent,
+            self._post(
+                f"/api/v1/checkout-intents/purchase",
+                body=maybe_transform(
+                    {
+                        "buyer": buyer,
+                        "payment_method": payment_method,
+                        "product_url": product_url,
+                        "quantity": quantity,
+                        "variant_selections": variant_selections,
+                    },
+                    checkout_intent_purchase_params.CheckoutIntentPurchaseParams
+                ),
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
     def _poll_until(
         self,
         id: str,
@@ -890,6 +943,58 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
             ),
         )
 
+    async def purchase(
+        self,
+        *,
+        buyer: BuyerParam,
+        product_url: str,
+        quantity: float,
+        variant_selections: Iterable[VariantSelectionParam] | Omit = omit,
+        payment_method: PaymentMethodParam,
+        # 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,
+    ) -> CheckoutIntent:
+        """
+        Create a checkout intent and immediately trigger the purchase workflow.
+   
+        This is a "fire-and-forget" endpoint that combines create + confirm in one step.
+        The workflow handles offer retrieval, payment authorization, and order placement
+        asynchronously. Poll the GET endpoint to check status.
+
+        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
+        """
+        return cast(
+            CheckoutIntent,
+            await self._post(
+                f"/api/v1/checkout-intents/purchase",
+                body=await async_maybe_transform(
+                    {
+                        "buyer": buyer,
+                        "payment_method": payment_method,
+                        "product_url": product_url,
+                        "quantity": quantity,
+                        "variant_selections": variant_selections,
+                    },
+                    checkout_intent_purchase_params.CheckoutIntentPurchaseParams
+                ),
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
     async def _poll_until(
         self,
         id: str,
@@ -1250,6 +1355,7 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
         )
 
 
+
 class CheckoutIntentsResourceWithRawResponse:
     def __init__(self, checkout_intents: CheckoutIntentsResource) -> None:
         self._checkout_intents = checkout_intents
@@ -1269,6 +1375,9 @@ class CheckoutIntentsResourceWithRawResponse:
         self.confirm = to_raw_response_wrapper(
             checkout_intents.confirm,
         )
+        self.purchase = to_raw_response_wrapper(
+            checkout_intents.purchase,
+        )
         self.poll_until_completed = to_raw_response_wrapper(
             checkout_intents.poll_until_completed,
         )
@@ -1283,6 +1392,7 @@ class CheckoutIntentsResourceWithRawResponse:
         )
 
 
+
 class AsyncCheckoutIntentsResourceWithRawResponse:
     def __init__(self, checkout_intents: AsyncCheckoutIntentsResource) -> None:
         self._checkout_intents = checkout_intents
@@ -1302,6 +1412,9 @@ class AsyncCheckoutIntentsResourceWithRawResponse:
         self.confirm = async_to_raw_response_wrapper(
             checkout_intents.confirm,
         )
+        self.purchase = async_to_raw_response_wrapper(
+            checkout_intents.purchase,
+        )
         self.poll_until_completed = async_to_raw_response_wrapper(
             checkout_intents.poll_until_completed,
         )
@@ -1316,6 +1429,7 @@ class AsyncCheckoutIntentsResourceWithRawResponse:
         )
 
 
+
 class CheckoutIntentsResourceWithStreamingResponse:
     def __init__(self, checkout_intents: CheckoutIntentsResource) -> None:
         self._checkout_intents = checkout_intents
@@ -1335,6 +1449,9 @@ class CheckoutIntentsResourceWithStreamingResponse:
         self.confirm = to_streamed_response_wrapper(
             checkout_intents.confirm,
         )
+        self.purchase = to_streamed_response_wrapper(
+            checkout_intents.purchase,
+        )
         self.poll_until_completed = to_streamed_response_wrapper(
             checkout_intents.poll_until_completed,
         )
@@ -1349,6 +1466,7 @@ class CheckoutIntentsResourceWithStreamingResponse:
         )
 
 
+
 class AsyncCheckoutIntentsResourceWithStreamingResponse:
     def __init__(self, checkout_intents: AsyncCheckoutIntentsResource) -> None:
         self._checkout_intents = checkout_intents
@@ -1368,6 +1486,9 @@ class AsyncCheckoutIntentsResourceWithStreamingResponse:
         self.confirm = async_to_streamed_response_wrapper(
             checkout_intents.confirm,
         )
+        self.purchase = async_to_streamed_response_wrapper(
+            checkout_intents.purchase,
+        )
         self.poll_until_completed = async_to_streamed_response_wrapper(
             checkout_intents.poll_until_completed,
         )

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/src/checkout_intents/types/__init__.py

@@ -16,4 +16,5 @@ from .variant_selection_param import VariantSelectionParam as VariantSelectionPa
 from .checkout_intent_list_params import CheckoutIntentListParams as CheckoutIntentListParams
 from .checkout_intent_create_params import CheckoutIntentCreateParams as CheckoutIntentCreateParams
 from .checkout_intent_confirm_params import CheckoutIntentConfirmParams as CheckoutIntentConfirmParams
+from .checkout_intent_purchase_params import CheckoutIntentPurchaseParams as CheckoutIntentPurchaseParams
 from .checkout_intent_add_payment_params import CheckoutIntentAddPaymentParams as CheckoutIntentAddPaymentParams

checkout_intents-0.6.0/src/checkout_intents/types/checkout_intent_purchase_params.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+from .buyer_param import BuyerParam
+from .payment_method_param import PaymentMethodParam
+from .variant_selection_param import VariantSelectionParam
+
+__all__ = ["CheckoutIntentPurchaseParams"]
+
+
+class CheckoutIntentPurchaseParams(TypedDict, total=False):
+    buyer: Required[BuyerParam]
+
+    payment_method: Required[Annotated[PaymentMethodParam, PropertyInfo(alias="paymentMethod")]]
+
+    product_url: Required[Annotated[str, PropertyInfo(alias="productUrl")]]
+
+    quantity: Required[float]
+
+    variant_selections: Annotated[Iterable[VariantSelectionParam], PropertyInfo(alias="variantSelections")]

{checkout_intents-0.5.0 → checkout_intents-0.6.0}/tests/api_resources/test_checkout_intents.py

@@ -340,6 +340,119 @@ class TestCheckoutIntents:
                 },
             )
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_purchase(self, client: CheckoutIntents) -> None:
+        checkout_intent = client.checkout_intents.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+        )
+        assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_purchase_with_all_params(self, client: CheckoutIntents) -> None:
+        checkout_intent = client.checkout_intents.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+                "address2": "Apt 1",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+            variant_selections=[
+                {
+                    "label": "Size, Color, etc.",
+                    "value": "Small, Red, XS, L, etc.",
+                }
+            ],
+        )
+        assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_purchase(self, client: CheckoutIntents) -> None:
+        response = client.checkout_intents.with_raw_response.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        checkout_intent = response.parse()
+        assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_purchase(self, client: CheckoutIntents) -> None:
+        with client.checkout_intents.with_streaming_response.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            checkout_intent = response.parse()
+            assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
 
 class TestAsyncCheckoutIntents:
     parametrize = pytest.mark.parametrize(
@@ -665,3 +778,116 @@ class TestAsyncCheckoutIntents:
                     "type": "stripe_token",
                 },
             )
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_purchase(self, async_client: AsyncCheckoutIntents) -> None:
+        checkout_intent = await async_client.checkout_intents.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+        )
+        assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_purchase_with_all_params(self, async_client: AsyncCheckoutIntents) -> None:
+        checkout_intent = await async_client.checkout_intents.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+                "address2": "Apt 1",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+            variant_selections=[
+                {
+                    "label": "Size, Color, etc.",
+                    "value": "Small, Red, XS, L, etc.",
+                }
+            ],
+        )
+        assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_purchase(self, async_client: AsyncCheckoutIntents) -> None:
+        response = await async_client.checkout_intents.with_raw_response.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        checkout_intent = await response.parse()
+        assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_purchase(self, async_client: AsyncCheckoutIntents) -> None:
+        async with async_client.checkout_intents.with_streaming_response.purchase(
+            buyer={
+                "address1": "123 Main St",
+                "city": "New York",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "first_name": "John",
+                "last_name": "Doe",
+                "phone": "1234567890",
+                "postal_code": "10001",
+                "province": "NY",
+            },
+            payment_method={
+                "stripe_token": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
+                "type": "stripe_token",
+            },
+            product_url="productUrl",
+            quantity=1,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            checkout_intent = await response.parse()
+            assert_matches_type(CheckoutIntent, checkout_intent, path=["response"])
+
+        assert cast(Any, response.is_closed) is True

checkout_intents-0.5.0/.release-please-manifest.json

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