getting started with ecart api

Welcome to Ecart API

Ecart API is a unified API that lets you work with multiple ecommerce platforms and marketplaces through one integration. You build one integration and your customers connect their stores (Shopify, Wix, Mercado Libre, and more) via Ecart API's authentication flow.

High-level flow

StepWhat you do
1Create an app in your account and set a Redirect URL.
2Let your customers connect their stores using Ecart API's OAuth flow; they are redirected to your URL with an access token and store data.
3Validate the integration (e.g. with the ecartapi_key HMAC) and store the access token linked to your customer.
4Call Ecart API using the store access token as Bearer in the Authorization header. Choose v1 (raw), v2 (unified, recommended), or v3 (centralized) depending on your needs.
5Optional: Customize the integration page (app name, logo, custom domain) for a white-label experience.

Summary: One integration → many ecommerces. All requests use a Bearer store access token. Create an app, connect stores via OAuth, validate and save the token, then call the API.

Next steps

Follow these guides in order:

GuideWhat you'll learn
Create your appMy Apps, New App, app name, Redirect URL
Store authenticationIntegrating a store, validating integrations, redirect URL parameters
OAuth 2.0OAuth URL, customer steps, what you receive in the redirect
Store access tokenWhere to find it, saving it, using it as Bearer
API endpointsAPI versions (v1, v2, v3), base URL, example paths
Set up the integrations pageApp name and logo, custom domain (CNAME), parameters and test URL

For detailed endpoint reference per platform, see the API Reference section.