What is the App Platform?
The App Platform lets any ecommerce provider build a first-class integration with Vambe — products, orders, abandoned checkouts, fulfillment and live assistant tools — without Vambe writing any code for you. You register an app, implement a small, well-defined contract, and Vambe handles the rest. It works in two directions:Inbound — you push to Vambe
Your platform sends canonical webhooks (orders, checkouts, fulfillment, products)
to Vambe. Vambe ingests them into the same pipeline used by native integrations.
Outbound — Vambe calls you
When the AI assistant needs live data (order status, stock, a checkout link),
Vambe calls URLs you declared, authenticated with the merchant’s OAuth token.
Core model
There are two distinct concepts:| Concept | What it is | Who owns it |
|---|---|---|
| App | The integration definition you register once: metadata, OAuth config, and which capabilities you support. | You (the provider) |
| Installation | A single merchant connecting their store to your app via OAuth. Each installation holds that merchant’s access token. | A Vambe account (the merchant) |
How a provider integrates — end to end
Register your app
Create the app with your metadata, contact details, OAuth endpoints, and the
capabilities you support. You receive a signing secret (shown once).
Test on your own account
While unapproved, your app is visible only to the account that created it. Install it
on your own store and exercise the full flow.
Submit for review
Submit the app. The Vambe team is notified and reviews it. Once approved, the app
becomes available to every Vambe account.
Merchants connect via OAuth
A merchant clicks Connect in Vambe and is redirected to your site to approve
permissions. Vambe exchanges the code for an access token and stores the installation.
App lifecycle
An app moves through these states:| State | Visible to | Meaning |
|---|---|---|
draft | Creator only | Being built/edited. |
pending_review | Creator only | Submitted; awaiting Vambe approval. |
approved | All accounts | Live and installable by any merchant. |
rejected | Creator only | Needs changes; edit and resubmit. |
suspended | Nobody | Disabled by Vambe; stops receiving events and outbound calls. |
The connection between a merchant and your app is always OAuth 2.0. Merchants never
type API keys into Vambe — they approve scopes on your own page.
Next steps
Create your app
Register the app and get your signing secret.
OAuth connection
Implement the merchant connection flow.
Inbound webhooks
Push orders, checkouts, fulfillment and products.
Outbound capabilities
Answer the assistant’s live data requests.