pinelabs-python 0.1.0__py3-none-any.whl

pinelabs/affordability_suite/raw_client.py

@@ -0,0 +1,1095 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.jsonable_encoder import encode_path_param
+from ..core.parse_error import ParsingError
+from ..core.pydantic_utilities import parse_obj_as
+from ..core.request_options import RequestOptions
+from ..core.serialization import convert_and_respect_annotation_metadata
+from ..errors.bad_request_error import BadRequestError
+from ..errors.internal_server_error import InternalServerError
+from ..errors.unauthorized_error import UnauthorizedError
+from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.amount import Amount
+from ..types.downpayment_details_response import DownpaymentDetailsResponse
+from ..types.error_response import ErrorResponse
+from ..types.imei_product import ImeiProduct
+from ..types.offer_discovery_response import OfferDiscoveryResponse
+from ..types.offer_validation_response import OfferValidationResponse
+from ..types.product_detail import ProductDetail
+from .types.downpayment_details_request_issuer import DownpaymentDetailsRequestIssuer
+from .types.imei_validation_request_request_type import ImeiValidationRequestRequestType
+from .types.offer_discovery_cardless_request_payment_option import OfferDiscoveryCardlessRequestPaymentOption
+from .types.offer_discovery_request_cart_coupon_discount_amount import OfferDiscoveryRequestCartCouponDiscountAmount
+from .types.offer_discovery_request_customer_details import OfferDiscoveryRequestCustomerDetails
+from .types.offer_discovery_request_downpayment_details import OfferDiscoveryRequestDownpaymentDetails
+from .types.offer_discovery_request_issuer import OfferDiscoveryRequestIssuer
+from .types.offer_discovery_request_order_amount import OfferDiscoveryRequestOrderAmount
+from .types.offer_discovery_request_payment_options import OfferDiscoveryRequestPaymentOptions
+from .types.offer_discovery_request_product_details_item import OfferDiscoveryRequestProductDetailsItem
+from .types.offer_validation_request_customer_details import OfferValidationRequestCustomerDetails
+from .types.offer_validation_request_offer_data import OfferValidationRequestOfferData
+from .types.offer_validation_request_order_amount import OfferValidationRequestOrderAmount
+from .types.offer_validation_request_payment_amount import OfferValidationRequestPaymentAmount
+from .types.offer_validation_request_payment_option import OfferValidationRequestPaymentOption
+from pydantic import ValidationError
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawAffordabilitySuiteClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def create_offer_discovery(
+        self,
+        *,
+        order_amount: OfferDiscoveryRequestOrderAmount,
+        accept_encoding: typing.Optional[str] = None,
+        product_details: typing.Optional[typing.Sequence[OfferDiscoveryRequestProductDetailsItem]] = OMIT,
+        cart_coupon_discount_amount: typing.Optional[OfferDiscoveryRequestCartCouponDiscountAmount] = OMIT,
+        issuer: typing.Optional[OfferDiscoveryRequestIssuer] = OMIT,
+        downpayment_details: typing.Optional[OfferDiscoveryRequestDownpaymentDetails] = OMIT,
+        payment_options: typing.Optional[OfferDiscoveryRequestPaymentOptions] = OMIT,
+        customer_details: typing.Optional[OfferDiscoveryRequestCustomerDetails] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[OfferDiscoveryResponse]:
+        """
+        Use this API to discover offers available on cart amount or product and calculate the EMI.
+
+        Parameters
+        ----------
+        order_amount : OfferDiscoveryRequestOrderAmount
+            An object that contains the transaction amount details.
+
+        accept_encoding : typing.Optional[str]
+            Type of content-encoding supported. Accepted value: `gzip`
+
+        product_details : typing.Optional[typing.Sequence[OfferDiscoveryRequestProductDetailsItem]]
+            Mandatory for Brand EMI. An object that contains product details.
+
+        cart_coupon_discount_amount : typing.Optional[OfferDiscoveryRequestCartCouponDiscountAmount]
+            An object that contains the cart coupon discount amount details.
+
+        issuer : typing.Optional[OfferDiscoveryRequestIssuer]
+            An object that contains the issuer details.
+
+        downpayment_details : typing.Optional[OfferDiscoveryRequestDownpaymentDetails]
+            Mandatory for EMI with Downpayment. An object that contains the downpayment amount details.
+
+        payment_options : typing.Optional[OfferDiscoveryRequestPaymentOptions]
+            An object that contains the details of the payment options. You can use either `card_details` or `card_token_details` as a payment option.
+
+        customer_details : typing.Optional[OfferDiscoveryRequestCustomerDetails]
+            An object that contains the customer details.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[OfferDiscoveryResponse]
+            200
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/discovery",
+            method="POST",
+            json={
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=OfferDiscoveryRequestOrderAmount, direction="write"
+                ),
+                "product_details": convert_and_respect_annotation_metadata(
+                    object_=product_details,
+                    annotation=typing.Sequence[OfferDiscoveryRequestProductDetailsItem],
+                    direction="write",
+                ),
+                "cart_coupon_discount_amount": convert_and_respect_annotation_metadata(
+                    object_=cart_coupon_discount_amount,
+                    annotation=OfferDiscoveryRequestCartCouponDiscountAmount,
+                    direction="write",
+                ),
+                "issuer": convert_and_respect_annotation_metadata(
+                    object_=issuer, annotation=OfferDiscoveryRequestIssuer, direction="write"
+                ),
+                "downpayment_details": convert_and_respect_annotation_metadata(
+                    object_=downpayment_details, annotation=OfferDiscoveryRequestDownpaymentDetails, direction="write"
+                ),
+                "payment_options": convert_and_respect_annotation_metadata(
+                    object_=payment_options, annotation=OfferDiscoveryRequestPaymentOptions, direction="write"
+                ),
+                "customer_details": convert_and_respect_annotation_metadata(
+                    object_=customer_details, annotation=OfferDiscoveryRequestCustomerDetails, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+                "Accept-Encoding": str(accept_encoding) if accept_encoding is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    OfferDiscoveryResponse,
+                    parse_obj_as(
+                        type_=OfferDiscoveryResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_cardless_offer_discovery(
+        self,
+        *,
+        order_amount: Amount,
+        payment_option: OfferDiscoveryCardlessRequestPaymentOption,
+        product_details: typing.Optional[typing.Sequence[ProductDetail]] = OMIT,
+        cart_coupon_discount_amount: typing.Optional[Amount] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[OfferDiscoveryResponse]:
+        """
+        Discover available cardless EMI offers for a given order amount and product.
+        Used when customer does not use a card for EMI (e.g. BNPL-style cardless EMI).
+
+        Parameters
+        ----------
+        order_amount : Amount
+
+        payment_option : OfferDiscoveryCardlessRequestPaymentOption
+            An object that contains details related to the payment option.
+
+        product_details : typing.Optional[typing.Sequence[ProductDetail]]
+            Mandatory for Brand EMI. Contains product details.
+
+        cart_coupon_discount_amount : typing.Optional[Amount]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[OfferDiscoveryResponse]
+            Cardless offers discovered successfully.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/discovery/cardless",
+            method="POST",
+            json={
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=Amount, direction="write"
+                ),
+                "product_details": convert_and_respect_annotation_metadata(
+                    object_=product_details, annotation=typing.Sequence[ProductDetail], direction="write"
+                ),
+                "cart_coupon_discount_amount": convert_and_respect_annotation_metadata(
+                    object_=cart_coupon_discount_amount, annotation=Amount, direction="write"
+                ),
+                "payment_option": convert_and_respect_annotation_metadata(
+                    object_=payment_option, annotation=OfferDiscoveryCardlessRequestPaymentOption, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    OfferDiscoveryResponse,
+                    parse_obj_as(
+                        type_=OfferDiscoveryResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_down_payment_details(
+        self,
+        *,
+        order_amount: Amount,
+        product_details: typing.Optional[typing.Sequence[ProductDetail]] = OMIT,
+        cart_coupon_discount_amount: typing.Optional[Amount] = OMIT,
+        issuer: typing.Optional[DownpaymentDetailsRequestIssuer] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[DownpaymentDetailsResponse]:
+        """
+        Retrieve applicable down payment range and EMI repayment details
+        based on order amount and issuer BIN.
+
+        Parameters
+        ----------
+        order_amount : Amount
+
+        product_details : typing.Optional[typing.Sequence[ProductDetail]]
+            Mandatory for Brand EMI. Contains product details.
+
+        cart_coupon_discount_amount : typing.Optional[Amount]
+
+        issuer : typing.Optional[DownpaymentDetailsRequestIssuer]
+            Issuer identification details.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[DownpaymentDetailsResponse]
+            Down payment details retrieved successfully.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/downpayment/details",
+            method="POST",
+            json={
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=Amount, direction="write"
+                ),
+                "product_details": convert_and_respect_annotation_metadata(
+                    object_=product_details, annotation=typing.Sequence[ProductDetail], direction="write"
+                ),
+                "cart_coupon_discount_amount": convert_and_respect_annotation_metadata(
+                    object_=cart_coupon_discount_amount, annotation=Amount, direction="write"
+                ),
+                "issuer": convert_and_respect_annotation_metadata(
+                    object_=issuer, annotation=DownpaymentDetailsRequestIssuer, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DownpaymentDetailsResponse,
+                    parse_obj_as(
+                        type_=DownpaymentDetailsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def offer_validation_create(
+        self,
+        *,
+        payment_method: str,
+        order_amount: OfferValidationRequestOrderAmount,
+        payment_amount: OfferValidationRequestPaymentAmount,
+        payment_option: OfferValidationRequestPaymentOption,
+        offer_data: OfferValidationRequestOfferData,
+        accept_encoding: typing.Optional[str] = None,
+        customer_details: typing.Optional[OfferValidationRequestCustomerDetails] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[OfferValidationResponse]:
+        """
+        Use this API for validating applied offers.
+
+        Parameters
+        ----------
+        payment_method : str
+            Type of payment method you want to use to accept a payment.<br><br>Accepted values:<ul><li>`CREDIT_EMI`</li><li>`DEBIT_EMI`</li><li>`CARDLESS_EMI`</ul></li>
+
+        order_amount : OfferValidationRequestOrderAmount
+            An object that contains order amount.
+
+        payment_amount : OfferValidationRequestPaymentAmount
+            An object that contains the payment amount details after the offer has been applied.<br><br>**Note**: Ensure you pass the `auth_amount` details. This `auth_amount` detail is returned through our Offer Discovery API response.
+
+        payment_option : OfferValidationRequestPaymentOption
+            An object that contains the details of the payment options.<br><br>You can use either `card_details` or `card_token_details` or `cardless_details` as a payment option. One object is mandatory to process the request.
+
+        offer_data : OfferValidationRequestOfferData
+            An object that contains details related to the offer.
+
+        accept_encoding : typing.Optional[str]
+            Type of content-encoding supported.<br><br>Accepted value: `gzip`
+
+        customer_details : typing.Optional[OfferValidationRequestCustomerDetails]
+            An object that contains details related to the customer.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[OfferValidationResponse]
+            200
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/validate",
+            method="POST",
+            json={
+                "payment_method": payment_method,
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=OfferValidationRequestOrderAmount, direction="write"
+                ),
+                "payment_amount": convert_and_respect_annotation_metadata(
+                    object_=payment_amount, annotation=OfferValidationRequestPaymentAmount, direction="write"
+                ),
+                "payment_option": convert_and_respect_annotation_metadata(
+                    object_=payment_option, annotation=OfferValidationRequestPaymentOption, direction="write"
+                ),
+                "offer_data": convert_and_respect_annotation_metadata(
+                    object_=offer_data, annotation=OfferValidationRequestOfferData, direction="write"
+                ),
+                "customer_details": convert_and_respect_annotation_metadata(
+                    object_=customer_details, annotation=OfferValidationRequestCustomerDetails, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+                "Accept-Encoding": str(accept_encoding) if accept_encoding is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    OfferValidationResponse,
+                    parse_obj_as(
+                        type_=OfferValidationResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_imei_validation(
+        self,
+        order_id: str,
+        *,
+        merchant_product_imei_reference: str,
+        request_type: ImeiValidationRequestRequestType,
+        products: typing.Sequence[ImeiProduct],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[None]:
+        """
+        Validate or block/unblock IMEI numbers for Brand EMI transactions.
+        Used to confirm the device is eligible for the selected EMI program.
+
+        Parameters
+        ----------
+        order_id : str
+            Unique Pine Labs order identifier.
+
+        merchant_product_imei_reference : str
+            **Idempotency Key.** Merchant product IMEI reference. Duplicate requests with the same `merchant_product_imei_reference` will return the existing result instead of creating a new one.
+
+        request_type : ImeiValidationRequestRequestType
+            IMEI request type.
+
+        products : typing.Sequence[ImeiProduct]
+            Array of product details for IMEI validation.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[None]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/affordability/v1/product/{encode_path_param(order_id)}/imei",
+            method="POST",
+            json={
+                "merchant_product_imei_reference": merchant_product_imei_reference,
+                "request_type": request_type,
+                "products": convert_and_respect_annotation_metadata(
+                    object_=products, annotation=typing.Sequence[ImeiProduct], direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return HttpResponse(response=_response, data=None)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawAffordabilitySuiteClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def create_offer_discovery(
+        self,
+        *,
+        order_amount: OfferDiscoveryRequestOrderAmount,
+        accept_encoding: typing.Optional[str] = None,
+        product_details: typing.Optional[typing.Sequence[OfferDiscoveryRequestProductDetailsItem]] = OMIT,
+        cart_coupon_discount_amount: typing.Optional[OfferDiscoveryRequestCartCouponDiscountAmount] = OMIT,
+        issuer: typing.Optional[OfferDiscoveryRequestIssuer] = OMIT,
+        downpayment_details: typing.Optional[OfferDiscoveryRequestDownpaymentDetails] = OMIT,
+        payment_options: typing.Optional[OfferDiscoveryRequestPaymentOptions] = OMIT,
+        customer_details: typing.Optional[OfferDiscoveryRequestCustomerDetails] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[OfferDiscoveryResponse]:
+        """
+        Use this API to discover offers available on cart amount or product and calculate the EMI.
+
+        Parameters
+        ----------
+        order_amount : OfferDiscoveryRequestOrderAmount
+            An object that contains the transaction amount details.
+
+        accept_encoding : typing.Optional[str]
+            Type of content-encoding supported. Accepted value: `gzip`
+
+        product_details : typing.Optional[typing.Sequence[OfferDiscoveryRequestProductDetailsItem]]
+            Mandatory for Brand EMI. An object that contains product details.
+
+        cart_coupon_discount_amount : typing.Optional[OfferDiscoveryRequestCartCouponDiscountAmount]
+            An object that contains the cart coupon discount amount details.
+
+        issuer : typing.Optional[OfferDiscoveryRequestIssuer]
+            An object that contains the issuer details.
+
+        downpayment_details : typing.Optional[OfferDiscoveryRequestDownpaymentDetails]
+            Mandatory for EMI with Downpayment. An object that contains the downpayment amount details.
+
+        payment_options : typing.Optional[OfferDiscoveryRequestPaymentOptions]
+            An object that contains the details of the payment options. You can use either `card_details` or `card_token_details` as a payment option.
+
+        customer_details : typing.Optional[OfferDiscoveryRequestCustomerDetails]
+            An object that contains the customer details.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[OfferDiscoveryResponse]
+            200
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/discovery",
+            method="POST",
+            json={
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=OfferDiscoveryRequestOrderAmount, direction="write"
+                ),
+                "product_details": convert_and_respect_annotation_metadata(
+                    object_=product_details,
+                    annotation=typing.Sequence[OfferDiscoveryRequestProductDetailsItem],
+                    direction="write",
+                ),
+                "cart_coupon_discount_amount": convert_and_respect_annotation_metadata(
+                    object_=cart_coupon_discount_amount,
+                    annotation=OfferDiscoveryRequestCartCouponDiscountAmount,
+                    direction="write",
+                ),
+                "issuer": convert_and_respect_annotation_metadata(
+                    object_=issuer, annotation=OfferDiscoveryRequestIssuer, direction="write"
+                ),
+                "downpayment_details": convert_and_respect_annotation_metadata(
+                    object_=downpayment_details, annotation=OfferDiscoveryRequestDownpaymentDetails, direction="write"
+                ),
+                "payment_options": convert_and_respect_annotation_metadata(
+                    object_=payment_options, annotation=OfferDiscoveryRequestPaymentOptions, direction="write"
+                ),
+                "customer_details": convert_and_respect_annotation_metadata(
+                    object_=customer_details, annotation=OfferDiscoveryRequestCustomerDetails, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+                "Accept-Encoding": str(accept_encoding) if accept_encoding is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    OfferDiscoveryResponse,
+                    parse_obj_as(
+                        type_=OfferDiscoveryResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_cardless_offer_discovery(
+        self,
+        *,
+        order_amount: Amount,
+        payment_option: OfferDiscoveryCardlessRequestPaymentOption,
+        product_details: typing.Optional[typing.Sequence[ProductDetail]] = OMIT,
+        cart_coupon_discount_amount: typing.Optional[Amount] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[OfferDiscoveryResponse]:
+        """
+        Discover available cardless EMI offers for a given order amount and product.
+        Used when customer does not use a card for EMI (e.g. BNPL-style cardless EMI).
+
+        Parameters
+        ----------
+        order_amount : Amount
+
+        payment_option : OfferDiscoveryCardlessRequestPaymentOption
+            An object that contains details related to the payment option.
+
+        product_details : typing.Optional[typing.Sequence[ProductDetail]]
+            Mandatory for Brand EMI. Contains product details.
+
+        cart_coupon_discount_amount : typing.Optional[Amount]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[OfferDiscoveryResponse]
+            Cardless offers discovered successfully.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/discovery/cardless",
+            method="POST",
+            json={
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=Amount, direction="write"
+                ),
+                "product_details": convert_and_respect_annotation_metadata(
+                    object_=product_details, annotation=typing.Sequence[ProductDetail], direction="write"
+                ),
+                "cart_coupon_discount_amount": convert_and_respect_annotation_metadata(
+                    object_=cart_coupon_discount_amount, annotation=Amount, direction="write"
+                ),
+                "payment_option": convert_and_respect_annotation_metadata(
+                    object_=payment_option, annotation=OfferDiscoveryCardlessRequestPaymentOption, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    OfferDiscoveryResponse,
+                    parse_obj_as(
+                        type_=OfferDiscoveryResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_down_payment_details(
+        self,
+        *,
+        order_amount: Amount,
+        product_details: typing.Optional[typing.Sequence[ProductDetail]] = OMIT,
+        cart_coupon_discount_amount: typing.Optional[Amount] = OMIT,
+        issuer: typing.Optional[DownpaymentDetailsRequestIssuer] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[DownpaymentDetailsResponse]:
+        """
+        Retrieve applicable down payment range and EMI repayment details
+        based on order amount and issuer BIN.
+
+        Parameters
+        ----------
+        order_amount : Amount
+
+        product_details : typing.Optional[typing.Sequence[ProductDetail]]
+            Mandatory for Brand EMI. Contains product details.
+
+        cart_coupon_discount_amount : typing.Optional[Amount]
+
+        issuer : typing.Optional[DownpaymentDetailsRequestIssuer]
+            Issuer identification details.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[DownpaymentDetailsResponse]
+            Down payment details retrieved successfully.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/downpayment/details",
+            method="POST",
+            json={
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=Amount, direction="write"
+                ),
+                "product_details": convert_and_respect_annotation_metadata(
+                    object_=product_details, annotation=typing.Sequence[ProductDetail], direction="write"
+                ),
+                "cart_coupon_discount_amount": convert_and_respect_annotation_metadata(
+                    object_=cart_coupon_discount_amount, annotation=Amount, direction="write"
+                ),
+                "issuer": convert_and_respect_annotation_metadata(
+                    object_=issuer, annotation=DownpaymentDetailsRequestIssuer, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DownpaymentDetailsResponse,
+                    parse_obj_as(
+                        type_=DownpaymentDetailsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def offer_validation_create(
+        self,
+        *,
+        payment_method: str,
+        order_amount: OfferValidationRequestOrderAmount,
+        payment_amount: OfferValidationRequestPaymentAmount,
+        payment_option: OfferValidationRequestPaymentOption,
+        offer_data: OfferValidationRequestOfferData,
+        accept_encoding: typing.Optional[str] = None,
+        customer_details: typing.Optional[OfferValidationRequestCustomerDetails] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[OfferValidationResponse]:
+        """
+        Use this API for validating applied offers.
+
+        Parameters
+        ----------
+        payment_method : str
+            Type of payment method you want to use to accept a payment.<br><br>Accepted values:<ul><li>`CREDIT_EMI`</li><li>`DEBIT_EMI`</li><li>`CARDLESS_EMI`</ul></li>
+
+        order_amount : OfferValidationRequestOrderAmount
+            An object that contains order amount.
+
+        payment_amount : OfferValidationRequestPaymentAmount
+            An object that contains the payment amount details after the offer has been applied.<br><br>**Note**: Ensure you pass the `auth_amount` details. This `auth_amount` detail is returned through our Offer Discovery API response.
+
+        payment_option : OfferValidationRequestPaymentOption
+            An object that contains the details of the payment options.<br><br>You can use either `card_details` or `card_token_details` or `cardless_details` as a payment option. One object is mandatory to process the request.
+
+        offer_data : OfferValidationRequestOfferData
+            An object that contains details related to the offer.
+
+        accept_encoding : typing.Optional[str]
+            Type of content-encoding supported.<br><br>Accepted value: `gzip`
+
+        customer_details : typing.Optional[OfferValidationRequestCustomerDetails]
+            An object that contains details related to the customer.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[OfferValidationResponse]
+            200
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/affordability/v1/offer/validate",
+            method="POST",
+            json={
+                "payment_method": payment_method,
+                "order_amount": convert_and_respect_annotation_metadata(
+                    object_=order_amount, annotation=OfferValidationRequestOrderAmount, direction="write"
+                ),
+                "payment_amount": convert_and_respect_annotation_metadata(
+                    object_=payment_amount, annotation=OfferValidationRequestPaymentAmount, direction="write"
+                ),
+                "payment_option": convert_and_respect_annotation_metadata(
+                    object_=payment_option, annotation=OfferValidationRequestPaymentOption, direction="write"
+                ),
+                "offer_data": convert_and_respect_annotation_metadata(
+                    object_=offer_data, annotation=OfferValidationRequestOfferData, direction="write"
+                ),
+                "customer_details": convert_and_respect_annotation_metadata(
+                    object_=customer_details, annotation=OfferValidationRequestCustomerDetails, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+                "Accept-Encoding": str(accept_encoding) if accept_encoding is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    OfferValidationResponse,
+                    parse_obj_as(
+                        type_=OfferValidationResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_imei_validation(
+        self,
+        order_id: str,
+        *,
+        merchant_product_imei_reference: str,
+        request_type: ImeiValidationRequestRequestType,
+        products: typing.Sequence[ImeiProduct],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[None]:
+        """
+        Validate or block/unblock IMEI numbers for Brand EMI transactions.
+        Used to confirm the device is eligible for the selected EMI program.
+
+        Parameters
+        ----------
+        order_id : str
+            Unique Pine Labs order identifier.
+
+        merchant_product_imei_reference : str
+            **Idempotency Key.** Merchant product IMEI reference. Duplicate requests with the same `merchant_product_imei_reference` will return the existing result instead of creating a new one.
+
+        request_type : ImeiValidationRequestRequestType
+            IMEI request type.
+
+        products : typing.Sequence[ImeiProduct]
+            Array of product details for IMEI validation.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[None]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/affordability/v1/product/{encode_path_param(order_id)}/imei",
+            method="POST",
+            json={
+                "merchant_product_imei_reference": merchant_product_imei_reference,
+                "request_type": request_type,
+                "products": convert_and_respect_annotation_metadata(
+                    object_=products, annotation=typing.Sequence[ImeiProduct], direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return AsyncHttpResponse(response=_response, data=None)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)