> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://docs.downpay.app/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Using Downpay with product options apps Using a product options app with Downpay requires some specific setup to make sure deposits apply to the full order, not just the base product. This guide covers what to look for and how to configure it correctly. ###### On this page: [Overview](#1-overview) * [How compatibility works](#2-how-compatibility-works) * [Why some options apps are not compatible](#2-why-some-options-apps-are-not-compatible) [Setting up Downpay with a product options app](#1-setting-up-downpay-with-a-product-options-app) * [If options do not affect price](#2-if-options-do-not-affect-price) * [If options affect price](#2-if-options-affect-price) [Compatible apps and setup guides](#1-compatible-apps-and-setup-guides) * [APO Product Options, Variants](#2-apo-product-options-variants) * [DPO Dynamic Product Options](#2-dpo-dynamic-product-options) * [Easify Product Options](#2-easify-product-options) * [Easyflow Product Options](#2-easyflow-product-options) * [Globo Product Options](#2-globo-product-options) * [Infinite Product Options](#2-infinite-product-options) * [Live Product Options](#2-lpo-live-product-options) * [Zepto Product Customization](#2-zepto-product-customization) * [Other apps](#2-other-apps) --- --- # Overview Many Shopify merchants use a product options app to let customers configure a product before buying. For example, a furniture brand might offer fabric, leg finish, and custom sizing as paid add-ons. When a deposit is involved, that deposit should apply to the full cart total including those options. Downpay is compatible with many product options apps, but not all. Whether an app works with Downpay depends on how it adds options and extra fees to the cart under the hood. ## How compatibility works For Downpay to apply a deposit to a product option or add-on, two things must be true: 1. **The option must exist as a real product or variant in Shopify.** Downpay works by assigning products and variants to a purchase option. If an add-on fee is not tied to a real Shopify product or variant, Downpay has no way to include it in the deposit calculation. 2. **The selling plan must carry through to the cart.** When a customer selects a deposit, Downpay attaches a `selling_plan` to the cart request. If the product options app has its own add to cart flow that does not pass the `selling_plan` through, the deposit will not apply and troubleshooting might be required. [Learn more about how to fix with this issue.](https://docs.downpay.app/en/article/deposit-not-applied-at-checkout-17jm0hy/) ## Why some options apps are not compatible There are three main reasons a product options app may not work with Downpay: **Cart Transform API** Some apps use Shopify's newer Cart Transform API to apply add-ons and fees. Shopify's Cart Transform system does not currently support selling plans, which means Downpay cannot attach a deposit when this method is in use. Some apps offer a setting to disable Cart Transform, which restores compatibility. [View Shopify compatibility documentation](https://shopify.dev/docs/api/functions/latest/cart-transform). **Draft orders** Some apps use Shopify's draft orders API to add options to the cart and charge extra fees at checkout. As covered in our [deposits and draft orders guide](https://docs.downpay.app/en/article/deposits-not-available-in-draft-orders-or-create-order-workflow-1gf0frm/), Shopify draft orders do not support selling plans. If an app relies on draft orders, it will not be compatible with Downpay. **Custom add to cart flows** Some apps override Shopify's default add to cart behaviour with their own code. When this happens, the `selling_plan` that Downpay injects into the product form does not get included in the cart request. The result is that the product is added to the cart without a deposit attached. [Learn more about how to fix with this issue.](https://docs.downpay.app/en/article/deposit-not-applied-at-checkout-17jm0hy/) --- --- [Jump to top](#6-on-this-page) # Setting up Downpay with a product options app ## If options do not affect price If the options your customers select do not add any extra fees to the order, no special setup is needed and most apps work just fine. Downpay will calculate the deposit correctly based on the product price alone. ## If options affect price If your options add extra fees to the cart and you want the deposit to apply to the full total including those fees, follow these steps. | [Read the in-depth step-by-step guide.](https://docs.downpay.app/en/article/deposit-is-not-applying-to-product-option-add-ons-19sya19/) 1. Set up your options inside your chosen product options app 2. Make sure each paid option is tied to a real product or variant in Shopify 3. In Downpay, open the relevant purchase option and add the main product along with all option products or variants to the same purchase option 4. Set your deposit as a **percentage** rather than a fixed amount. Downpay can only calculate partial payment across a main product and its add-ons using percentage-based deposits. 5. Make sure your store directs customers to the full cart page before checkout. Downpay needs to see the complete cart total before the deposit amount can be calculated correctly. 6. Test by adding the main product and one or more paid options, then navigate to the cart page and confirm the deposit calculation reflects the full subtotal. --- --- [Jump to top](#6-on-this-page) # Compatible apps and setup guides These are the product options apps we have tested and confirmed work with Downpay. For apps not listed here, see [our full compatibility list](https://getdownpay.com/shopify-downpay-app-compatibility-list/). ## APO Product Options, Variants [APO Product Options, Variants](https://apps.shopify.com/advanced-product-options) when options are configured appropriately. ||| **Required:** For any option where Downpay should apply a deposit, don't use APO's native *Price Adjustment* field. Instead use *Add-on product* and link to the Shopify variant directly. Steps: 1. Set up options as products and variants in Shopify following the [general instructions](#2-if-options-affect-price). 2. Enable the [APO theme block](https://mageworx.notion.site/Installing-the-app-5d0deb0511964e40a0c92d1d67c8aacc). 3. Create [option sets](https://mageworx.notion.site/Quick-start-guide-e8b34647abd6425b92e785a40a5d15a1). * For options where Downpay should apply a deposit, click on **Add-on product** and search for the appropriate product/variant. * If you don't do that, setting the **Price adjustment** is invisible to Downpay and will not be included in deposit calculations. --- [Jump to top](#6-on-this-page) ## DPO Dynamic Product Options [DPO Dynamic Product Options](https://apps.shopify.com/dynamic-product-options) is compatible with Downpay with one required setting change. ||| **Required:** In general settings, set "Cart Price Handler" to "Generic Variants" instead of `Default` or `Cart API` before using Downpay. || This app creates variants on the fly by default, so it's not necessary to create options as products/variants, although it is [also supported](https://www.itoris.com/shopify-custom-options-userguide.html#2.7.%20Product%20Associated%20Options). Steps: 1. If you want to use products and variants in Shopify as options, follow the [general instructions](#2-if-options-affect-price). [Optional] * Otherwise, you will be able to set up options within the app. 2. In general settings, set "Cart Price Handler" to "Generic Variants" . 3. Ensure **App enabled on storefront** is set to `yes`. 4. Create your [options](https://www.itoris.com/shopify-custom-options-userguide.html#2.3.4.%20Options%20Configuration) in DPO and associate them with your base products. 5. Add option values and prices directly * If you created products and variants as options, associate them with DPO options by [clicking **+Link**](https://www.itoris.com/shopify-custom-options-userguide.html#2.7.%20Product%20Associated%20Options). --- [Jump to top](#6-on-this-page) ## Easify Product Options [Easify Product Options](https://apps.shopify.com/easify-product-options) is compatible with Downpay when options are configured appropriately. ||| **Required:** For any option sets where Downpay should apply a deposit, enable "Separate main & add-on products in cart". Steps: 1. Set up options as products and variants in Shopify following the [general instructions](#2-if-options-affect-price). 2. Enable the Easify [theme block or app embed](https://easifyapps.com/docs/app-activation/) on your product page. 3. Create your [option sets](https://easifyapps.com/docs/create-a-new-option-set-from-scratch/) in Easify. * For options where Downpay should apply a deposit, link the products/variants you created and enable [Separate main & add-on products in cart](https://easifyapps.com/docs/separate-or-combine-add-ons-with-main-product-in-cart/) under Advanced. * If you don't do that, setting the price is invisible to Downpay and will not be included in deposit calculations. --- [Jump to top](#6-on-this-page) ## Easyflow Product Options [Easyflow Product Options](https://apps.shopify.com/product-options-4) is compatible with Downpay when options are configured appropriately. ||| **Required:** For any option where Downpay should apply a deposit, don't use Easyflow's native *Add-on price* field. Instead use *Add-on product* and link to the Shopify product or variant directly. Steps: 1. Set up options as products and variants in Shopify following the [general instructions](#2-if-options-affect-price). 2. Enable the Easyflow [theme block or app embed](https://easy-flow.app/docs/how-to-show-options-on-storefront/) on your product page. 3. Create your [option groups](https://easy-flow.app/docs/option-set-for-products-easyflow/) and [options](https://easy-flow.app/docs/how-to-set-up-options-for-products/) in Easyflow. * For options where Downpay should apply a deposit, link the products/variants you created using the [Add-on product feature](https://easy-flow.app/docs/how-to-create-price-add-ons/#2-toc-title). * If you don't do that, setting the **Add-on price** is invisible to Downpay and will not be included in deposit calculations. --- [Jump to top](#6-on-this-page) ## Globo Product Options [Globo Product Options](https://apps.shopify.com/product-options-pro) is compatible with Downpay when options are configured appropriately. ||| **Required:** In *Add-on price* settings, disable *Merge main product & Add-on products*. Steps: 1. Set up options as products and variants in Shopify following the [general instructions](#2-if-options-affect-price). 2. Enable the Globo [app embed](https://docs.globo.io/options) on your product page. 3. Navigate to the Add-on-price section of Globo Product Options settings and disable Merge main product & Add-on products * If you don't do that, setting the Add-on price is invisible to Downpay and will not be included in deposit calculations. 4. Create your option sets in Globo. 5. Apply the option sets to products in Globo. --- [Jump to top](#6-on-this-page) ## Infinite Product Options [Infinite Product Options](https://apps.shopify.com/custom-options) is compatible with Downpay with one required setting change. ||| **Required:** Native Bundling must be disabled in the app settings before using Downpay. 1. Set up options as products following the [general instructions](#2-if-options-affect-price). 2. Enable the Infinite [theme block](https://shoppad.gitbook.io/infinite-options/welcome/how-to-install) on your product page. 3. In settings, set **Native Bundling** to `DISABLED` 4. Create [option sets](https://shoppad.gitbook.io/infinite-options/managing-your-options), adding the products you created as [product bundles](https://shoppad.gitbook.io/infinite-options/increase-the-cost-of-an-option/product-bundles). --- [Jump to top](#6-on-this-page) ## LPO Live Product Options [LPO Live Product Options](https://apps.shopify.com/live-product-options) is compatible with Downpay when settings and options are configured appropriately. ||| **Required:** Follow the app settings configuration below. For any option where Downpay should apply a deposit, don't use LPO's native *Price* field. Instead use *Add-on product* and link to the Shopify product or variant directly. Steps: 1. Set up options as products and variants in Shopify following the [general instructions](#2-if-options-affect-price). 2. Enable the LPO [theme block or app embed](https://docs.cloudlift.app/article/129-how-can-i-enable-the-options-app-in-the-theme-editor) on your product page. 3. In settings, under **Checkout settings**, enable [checkout extensibility](https://docs.cloudlift.app/article/193-checkout-extensibility). 4. Set the **Price mode** to `Bundle`. 5. Enable **Include add-on product in bundle**. 6. Create [product options](https://docs.cloudlift.app/article/171-intro-product-options), adding the products/variants you created [as additional products](https://docs.cloudlift.app/article/109-how-can-i-add-an-additional-product-for-an-option) with the + icon beside the price field. 7. Ensure **Add main product quantity** is enabled when adding the additional products. --- [Jump to top](#6-on-this-page) ## Zepto Product Personalizer [Zepto Product Personalizer](https://apps.shopify.com/product-personalizer) is compatible with Downpay when settings and options are configured appropriately. ||| **Required:** Set *Additional Pricing type* to *Additional Product*. For any option where Downpay should apply a deposit, don't use Zepto's native *Price Change* feature. Instead use *Link to Variant* and link to the Shopify variant directly. Steps: 1. Set up options as products and variants in Shopify following the [general instructions](#2-if-options-affect-price). 2. Enable the Zepto [theme block](https://productpersonalizer.com/docs/enabling-the-app-in-themes/) on your product page. 3. Open Zepto settings. 4. Under the **Additional Pricing** tab, set **Additional pricing type** to `Additional Product.` 5. Create your [product option sets](https://productpersonalizer.com/docs/). 6. For options where Downpay should apply a deposit, select `Link to Variant` in the **Price / Variant** drop-down and then select the variants you created. * If you don't do that, setting an amount in the **Price Change** field is invisible to Downpay and will not be included in deposit calculations. --- [Jump to top](#6-on-this-page) ## Other apps Don't see your app listed? Check our [full compatibility list](https://getdownpay.com/shopify-downpay-app-compatibility-list/) or [contact our support team](mailto:support@hypehound.io) and we'll be happy to test it with you. --- [Jump to top](#6-on-this-page)