Signing up — the Ewity Developer Portal

Access to the Platform API is self-serve through the Ewity Developer
Portal at developers.ewity.com. Signing up
is free, and everything you previously had to email us for — API keys,
webhook URLs, the Connect URL, sandbox access — is managed there yourself.

1. Create an application

Sign in and click New application. An application is your integration on
Ewity: give it a name, a short description merchants will see, and pick the
business types it serves (Restaurants, Retail, or both).

Creating the application immediately gives you:

• An API key (plt_…) — on the Credentials tab. This is the bearer
  token for every platform-v1 call, and the same token Ewity sends back to
  you on webhooks and Connect calls. You can reveal, copy, and rotate it
  there.
• A sandbox business — provisioning starts automatically (see below).

2. Test against your sandbox

Every application gets its own sandbox company on Ewity — a real,
isolated merchant account seeded with test data, so you can build end-to-end
without touching a live business. Provisioning runs in the background and
takes about a minute after you create the application.

The Overview → Sandbox card shows everything you need once it's ready:

The sandbox is seeded to match your business types: a restaurant menu with
modifiers for restaurant apps, a grocery catalogue for retail apps, or both.

3. Configure your URLs

The Configuration tab is where you set the URLs that used to require an
email to us. Changes apply immediately — no provisioning step:

• Webhook URL — order and store events. See Webhooks.
• Inventory webhook URL (optional) — CatalogueUpdated events.
• Connect URL — the single endpoint for the merchant linking flow. See
  Implementing the Connect Flow.

Your app's logo and merchant-facing description live here too.

4. Work as a team

On the Team tab you can invite other developers by email. Roles:
owner (everything), admin (manage configuration, credentials, and
team), developer (read access to the app and its credentials).

5. Install into real businesses

While your application is in the sandbox stage, you can install it privately
into real merchant accounts from the Businesses tab. During the beta this
is a manual whitelist — enter the merchant's Ewity company name (the name
the business logs in with), for up to 10 businesses. Whitelisted businesses
see your platform in their POS under Ecommerce → Platforms and enable it
themselves via the Connect flow.

6. Go live

When you're ready for every Ewity merchant to find you, complete the
checklist on the Go live tab (logo, description, developer contact,
webhooks, at least one linked business) and submit. The Ewity team reviews
the request; once approved, your platform is listed in the Ecommerce →
Platforms directory of every merchant that matches your business types —
no whitelist needed.

Stuck? For anything the portal doesn't cover — non-Maldives merchants,
HMAC signing, feature requests — email [email protected].