Overview
What the Deliver API sells, how it works and how to get access.
The Deliver API lets a reseller's own system buy from NovaCodes and pay from a NovaCodes balance. You send one request, the price is taken from your balance, and what you bought comes back in the response.
https://api.novacodes.app/v1
What it sells
Two product families. They share your keys, your balances and the error format, and nothing else: each has its own endpoints, its own order list and its own pages in these docs.
| Family | What you buy | What comes back | Endpoints |
|---|---|---|---|
| Gift cards & software | Gift cards, game codes and software keys, from stock. | Codes: a code, sometimes with a PIN, or a link. | /products, /orders |
| eSIMs | Travel data eSIMs for a country, a region or the whole world. | Install details: the activation text, a QR code and an install link. | /esim/… |
Read the Getting started pages, then only the pages of the family you sell.
How it works
- Hold a balance. Every account has an MVR, a USD and a USDT balance. Add to them from your dashboard: MVR and USD by bank transfer, USDT on-chain.
- Ask what is on sale.
GET /productsfor gift cards and software,GET /esim/destinationsfor eSIMs. Both answer at your wholesale prices. - Order with your own reference.
POST /ordersorPOST /esim/orders, naming the balance to charge. The codes, or the eSIM install details, are in the response.
Rules that hold for both families
| Rule | What it means for you |
|---|---|
| Safe to retry | Every order carries your own reference. Sending the same reference again returns the first order and never charges twice. A reference is one order, whatever it bought: it cannot be used again in the other family. |
| Three balances, never mixed | You choose the MVR, USD or USDT balance per order (or set a default on your key), and pay that currency’s price. Nothing is converted. USDT prices are a little lower than USD prices. |
| Never a manual queue | An API order never waits for a person to deliver it. Units that cannot be delivered are refunded to the balance that paid, automatically. |
| Prices are private | Wholesale prices are only visible when you are signed in, and through the API with your key. These docs never show them. |
| Amounts are minor units | Whole numbers of laari or cents: see Balances & amounts. |
Getting access
The API is for wholesale accounts. Apply for wholesale from your account; once our team approves it, create an API key under Account → API. One key works for both families.
Getting started
- Quick startFrom a new key to your first code or your first eSIM in five minutes.
- AuthenticationAPI keys, IP allowlists and rate limits.
- Balances & amountsTwo balances, minor units, topping up.
- ErrorsEvery error code, the product family it belongs to and what to do about it.
Choose your product family
Gift cards & software
For resellers of gift cards, game codes and software keys.
- Products · What you can order right now, at your prices.
- Orders · Place an order, read the codes, retry safely.
- Code examples · curl, PHP, Node.js and Python.
eSIMs
For resellers of travel eSIMs.
- Overview · What you receive, the kinds of plan and the life of an eSIM.
- Destinations & plans · What is on sale, at your prices, and how a daily plan is priced.
- Orders · Place an order, wait for it, read the install details, show the QR.
- Manage an eSIM · Status and data used, top-ups, and cancelling for a refund.
- Code examples · curl, PHP, Node.js and Python.