Introduction

The Noju Merchants API is a programmatic interface for partners to start, verify, and inspect mobile-carrier subscriptions on Noju's DCB platform. It exposes the same subscription lifecycle Noju operates internally, scoped to your merchant account and the services we have provisioned for you.

The API is intentionally small. It covers the three operations a partner integration needs: kick off a subscription, confirm the user's OTP, and read back the current state of any subscription you own. There are no batch endpoints, webhooks, or polling consoles to learn — just three POST calls returning the same JSON envelope.

All requests are JSON over HTTPS, authenticated with a per-environment API key, and must originate from an IP address you have registered with Noju.

Endpoints

• POST /subscriptions/init — start a subscription flow for an MSISDN; receive a verification reference or carrier-channel instructions.
• POST /subscriptions/verify — submit the OTP returned to the subscriber to activate the subscription.
• POST /subscriptions/status — fetch the current lifecycle state of a subscription by ID.

Every endpoint is POST and accepts a JSON body. See Conventions for the response envelope, and Authentication for credentials and IP allowlisting.