pinelabs-python 0.1.0__py3-none-any.whl

pinelabs/affordability_suite/client.py

@@ -0,0 +1,1007 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.amount import Amount
+from ..types.downpayment_details_response import DownpaymentDetailsResponse
+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 .raw_client import AsyncRawAffordabilitySuiteClient, RawAffordabilitySuiteClient
+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
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class AffordabilitySuiteClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAffordabilitySuiteClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAffordabilitySuiteClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAffordabilitySuiteClient
+        """
+        return self._raw_client
+
+    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,
+    ) -> 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
+        -------
+        OfferDiscoveryResponse
+            200
+
+        Examples
+        --------
+        from pinelabs import PinelabsApi
+        from pinelabs.affordability_suite import (
+            OfferDiscoveryRequestIssuer,
+            OfferDiscoveryRequestOrderAmount,
+        )
+
+        client = PinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+        client.affordability_suite.create_offer_discovery(
+            order_amount=OfferDiscoveryRequestOrderAmount(
+                value=1200000,
+                currency="INR",
+            ),
+            issuer=OfferDiscoveryRequestIssuer(
+                bin="60100000",
+            ),
+        )
+        """
+        _response = self._raw_client.create_offer_discovery(
+            order_amount=order_amount,
+            accept_encoding=accept_encoding,
+            product_details=product_details,
+            cart_coupon_discount_amount=cart_coupon_discount_amount,
+            issuer=issuer,
+            downpayment_details=downpayment_details,
+            payment_options=payment_options,
+            customer_details=customer_details,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        OfferDiscoveryResponse
+            Cardless offers discovered successfully.
+
+        Examples
+        --------
+        from pinelabs import Amount, PinelabsApi
+        from pinelabs.affordability_suite import (
+            OfferDiscoveryCardlessRequestPaymentOption,
+            OfferDiscoveryCardlessRequestPaymentOptionCardlessDetails,
+        )
+
+        client = PinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+        client.affordability_suite.create_cardless_offer_discovery(
+            order_amount=Amount(
+                value=50000,
+                currency="INR",
+            ),
+            payment_option=OfferDiscoveryCardlessRequestPaymentOption(
+                cardless_details=OfferDiscoveryCardlessRequestPaymentOptionCardlessDetails(
+                    pan_number="234A123883",
+                    registered_mobile_number="9876543210",
+                ),
+            ),
+        )
+        """
+        _response = self._raw_client.create_cardless_offer_discovery(
+            order_amount=order_amount,
+            payment_option=payment_option,
+            product_details=product_details,
+            cart_coupon_discount_amount=cart_coupon_discount_amount,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        DownpaymentDetailsResponse
+            Down payment details retrieved successfully.
+
+        Examples
+        --------
+        from pinelabs import Amount, PinelabsApi
+
+        client = PinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+        client.affordability_suite.create_down_payment_details(
+            order_amount=Amount(
+                value=50000,
+                currency="INR",
+            ),
+        )
+        """
+        _response = self._raw_client.create_down_payment_details(
+            order_amount=order_amount,
+            product_details=product_details,
+            cart_coupon_discount_amount=cart_coupon_discount_amount,
+            issuer=issuer,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        OfferValidationResponse
+            200
+
+        Examples
+        --------
+        from pinelabs import PinelabsApi
+        from pinelabs.affordability_suite import (
+            OfferValidationRequestOfferData,
+            OfferValidationRequestOfferDataOfferDetails,
+            OfferValidationRequestOfferDataOfferDetailsTenure,
+            OfferValidationRequestOfferDataOfferDetailsTenureAuthAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItem,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemAfterDownpaymentReducedProductAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemDownpaymentAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemInterestAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemProductAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetails,
+            OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetailsDownpaymentAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureInterestAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureLoanAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureMonthlyEmiAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureNetPaymentAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureTotalEmiAmount,
+            OfferValidationRequestOrderAmount,
+            OfferValidationRequestPaymentAmount,
+            OfferValidationRequestPaymentOption,
+            OfferValidationRequestPaymentOptionCardDetails,
+        )
+
+        client = PinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+        client.affordability_suite.offer_validation_create(
+            payment_method="CREDIT_EMI",
+            order_amount=OfferValidationRequestOrderAmount(
+                value="value",
+                currency="INR",
+            ),
+            payment_amount=OfferValidationRequestPaymentAmount(
+                value="value",
+                currency="INR",
+            ),
+            payment_option=OfferValidationRequestPaymentOption(
+                card_details=OfferValidationRequestPaymentOptionCardDetails(
+                    card_number="4000000040001000",
+                    registered_mobile_number="9914152866",
+                ),
+            ),
+            offer_data=OfferValidationRequestOfferData(
+                offer_details=OfferValidationRequestOfferDataOfferDetails(
+                    id="6",
+                    name="HDFC CC",
+                    display_name="HDFC BANK",
+                    issuer_type="CC_BANK",
+                    priority="priority",
+                    tenure=OfferValidationRequestOfferDataOfferDetailsTenure(
+                        tenure_id="6",
+                        name="24 Months",
+                        tenure_type="MONTH",
+                        tenure_value=24,
+                        issuer_offer_parameters="issuer_offer_parameters",
+                        details=[
+                            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItem(
+                                product_code="xyz",
+                                product_display_name="Redmi Note 13 5G",
+                                product_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemProductAmount(
+                                    value="value",
+                                    currency="INR",
+                                ),
+                                brand_name="Xiaomi",
+                                interest_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemInterestAmount(
+                                    value="value",
+                                    currency="INR",
+                                ),
+                                downpayment_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemDownpaymentAmount(
+                                    value="value",
+                                    currency="INR",
+                                ),
+                                after_downpayment_reduced_product_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemAfterDownpaymentReducedProductAmount(
+                                    value="value",
+                                    currency="INR",
+                                ),
+                                interest_rate="interest_rate",
+                                bundle_id="BUNDLE_002_OE3",
+                            )
+                        ],
+                        auth_amount=OfferValidationRequestOfferDataOfferDetailsTenureAuthAmount(
+                            value="value",
+                            currency="INR",
+                        ),
+                        loan_amount=OfferValidationRequestOfferDataOfferDetailsTenureLoanAmount(
+                            value="value",
+                            currency="INR",
+                        ),
+                        net_payment_amount=OfferValidationRequestOfferDataOfferDetailsTenureNetPaymentAmount(
+                            value="value",
+                            currency="INR",
+                        ),
+                        monthly_emi_amount=OfferValidationRequestOfferDataOfferDetailsTenureMonthlyEmiAmount(
+                            value="value",
+                            currency="INR",
+                        ),
+                        total_emi_amount=OfferValidationRequestOfferDataOfferDetailsTenureTotalEmiAmount(
+                            value="value",
+                            currency="INR",
+                        ),
+                        interest_amount=OfferValidationRequestOfferDataOfferDetailsTenureInterestAmount(
+                            value="value",
+                            currency="INR",
+                        ),
+                        interest_rate_percentage=16.0,
+                        emi_type="STANDARD",
+                        split_emi_display_name="Apple Live",
+                        downpayment_details=OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetails(
+                            downpayment_amount=OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetailsDownpaymentAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                        ),
+                    ),
+                ),
+            ),
+        )
+        """
+        _response = self._raw_client.offer_validation_create(
+            payment_method=payment_method,
+            order_amount=order_amount,
+            payment_amount=payment_amount,
+            payment_option=payment_option,
+            offer_data=offer_data,
+            accept_encoding=accept_encoding,
+            customer_details=customer_details,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        None
+
+        Examples
+        --------
+        from pinelabs import ImeiProduct, PinelabsApi
+
+        client = PinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+        client.affordability_suite.create_imei_validation(
+            order_id="v1-5757575757-aa-hU1rUd",
+            merchant_product_imei_reference="merchant-ref-786",
+            request_type="BLOCKING",
+            products=[ImeiProduct()],
+        )
+        """
+        _response = self._raw_client.create_imei_validation(
+            order_id,
+            merchant_product_imei_reference=merchant_product_imei_reference,
+            request_type=request_type,
+            products=products,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncAffordabilitySuiteClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAffordabilitySuiteClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAffordabilitySuiteClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAffordabilitySuiteClient
+        """
+        return self._raw_client
+
+    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,
+    ) -> 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
+        -------
+        OfferDiscoveryResponse
+            200
+
+        Examples
+        --------
+        import asyncio
+
+        from pinelabs import AsyncPinelabsApi
+        from pinelabs.affordability_suite import (
+            OfferDiscoveryRequestIssuer,
+            OfferDiscoveryRequestOrderAmount,
+        )
+
+        client = AsyncPinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.affordability_suite.create_offer_discovery(
+                order_amount=OfferDiscoveryRequestOrderAmount(
+                    value=1200000,
+                    currency="INR",
+                ),
+                issuer=OfferDiscoveryRequestIssuer(
+                    bin="60100000",
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_offer_discovery(
+            order_amount=order_amount,
+            accept_encoding=accept_encoding,
+            product_details=product_details,
+            cart_coupon_discount_amount=cart_coupon_discount_amount,
+            issuer=issuer,
+            downpayment_details=downpayment_details,
+            payment_options=payment_options,
+            customer_details=customer_details,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        OfferDiscoveryResponse
+            Cardless offers discovered successfully.
+
+        Examples
+        --------
+        import asyncio
+
+        from pinelabs import Amount, AsyncPinelabsApi
+        from pinelabs.affordability_suite import (
+            OfferDiscoveryCardlessRequestPaymentOption,
+            OfferDiscoveryCardlessRequestPaymentOptionCardlessDetails,
+        )
+
+        client = AsyncPinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.affordability_suite.create_cardless_offer_discovery(
+                order_amount=Amount(
+                    value=50000,
+                    currency="INR",
+                ),
+                payment_option=OfferDiscoveryCardlessRequestPaymentOption(
+                    cardless_details=OfferDiscoveryCardlessRequestPaymentOptionCardlessDetails(
+                        pan_number="234A123883",
+                        registered_mobile_number="9876543210",
+                    ),
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_cardless_offer_discovery(
+            order_amount=order_amount,
+            payment_option=payment_option,
+            product_details=product_details,
+            cart_coupon_discount_amount=cart_coupon_discount_amount,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        DownpaymentDetailsResponse
+            Down payment details retrieved successfully.
+
+        Examples
+        --------
+        import asyncio
+
+        from pinelabs import Amount, AsyncPinelabsApi
+
+        client = AsyncPinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.affordability_suite.create_down_payment_details(
+                order_amount=Amount(
+                    value=50000,
+                    currency="INR",
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_down_payment_details(
+            order_amount=order_amount,
+            product_details=product_details,
+            cart_coupon_discount_amount=cart_coupon_discount_amount,
+            issuer=issuer,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        OfferValidationResponse
+            200
+
+        Examples
+        --------
+        import asyncio
+
+        from pinelabs import AsyncPinelabsApi
+        from pinelabs.affordability_suite import (
+            OfferValidationRequestOfferData,
+            OfferValidationRequestOfferDataOfferDetails,
+            OfferValidationRequestOfferDataOfferDetailsTenure,
+            OfferValidationRequestOfferDataOfferDetailsTenureAuthAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItem,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemAfterDownpaymentReducedProductAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemDownpaymentAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemInterestAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemProductAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetails,
+            OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetailsDownpaymentAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureInterestAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureLoanAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureMonthlyEmiAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureNetPaymentAmount,
+            OfferValidationRequestOfferDataOfferDetailsTenureTotalEmiAmount,
+            OfferValidationRequestOrderAmount,
+            OfferValidationRequestPaymentAmount,
+            OfferValidationRequestPaymentOption,
+            OfferValidationRequestPaymentOptionCardDetails,
+        )
+
+        client = AsyncPinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.affordability_suite.offer_validation_create(
+                payment_method="CREDIT_EMI",
+                order_amount=OfferValidationRequestOrderAmount(
+                    value="value",
+                    currency="INR",
+                ),
+                payment_amount=OfferValidationRequestPaymentAmount(
+                    value="value",
+                    currency="INR",
+                ),
+                payment_option=OfferValidationRequestPaymentOption(
+                    card_details=OfferValidationRequestPaymentOptionCardDetails(
+                        card_number="4000000040001000",
+                        registered_mobile_number="9914152866",
+                    ),
+                ),
+                offer_data=OfferValidationRequestOfferData(
+                    offer_details=OfferValidationRequestOfferDataOfferDetails(
+                        id="6",
+                        name="HDFC CC",
+                        display_name="HDFC BANK",
+                        issuer_type="CC_BANK",
+                        priority="priority",
+                        tenure=OfferValidationRequestOfferDataOfferDetailsTenure(
+                            tenure_id="6",
+                            name="24 Months",
+                            tenure_type="MONTH",
+                            tenure_value=24,
+                            issuer_offer_parameters="issuer_offer_parameters",
+                            details=[
+                                OfferValidationRequestOfferDataOfferDetailsTenureDetailsItem(
+                                    product_code="xyz",
+                                    product_display_name="Redmi Note 13 5G",
+                                    product_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemProductAmount(
+                                        value="value",
+                                        currency="INR",
+                                    ),
+                                    brand_name="Xiaomi",
+                                    interest_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemInterestAmount(
+                                        value="value",
+                                        currency="INR",
+                                    ),
+                                    downpayment_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemDownpaymentAmount(
+                                        value="value",
+                                        currency="INR",
+                                    ),
+                                    after_downpayment_reduced_product_amount=OfferValidationRequestOfferDataOfferDetailsTenureDetailsItemAfterDownpaymentReducedProductAmount(
+                                        value="value",
+                                        currency="INR",
+                                    ),
+                                    interest_rate="interest_rate",
+                                    bundle_id="BUNDLE_002_OE3",
+                                )
+                            ],
+                            auth_amount=OfferValidationRequestOfferDataOfferDetailsTenureAuthAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                            loan_amount=OfferValidationRequestOfferDataOfferDetailsTenureLoanAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                            net_payment_amount=OfferValidationRequestOfferDataOfferDetailsTenureNetPaymentAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                            monthly_emi_amount=OfferValidationRequestOfferDataOfferDetailsTenureMonthlyEmiAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                            total_emi_amount=OfferValidationRequestOfferDataOfferDetailsTenureTotalEmiAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                            interest_amount=OfferValidationRequestOfferDataOfferDetailsTenureInterestAmount(
+                                value="value",
+                                currency="INR",
+                            ),
+                            interest_rate_percentage=16.0,
+                            emi_type="STANDARD",
+                            split_emi_display_name="Apple Live",
+                            downpayment_details=OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetails(
+                                downpayment_amount=OfferValidationRequestOfferDataOfferDetailsTenureDownpaymentDetailsDownpaymentAmount(
+                                    value="value",
+                                    currency="INR",
+                                ),
+                            ),
+                        ),
+                    ),
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.offer_validation_create(
+            payment_method=payment_method,
+            order_amount=order_amount,
+            payment_amount=payment_amount,
+            payment_option=payment_option,
+            offer_data=offer_data,
+            accept_encoding=accept_encoding,
+            customer_details=customer_details,
+            request_options=request_options,
+        )
+        return _response.data
+
+    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,
+    ) -> 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
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from pinelabs import AsyncPinelabsApi, ImeiProduct
+
+        client = AsyncPinelabsApi(
+            request_timestamp="YOUR_REQUEST_TIMESTAMP",
+            request_id="YOUR_REQUEST_ID",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.affordability_suite.create_imei_validation(
+                order_id="v1-5757575757-aa-hU1rUd",
+                merchant_product_imei_reference="merchant-ref-786",
+                request_type="BLOCKING",
+                products=[ImeiProduct()],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_imei_validation(
+            order_id,
+            merchant_product_imei_reference=merchant_product_imei_reference,
+            request_type=request_type,
+            products=products,
+            request_options=request_options,
+        )
+        return _response.data