checkout-intents 0.4.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

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.4.0"  # x-release-please-version
+__version__ = "0.6.0"  # x-release-please-version

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/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/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/types/offer.py

@@ -42,3 +42,5 @@ class Offer(BaseModel):
     cost: Cost
 
     shipping: Shipping
+
+    applied_promo_codes: Optional[List[str]] = FieldInfo(alias="appliedPromoCodes", default=None)

{checkout_intents-0.4.0.dist-info → checkout_intents-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: checkout-intents
-Version: 0.4.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.4.0.dist-info → checkout_intents-0.6.0.dist-info}/RECORD

@@ -11,7 +11,7 @@ checkout_intents/_resource.py,sha256=X-eWffEBAgzTZvakLqNUjwgidMKfBFRmCeeOiuko4lg
 checkout_intents/_response.py,sha256=sLqxWBxzmVqPsdr2x5z6d87h8jb1U-Huvh2YFg-U6nE,28876
 checkout_intents/_streaming.py,sha256=y8SjBVAw2SDdVczQsP1T3dufnx4040C5fQqz-jGSvmg,10257
 checkout_intents/_types.py,sha256=PTRxqWPBW57h6JvfwcVuR42gIMpY4nwSZbqAtv85Ado,7305
-checkout_intents/_version.py,sha256=q5x-gNLeFmdAlSifoTUgwwFsiIX-72k110WhIro20ko,168
+checkout_intents/_version.py,sha256=966amIo052GT-pzkFrAnbNSvKYeP2QLWrFSs8_y1uhQ,168
 checkout_intents/pagination.py,sha256=VMe3ftq-qqAku2ERRTOz7iZOoMQ_KKp2HIUl_I8oAXE,2908
 checkout_intents/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 checkout_intents/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
@@ -29,8 +29,8 @@ checkout_intents/_utils/_utils.py,sha256=g9ftElB09kVT6EVfCIlD_nUfANhDX5_vZO61FDW
 checkout_intents/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 checkout_intents/resources/__init__.py,sha256=sHRW0nwo1GnFBFPoTNohkEbvOk7au-R3MdfVn_yb8Ds,1120
 checkout_intents/resources/brands.py,sha256=jJ5Jn2GG3MPkdKSg6_OG89dSQTaSGM9e7lBtovn-ABE,6389
-checkout_intents/resources/checkout_intents.py,sha256=yK_dauwDI6rqHU187FqLQyU9yrdUwJD6Ziubs_keVFU,54591
-checkout_intents/types/__init__.py,sha256=bcfwLNTB5CbPquNwxpMRoJkL5LM6HckISeGRPlVX2js,1192
+checkout_intents/resources/checkout_intents.py,sha256=Rsn0VNlKXziZAdU0BZ_-H8pxh2q4-f_Z24dP_N7wlVk,59540
+checkout_intents/types/__init__.py,sha256=VhZDCRhKlUnKs1h-8UNWj0HUUtJBjHFo16Stxy_kgS4,1298
 checkout_intents/types/base_checkout_intent.py,sha256=i31jUBw1fFlFQI4pUxLhiHAM82k3dDWiK3puTlKO5VE,728
 checkout_intents/types/brand_retrieve_response.py,sha256=c8DCAJvHFHcrIOW6onHj5Y51Yba7zyOrRXZuGfqYkBc,561
 checkout_intents/types/buyer.py,sha256=Ov6mVD-Hjm9A-i9p2dWCXtniLhYpG_6jvy9DReC54YQ,530
@@ -40,13 +40,14 @@ checkout_intents/types/checkout_intent_add_payment_params.py,sha256=s8KKWVM3Xain
 checkout_intents/types/checkout_intent_confirm_params.py,sha256=v_fcmuH5GoEwUJLbV7N9BDti63dg8z1nmhpcr4-1qcs,473
 checkout_intents/types/checkout_intent_create_params.py,sha256=DEfM_bAsMijLAtGTZpC0RjnwvJc3rQDd_H9jEgjFc28,812
 checkout_intents/types/checkout_intent_list_params.py,sha256=zc8_xwBHChOcl7bTMSjU7ZbHKIyQGYeUy5UrxeloJj0,521
+checkout_intents/types/checkout_intent_purchase_params.py,sha256=PzDCzbKExNzkYR5eWpTs-p0x9OJPgCroDTgv60XV0Co,848
 checkout_intents/types/money.py,sha256=-AfFFrfnUy6cAaFykF_gWZQxDGlzA1r_dJzJZRxhUto,328
-checkout_intents/types/offer.py,sha256=gtjQtU0w7m3jVwtykNaFxkYD4s_3Z2son1c0I_XRSVg,886
+checkout_intents/types/offer.py,sha256=9nGYAlA3tEiRU9lvsktnVl6EWj5dLNr6K9LB8WprckI,985
 checkout_intents/types/payment_method.py,sha256=-v5-L5RPojm8IDrdAhIMGmhVb89vwqT1jhgb-ZWOG7Q,1069
 checkout_intents/types/payment_method_param.py,sha256=_yzwZ5nw7bStK4U2-1ybtpjdJz5funCOMN7MALtF0xk,1225
 checkout_intents/types/variant_selection.py,sha256=y6mlU-qGwDfE77mU-x1GTXkDsmn6vuPpy5lBYXqXCBw,259
 checkout_intents/types/variant_selection_param.py,sha256=ahwTmDVIUMV8jvpggEo2jDUTIm9xvXbntDxmIZqT2_k,355
-checkout_intents-0.4.0.dist-info/METADATA,sha256=mtCjHkGVvNhRvcqnkHFRvUD8NzhW2UaSUXmSDJnPfE8,23781
-checkout_intents-0.4.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-checkout_intents-0.4.0.dist-info/licenses/LICENSE,sha256=dRDmL6lFnLaphTaman8kAc21qY1IQ_qsAETk1F-b6jY,1056
-checkout_intents-0.4.0.dist-info/RECORD,,
+checkout_intents-0.6.0.dist-info/METADATA,sha256=E8QgfXK6c2_9ZDcPlgqJ7LH5fs-no-JvRgA3QM55atc,23781
+checkout_intents-0.6.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+checkout_intents-0.6.0.dist-info/licenses/LICENSE,sha256=dRDmL6lFnLaphTaman8kAc21qY1IQ_qsAETk1F-b6jY,1056
+checkout_intents-0.6.0.dist-info/RECORD,,