Developer docs

Build on Mercentia.

Guides for the API, CLI, headless storefronts, and the integrations that ship with Mercentia. Start with the basics, then go as deep as you need.

Getting started

Authenticate with the Mercentia API and run your first request.

Read →

Agentic commerce, explained

What agentic commerce is, why product discovery is moving into AI assistants, and what it means for merchants in 2026.

Read →

ACP, UCP, AP2 & MCP — the protocol stack

A plain-English guide to the four open protocols that make an online store discoverable and buyable by any AI shopping agent.

Read →

Getting found by AI shoppers (GEO)

Generative Engine Optimization — how to make your product catalogue legible, complete, and citable to AI shopping assistants like ChatGPT and Perplexity.

Read →

Developer hub

The in-dashboard surface for API keys, webhooks, apps, and the CLI.

Read →

Mercentia CLI

Scaffold storefronts, run migrations, and manage tenants from your terminal.

Read →

Headless storefront starter

A Next.js 14 + App Router starter that talks to the Mercentia gateway.

Read →

App marketplace

Third-party developers submit apps; platform admins review and publish.

Read →

Architecture overview — for new developers

A 15-minute tour of the Mercentia codebase. Read this first when you join the team or start a contract — every other doc page makes more sense after this one.

Read →

Channel sync architecture

How Mercentia fans product writes out to every connected external channel (Amazon, eBay, Meta Commerce, TikTok Shop, Google Merchant Center) using one shared enqueue pattern.

Read →

Payment methods catalog

Every payment method Mercentia supports, which provider serves each one, and the (country × currency) eligibility matrix that gates them.

Read →

Express checkout

One-tap purchase for returning customers via a saved Stripe payment method.

Read →

Wallet express checkout (Apple Pay / Google Pay / Link)

One-tap PaymentRequest-API checkout from PDP, cart, and standard checkout — the Shop Pay-class flow with inline 3DS.

Read →

Server-side GA4

Send the full 12-event ecommerce schema to Google Analytics 4 from the gateway.

Read →

Meta Commerce (Instagram + Facebook)

Publish products to Instagram Shop and Facebook Shop via the Meta Commerce Catalog API.

Read →

Amazon Seller Central integration

Live SP-API integration for Mercentia — Listings Items v2021-08-01 for product sync, Orders v0 for order import, LWA refresh handled automatically.

Read →

eBay channel

List Mercentia products on eBay and sync inventory with the eBay Sell API.

Read →

Loyalty programme

Mercentia's built-in loyalty engine — programme config, earn rules, VIP tiers, analytics, member ledger, and manual point adjustments.

Read →

Magento 2 migration

Import products, customers, orders, and content from a Magento 2 store.

Read →

Wix migration

Import a Wix Stores catalogue, collections, and orders into Mercentia.

Read →