Frequently Asked Questions
Do I need an app to work with the API?
Yes. Applications are a way for your code to connect to the store via the Ecwid API Platform.
Applications can be used for public use in the Ecwid App Market as well as for custom improvements for specific Ecwid stores. If you register an app, it will not become visible to other Ecwid users automatically.
Can I get a sandbox store for testing?
Yes, you can start working on your application in a test store.
Can I develop the app in a local environment?
While your app is not added to any real store, you can use your dev environment to develop and test the app before release. To continue to improve and debug the app after it is released to Ecwid users, we recommend registering a separate app for this.
How do I update my application settings?
Please contact us and provide the parameters that you wish to update. We will update your application and let you know once it’s done.
My app is ready. What do I do next?
Great! There are a few simple steps to get your app approved and published. Please check the page below for the details.
How do I get paid?
There are two billing schemes available: Ecwid billing and your own custom billing scheme. So the payouts depend on the billing scheme you choose for your app.
If you are using Ecwid Billing for your app, we will pay out the 80% quarterly via PayPal or another agreed upon method. Alternatively, if you use custom billing scheme, you can accept payments directly from the customers we refer. Ecwid billing is not available for payment integrations at the moment.
In exchange for inclusion in Ecwid’s app market, we expect our partners to supply Ecwid with monthly reports and quarterly payments of the revenue share (20% to Ecwid) for any paid apps, per the terms and conditions.
What are the terms and conditions?
If you have an application registered with Ecwid, you are entitled to 80% of any revenues. We track all interactions between customers and apps, and expect our partners to contribute 20% of app revenues monthly to Ecwid. Read the complete terms and conditions.
How should I handle free Ecwid users?
Ecwid has over 1 million users, and many of these users are on our free plan, which does not provide them access to the API and, therefore, any apps built with it. If your app is paid, we can work with you to give a
We will make sure they are aware of the plan they need when they are scouring apps and will showcase the benefits of being able to utilize these
Is there a limit on the number of API calls my application can make?
We constantly monitor API activity and servers load on our side to make sure every application uses API properly. Applications abusing Ecwid REST API will get blocked automatically. Learn more on how to avoid getting blocked: https://developers.ecwid.com/api-documentation/rest-api-reference#usage-policy
How should I provide support?
If our joint customer is having difficulties installing or using an app, they can contact Ecwid Support or use Live Chat in their control panel (for premium plans) and we will be happy to assist. However, please do have your support team ready for any possible issues specific to your application functionality, billing or user interface.
Will Ecwid help me with marketing my app?
Due to the fact that there are multiple apps in the App Market, and we want to treat everyone as equally as possible, we cannot commit to any specific marketing programs on an individual app basis. However, we’ll be announcing all new apps via social media and the blog posts about new apps in the Ecwid Blog.
Additionally, we welcome our developers to create unique, thought leadership posts for our blog, which we will be happy to post on your behalf and make sure the final
How will the new design of the Ecwid storefront affect my solution?
If your custom solution does not add custom JS and / or CSS to storefront, you don’t need to make any changes. If it does — continue reading below.
We have introduced a completely new design and layout for the Ecwid storefronts in 2018. It improved all main parts of storefronts: category pages, product details pages, cart page, checkout process, etc.
These changes are enabled for new Ecwid stores by default right away. The existing merchants can enable them in the Ecwid Control Panel settings when they are ready to migrate.
How check the storefront version
As a developer, you can find out whether a store has these new page designs enabled or not:
This new design changes pretty much everything about the storefront: layout, texts, behaviour, HTML, CSS — everything. We did our best to keep the backwards compatibility for existing solutions. If you already have a code that changes storefront, please make sure and check that it works well with the new design too.
When developing an app or a custom solution, keep in mind that merchants can enable these new features in the settings in the future — it needs to be ready for them.
How to check if a customer agreed to receive promotional emails?
Store customers can be asked to receive email marketing at checkout with a native checkbox field. Get their response in order or customer details.
If it is true or not present, you can use customer email for marketing purposes. If it is false — you can’t use details of that customer for email promotions.
In Ecwid Control Panel
— For order details → Additional information block
— For customers list → check the Email marketing column.
Merchants can customize this checkbox in: Ecwid Control Panel → Settings → General → Cart & Checkout → Newsletters. These settings are also available in the Ecwid REST API.
If you recorded customer emails before
It is likely you already have a flow for customers to accept promotional emails already.
Thus you can continue using the emails of customers who already agreed to receive them. In Ecwid, those old customers and orders will not have any recorded value for acceptMarketing checkbox.
However, for new orders and customers, your app or custom solution must use the data from Ecwid. Make sure to avoid sending emails to customers who explicitly disagreed to receive emails (“acceptMarketing” = false).
If you already use your own checkbox at checkout or elsewhere
The main goal is to use the new acceptMarketing field provided in customer and order details in Ecwid REST API.
This field will be recorded for customer and order only if the Request customer approval for your marketing emails at checkout setting is enabled.
So your solution needs to make sure that:
- Request customer approval for your marketing emails at checkout setting is enabled
- Your custom checkbox hides native one at checkout, but records the checked state there too
- Or the native checkbox is displayed and you track customers’ approval with Ecwid JS API
Have a question we didn’t answer?
Head over to the contact page to find more resources and contact information if you still are looking for answers to your questions.