Articles on: Advanced Setup

Compatible apps

There are thousands of apps in the Shopify app store, all of which have different approaches to solving problems. Sometimes apps do not play well together. In this guide you'll learn about which apps work best with Downpay.



On this page:


All tested apps

Variant and options apps
Compatible options apps
Enable Downpay for products with options

Bundle apps
Compatible bundle apps
Using Cart Bot for addons and fees

Page builders
Compatible page builders
Using page builders with Downpay

Crowdfunding

Troubleshooting incompatible apps



All tested apps



We are constantly testing apps for compatibility and adding them to this page.

Variant and options apps



You can use a product options app to add customization variants and potentially charge extra fees depending on the options that are selected. In this case, you may want to collect a deposit for the core product and all of the options selected. This guide will teach you how to set this up.

Compatible options apps



These are our top 3 recommended options apps that work well with Downpay. There are many more that work, we just find these ones very reliable.

Dynamic Product Options
Infinite Options
SC Product Options fka Bold

Most apps that allow you to assign a product option to variants that already exists in your store will work with Downpay.

Any app using draft orders on the backend to add options to the cart and checkout to charge the extra fees will not work with Downpay at this time.

If you'd like us to run some tests on a particular options app you are using, please contact us and we'd be happy to help!

Enable Downpay for products with options



If variants do not effect price


Downpay will calculate the correct totals if variants do not add extra fees.

If variants effect price


Your store must direct customers to the full cart page prior to checkout If you are using options apps to add extra fees.

Downpay can only support percentage based deposits when calculating partial payment across a main product and it's addons.

To complete setup:

Set up your options in the app you have chosen

Add the main product and all of the variants it has into the same Downpay deposit purchase option

Test adding the main product and a few paid purchase options and navigate to the cart page to view the subtotal calculations.

If you are using a cart side drawer Downpay will be unable to calculate deposits on the add on products.

Bundle apps



Compatible bundles apps



Shopify's new bundle app and technology does not support partial payment yet. Some other bundle apps are compatible with Downpay and some aren't. It's a bit of trial and error and we are constantly testing new ones as they come in and listing them in our app compatibility chart.

Using Cart Bot for addons and fees



Cart Bot is compatible with Downpay and we recommend using it when you'd like to auto add products to the cart and disallow removal.

Example of use cases:
- Selling a product from your store for a 20$ trial and adding a 0$ deposit 100$ security deposit product to the cart in order to be able to charge the customer if they do not return the product.

To complete setup for the above example

Set up Downpay and create a new 0$ deposit purchase option and assign your Security deposit product



Install Cart Bot and click Create a bot and use the Products bot trigger

Add the 20$ trial product in the When a customer's cart includes: box

Add the deposit product in the Then automatically add: box and click Set subscripiton option and choose the Downpay selling plan you've created





Review the settings in Cart bot to make sure the behaviour suits your workflow and save the bot.

The bot will now add the 0$ security deposit to the cart and on Checkout, you will see a due later total of the 200$ that was deferred.



To change the wording on the due later line at checkout and on your email notifications, review
Modify date and content display about deposits on your theme.

Page builders



You can use most page builders with Downpay and it is easier to set up if your page builder is able to export their template into the Shopify theme editor.

Compatible page builders



Some compatible page builders include:

- Gem Pages
- Page Fly
- Zipify
- eComposer

Using page builders with Downpay



To enable page builders with Downpay:

Create your templates in your page builder and publish them. If you are able to publish the template to the Shopify theme editor, do so as well.

Add a liquid block (custom code) to your template where you'd like the Downpay block to appear. Use the identifier downpay for a new class. In this case, we're using GemPages v7, yours might look a little different depending on the page builder app you're using.



Downpay will allow you to place it's block relative to a unique HTML element. By using downpay in step 2 we've created that unique element.

Open the Shopify theme editor and navigate to the embeds section and toggle the Downpay product embed on. If it is missing, please reach out to us and we will add it for you.



Click into the Downpay Product embed and scroll down to HTML element to insert relative to and type in .downpay.



Use Insert position to adjust the position of the Downpay block and click save.

Refresh the page in your browser or preview it in the Shopify theme editor and adjust placement as needed.

Crowdfunding



For merchants looking to run campaigns similar to Kickstarter, we recommend using Crowdfunder with Downpay in order to gauge email and reach goals for your campaigns.




Troubleshooting incompatible apps



There are several reasons why some apps may not work with deposit orders, we're happy to help troubleshoot the cause and help find the right solution.

Deposit amount is not showing up on cart and/or checkout even after Downpay is set up



If Downpay has been set up and works on a product on your store without other apps, the issue may be related to a specific app on your store. This problem is common with some booking and product variant apps.

Selling plan not being attached when adding to cart



Downpay adds a selling plan attribute on the product page which must carry forward to the cart and checkout in order to calculate deposits correctly. To solve this, please reach out to the app developer with this explanation:

Downpay uses a feature of Shopify called Selling Plans. A selling plan can be attached to a product that is added to cart using the standard add.js Shopify API. The selling_plans attribute is a standard, officially supported attribute of the add.js API.

On the product page, this selling plan attribute appears as an input element with name 'sellingplan" and a value attribute. It looks like this: <input name="sellingplan" value="4985618718">



By default on any Shopify theme, when a customer on the site clicks Add to Cart, the product <form> element is automatically serialized by the browser and sent to Shopify so the product can be added to the cart. If the selling plan input element is present in the product form, the product will get properly added to the cart with the selling plan attached.

With Insert app name here_, this contract is broken and the selling plan is not serialized in the cart. This is because the app has its own code that overrides the default browser serialization of the form.

Since selling plans are an officially supported Shopify API, we're hoping that your development team can work to fix this bug. The fix should be as easy as checking if the form includes any input selling plan elements as described above, and then adding that attribute to the /cart/add.js payload as described in the official Shopify docs.

Doing so will not only allow your app to be compatible with Downpay, but also with other apps in the Shopify ecosystem that make use of the Selling Plans APIs. So we're hoping that you'll strongly consider this.

Draft orders issues



If the deposit works on the cart but not checkout, the app in question might be attempting to use the draft orders API to make changes on the checkout page. Draft orders does not support partial payment.

Reach out to the app developer and ask if they have a workflow that does not use draft orders. Alternatively, try a different app in the same category.

Updated on: 18/10/2024

Was this article helpful?

Share your feedback

Cancel

Thank you!