Ecwid Integration — Complete Setup Guide

The Partially app for Ecwid lets you offer payment plans as a payment option at checkout. Customers can choose Partially at checkout and pay over time, while you receive the funds according to your offer terms.

You can see a live example at https://partially-demo-store.company.site/.

Before You Start

You need two things in place in Partially before activating the Ecwid app:

1. A connected Stripe account — Stripe is how Partially processes payments. Go to Settings → Integrations and connect Stripe if you haven't already.
2. An offer — An offer defines the payment plan terms (number of installments, down payment, frequency, etc.) you'll present to customers. Go to Offers → New Offer to create one.

Step 1 — Install the Partially App from the Ecwid App Store

1. Go to the Partially app listing in the Ecwid app marketplace: https://www.ecwid.com/apps/featured/partially
2. Click Get to install the app onto your Ecwid store.

Step 2 — Activate the App in Your Ecwid Dashboard

1. In your Ecwid dashboard, go to Configuration → Payment.
2. Find the Partially app in the payment methods list.
3. Click Actions to open the configuration settings.

You'll need to enter two values:

Your Partially API Key

1. In Partially, go to Settings → General.
2. Copy your API key from that page.
3. Paste it into the API key field in Ecwid.

Your Offer ID

1. In Partially, go to Offers and open the offer you want to use.
2. Inside the offer, open the Integration tool.
3. Copy the Offer ID shown there.
4. Paste it into the Offer ID field in Ecwid.

Disable Test Mode

Make sure the Test Mode toggle is disabled before going live. If Test Mode is on, no real payments will be processed.

Once you've entered your API key and Offer ID and disabled Test Mode, save the configuration. Partially will now appear as a payment option on your Ecwid checkout page.

Step 3 — Test the Checkout

After activating, place a test order on your store to confirm Partially appears at checkout and the payment plan flow works end-to-end.

Per-product offers and cart rules

To apply a minimum purchase amount, or use different offers for different products, use Smart Customization — Partial.ly's rules engine that picks the right offer (or hides Partial.ly) automatically at checkout. It's free, configured in the Partial.ly UI with no code, and works with Ecwid out of the box. See Smart Customization.

Advanced Scripting is deprecated. The older Settings → Advanced Scripting feature is no longer recommended for new setups — use Smart Customization instead. Any existing Advanced Scripting is written in Lua (not JavaScript); leave those legacy scripts in Lua if you're maintaining one, and don't write new ones.

Troubleshooting

Partially not appearing at checkout — Confirm the API key and Offer ID are entered correctly and that Test Mode is off. Also check that the app is enabled (not just installed) under Configuration → Payment.

API key not working — API keys are found under Settings → General in your Partially merchant account. Make sure you're copying the full key without any leading or trailing spaces.

Wrong offer showing — Each Ecwid configuration uses a single Offer ID. If you want to use a different offer, update the Offer ID in the Ecwid app settings. Use Smart Customization if you need multiple offers on the same store.

Questions? Email support@partial.ly.