Articles on: Integrations

APO Product Options, Variants Integration Setup

Learn how to use APO Product Options, Variants — Advanced Product Options by Mageworx with Downpay. With this integration, you'll be able to offer product customization through APO's option sets while ensuring Downpay correctly applies your purchase options to both the base product and any add-on variants your customers select.

 

 

On this page:

 

Overview of the Integration

Setup and configuration for APO and Downpay

 

 

Overview of the Integration

 

APO (Advanced Product Options by Mageworx) lets you offer rich product customization — like fabric types, engraving, finishes, or add-ons — that go beyond Shopify's native variant limits. When combined with Downpay, customers can place a deposit on both the base product and any selected options at checkout.

 

The key to making this work is that APO's Add-on Product feature is used instead of APO's native price adjustments. This allows Downpay to read each option's price as a separate line item and apply your purchase option to it correctly.

 

Considerations

 

APO's built-in Price Adjustment field is not compatible with Downpay. If you use price adjustments directly in APO, Downpay will not be able to detect or apply a deposit to the added cost. You must use APO's Add-on Product method instead, as described in this guide.

 

 

Jump to top

 

Setup and configuration for APO and Downpay

 

This section guides you through the three-part setup: preparing your products in Shopify, configuring your option sets in APO, and assigning your purchase option in Downpay.

 

Shopify setup

 

The foundation of this integration is having your option values exist as real Shopify product variants. Downpay reads Shopify products and variants natively, so this is what allows it to apply deposits to options that customers select.

 

  1. Create a new product in your Shopify store to act as your options container. For example, a product called Fabric Types, Engraving Options, or Finish Upgrades — one product per option group works well but can get quite messy.
  2. Add each selectable option as a variant of that product. For example, a Fabric Types product might have variants: Linen, Velvet, Cotton Canvas, each priced accordingly.
  3. Set the price of each variant to reflect the add-on cost you want to charge (or include in a deposit).
  4. Set the product status to Unlisted so it does not appear on your storefront. Customers will never browse to this product directly — APO will surface the options through your main product page.

 

You can have multiple option container products (one per option group). Repeat these steps for each group of options you plan to create in APO.

 

 

Jump to top

 

APO Product Options setup

 

Once your option variants exist in Shopify, you'll configure APO to surface them as selectable options on your product pages.

 

Enable the APO theme block

 

  1. In your Shopify admin, go to Online Store → Themes and click Customize on your active theme.
  2. Navigate to a product page template.
  3. Add the APO Product Options app block/embed to your product template and save.

 

If you're unsure how to add an app block to your theme, refer to APO's theme setup documentation.

 

Create a new option set

 

  1. Open the APO app and navigate to Option Sets (or Product Options, depending on your APO version).
  2. Click Create new option set and give it a name.
  3. Assign the option set to the relevant products in your store.

 

Add options using Add-on Product (not Price Adjustment)

 

This is the most important part of the APO setup for Downpay compatibility.

 

  1. Inside your option set, click Add option.
  2. Choose your input type (dropdown, radio buttons, swatches, etc.) and give it a display name — for example, Choose your fabric.
  3. For each option value, do not use the Price Adjustment field built into APO.
  4. Instead, set the value type to Add-on Product and search for the corresponding variant you created in Shopify setup — for example, the Velvet variant from your Fabric Types product.
  5. Repeat for each value in the option.
  6. Save the option set.

 

Do not use APO's native Price Adjustment field for any option where Downpay should apply a deposit. Price adjustments are invisible to Downpay and will not be included in deposit calculations. Always use Add-on Product and link to the Shopify variant directly.

 

 

Jump to top

 

Downpay setup

 

With your base product and option variants set up in Shopify and surfaced through APO, the final step is to make sure Downpay applies your purchase option to all of them.

 

Install Downpay

 

  1. Install Downpay from the Shopify App Store (if you don't already have it).
  2. Follow the in-app onboarding or check out our getting started guide.

 

Enable the Downpay theme block

 

  1. In your Shopify admin, go to Online Store → Themes and click Customize.
  2. Navigate to a product page template.
  3. Add the Downpay app block to your product template and save.

 

The Downpay theme block must be present on the product page for deposit messaging and checkout behavior to work correctly.

 

Assign your purchase option to the base product and all option variants

 

This step ensures that when a customer selects an add-on option, the deposit applies to both the main product and the option they chose.

 

  1. In Downpay, navigate to your purchase options and open the relevant purchase option (or create a new one if needed — see our getting started guide).
  2. In the Products section of your purchase option, add your base product (the product your customers are buying).
  3. Also add each option container product you created in the Shopify setup — for example, your Fabric Types product with all its variants.
  4. Save the purchase option.

 

Both the base product and every option container product must be assigned to the same purchase option in Downpay. If an option variant is not assigned, Downpay will not apply a deposit to that line item when it is added to the cart by APO.

 

 

Once all steps are complete, test the full flow: visit a product page, select an add-on option, and proceed to checkout. You should see Downpay's deposit messaging applied to both the base product line item and the add-on option line item.

 

 

Jump to top

Updated on: 18/03/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!