Register your app

The whole path in the partner portal, from signing in to a published app. You need an approved partner account (Join the partner program) and at least one development store.

Sign in at merchant.numueg.app and go to merchant.numueg.app/partners. If you run a store, you can also click your store's card at the bottom of the sidebar, then Partner program.

Under You're a NUMU partner, choose Your apps.

Create the app

Choose New app and fill in:

Slug: 3 to 41 lowercase letters, digits and dashes, starting with a letter. It never changes, and your manifest must use the same one.

Name in Arabic: written in Arabic. A copy of the English name is refused.

Name in English.

Choose Create app.

Save the client secret

A card says Save your client secret now. Copy the numu_cs_… value and put it in your server's environment, for example as NUMU_CLIENT_SECRET.

NUMU shows it only this once. If you lose it, rotate it: see Rotate the client secret.

Copy the client ID

Choose Open on your app. The Credentials card shows the Client ID, numu_ci_…. Put it in your server's environment too, for example as NUMU_CLIENT_ID.

Upload your manifest

Write numu.app.json: see App manifest. On your app's page, in Upload a version, paste the file or pick it. Add release notes in Arabic and English if you like, then choose Upload.

The version appears under Versions as Draft. If NUMU refuses the file, the reason appears in a red box: fix the file and upload it again. Every upload needs a higher version.

Build your server

Your server needs two endpoints:

the OAuth callback, at a URL in your redirect_urls: see OAuth and app tokens;

the webhook receiver, at your webhook URLs: see App webhooks.

Install it on a development store

Run the real install flow on your development store: see Test on a development store. Then check the whole path: consent, token, API calls, webhooks and uninstall.

The Install on a development store button on your app's page adds the app without a token. It lets you see your settings form in the dashboard, but it does not test your server.

Submit for review

Run the ten checks first. Then choose Submit for review on the draft version. Its status becomes Submitted, then In review.

Read the decision

The version shows Approved: ready to publish, Changes requested or Rejected, with NUMU's notes underneath.

Publish

On the approved version, choose Publish. It becomes Live. Your app's header says Not listed yet until NUMU adds the app to the App Store, then Listed in the App Store.

Rotate the client secret

On your app's page, choose Credentials → Rotate secret and confirm. The new secret is shown once. The old secret stops working at once, so deploy the new one right away. Merchants' tokens keep working.

What merchants see

Once your app is listed, merchants find it under Apps in their dashboard and choose Install. NUMU shows its consent screen, which lists your permissions as plain sentences in Arabic or English. After they approve, your app's page in their dashboard shows its permissions, your settings form, and a button that opens your app.

The same steps with the CLI

Portal	CLI
New app	`numu app create`
Upload a version	`numu app version`
Submit for review	`numu app submit`
Versions and NUMU's notes	`numu app status`
Publish	`numu app publish`

See The numu CLI.

Rotate the client secret#

What merchants see#

The same steps with the CLI#

Rotate the client secret

What merchants see

The same steps with the CLI