{"info":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","description":"

Integrate airtime, mobile data, cable TV, electricity, betting wallet funding,
recharge-card e-PINs, data e-PINs, Smile, WAEC and JAMB into your application.

Base URL: https://api.nellobytesystems.com/v1

This collection documents the REST routes. Send JSON for POST requests and headers
for authentication. These URLs do not use the legacy .asp?UserID=...&APIKey=...
request format. Purchases and order lookups use the current-status contract below.

Try the sandbox in Postman

Test 30 API operations with ₦100,000 in sandbox funds. The sandbox base URL is https://sandbox-api.nellobytesystems.com/v1.

Open sandbox signup, enter your email address, and select Create account. Follow the link in your email to open your dashboard. Returning users can select Sign in.
Save your sandboxUser and sandboxBearer from the dashboard. Download the sandbox collection and import it into Postman.
In the sandbox collection’s Variables tab, enter both values locally and leave their shared values empty.
Open Start here → Wallet balance and send GET /v1/wallet. A new account shows a balance of ₦100,000. Sandbox purchases use these test funds.

Browse the sandbox API documentation for the full list of requests and examples.

Start here

Import this collection and the accompanying environment into Postman.
\n
Select the Nellobyte REST v1 - Local credentials environment.
\n
Set memberId and apiKey to your member ID and that member's standard API key
in local variable values. Keep shared values empty. Never publish your credentials.
\n
Send Health and then Wallet balance. A wallet response has status: WALLET_SUCCESS, id, balance, currency and an ISO date.
\n
Load the relevant catalogue, select a valid code and fill the destination variables.
Verify the customer first where a verification endpoint exists.
\n
For an intentional purchase, assign a new requestId and send that one order request.
Save its response and query its status using the same request ID or returned order ID.
\n

The base URL is a production service. Purchase requests can debit a funded wallet.
Do not run the whole collection against a funded account. The collection contains no
automatic request chaining, purchase retries or scripts that transmit requests.

Authentication

Every business endpoint requires both headers:

Authorization: Bearer \nX-User-ID: \nAccept: application/json\n\n

Postman's collection-level Bearer Token authorization supplies Authorization.
Each business request includes X-User-ID. Health uses no authentication.
Do not supply UserID or APIKey in the URL or JSON body. Use the member's standard
API key, not an app key or a provider/robot key. Existing account and IP access rules
continue to apply. Keep API keys on a trusted server rather than a public web page.

Request format

POST requests require Content-Type: application/json and a flat JSON object.
Only documented fields are accepted; nested objects, arrays, null values, duplicate
fields and unknown fields are rejected. POST query-string parameters are rejected.
GET requests use query parameters where listed and must not have a body.
The maximum POST body is 65,536 bytes and each field value is limited to 8,192 characters.

Use strings for identifiers, phone numbers and codes to preserve leading zeroes.
Supply monetary inputs in naira without currency signs or grouping commas.
Response amounts may be strings and may contain grouping commas. Date strings retain
the existing endpoint's format; they are not guaranteed to be ISO 8601 or UTC.

Product codes and prices

Fetch current catalogues instead of hard-coding plan names, prices or limits.
For mobile data, use the selected network ID and plan PRODUCT_CODE. DATA_TYPE
is SME or DIRECT; do not infer the delivery type from words in the plan name.
The same mobile-data catalogue supplies the plan identity for data e-PIN generation.
Smile uses its own package catalogue.

Orders and uncertain outcomes

RequestID is required for every purchase: 1-64 letters, digits, underscores or hyphens.
Create one ID for one intended purchase and retain it with the returned order ID.
Do not change the ID or automatically submit another purchase after a timeout or 503.
First query Orders - by request ID. If the result is still unavailable, retain the
reference for investigation rather than assuming no debit occurred.

REST response contract (20261102-3)

Successful business responses use HTTP 200. Always inspect the JSON status: a saved
purchase may still be ORDER_RECEIVED, ORDER_PENDING or ORDER_PROCESSING. Only a
saved completion returns ORDER_COMPLETED. Purchase and order lookups use the same
operational status reader; no provider purchase is retried by response formatting.

Wallet: status=WALLET_SUCCESS, id, phoneno, balance, currency=NGN, date.
Verification: status=VERIFIED, valid=true, customer_name, validation_reference.
An optional customer name/reference can be empty when the provider explicitly
confirms that no validation reference is required. Verification does not vend.

Errors use a non-200 HTTP status and JSON status/message:
400 malformed request; 401 missing or invalid credentials; 403 blocked account,
IP restriction, HTTPS or KYC requirement; 404 owned order not found;
405 unsupported method; 413 oversized body; 415 unsupported content type;
422 invalid input, business rejection, or VERIFICATION_REJECTED with valid=false;
429 rate limit with Retry-After: 1; 502 malformed provider response;
503 dependency or saved-state unavailable; 504 provider verification timeout.
An outage is not reported as an invalid customer. Raw provider error bodies and
credentials are not returned. Clients should retain RequestID before sending.

If a purchase was attempted but its result cannot be confirmed, the error retains
requestid, outcome=UNKNOWN, orderid when available, and next_action. An unavailable
post-purchase status read returns ORDER_STATUS_UNAVAILABLE with saved=true when
the save was confirmed. Query the same reference before another purchase. Never
automatically submit a purchase again because a response is 5xx or a lookup is 404.
ORDER_NOT_FOUND describes an unsuccessful order lookup; it is not proof that no purchase occurred. PIN detail availability is separate from status.

Wallet and current-order money fields are decimal strings with two decimal places
and no grouping commas. Dates are ISO 8601 with the database server's UTC offset,
for example 2026-11-02T12:00:00+01:00. Catalogue schemas and prices are unchanged.
Cable TV uses the submitted MobileNumber; betting uses submitted PhoneNo when
present, otherwise the authenticated member's phone. These phone fields accept
local 0-prefixed and +234/234 formats. Accepted Memo is passed to purchase storage.

Limits are shared across each category per source IP, per IIS worker: 30 purchase
requests/second, 10 verification requests/second, 60 authenticated-route GET
requests/second. Invalid credentials also consume the category limit. Health,
OPTIONS, documentation and private helper calls are excluded. Counters are bounded
in memory and reset on application recycle; this is not a distributed account
quota. A full counter bucket also returns 429 until the next second.

The response header X-Rest-Contract: 20261102-3 identifies this deployment.
Existing REST route names, request fields, standard key authentication, delivery mapping and commission are retained. New REST-only SQL objects protect
RequestID reuse and capture wallet snapshots. Shared legacy definitions are unchanged.
This response contract applies only to api.nellobytesystems.com/v1.

There is no working cancellation route in this REST release. /orders/cancel
returns HTTP 501 CANCELLATION_NOT_AVAILABLE and is deliberately not a runnable request here.

HTTP request errors

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

HTTP	Example status	Action
400	`INVALID_JSON`, `UNKNOWN_PARAMETER`, `DUPLICATE_PARAMETER`, `USE_JSON_BODY_ONLY`, `GET_BODY_NOT_ALLOWED`	Correct the request format.
401	`MISSING_CREDENTIALS`, `INVALID_CREDENTIALS`, `MISSING_USER_ID`	Check the authentication headers.
403	`HTTPS_REQUIRED`, account/IP/KYC restriction	Use HTTPS and review the member restriction.
404	`ROUTE_NOT_FOUND`	Check the path.
405	`METHOD_NOT_ALLOWED`	Use the documented HTTP method.
413	`REQUEST_TOO_LARGE`	Reduce the body size.
415	`JSON_CONTENT_TYPE_REQUIRED`	Send application/json.
422	`MISSING_`, `INVALID_REQUEST_ID`	Supply a valid required value.
503	Service or outcome unavailable	Query an uncertain purchase before considering another order.

Examples

All saved responses marked Illustrative are synthetic, source-derived format examples.
They are not live transaction results or current price quotations. Catalogue examples
show only a subset of entries. PINs, tokens, IDs and customer details are placeholders.
Refresh the real catalogue with your account before an intentional purchase.

REST purchase protection (contract 20261102-3)

All ten purchase routes retain a durable request receipt keyed by the authenticated
member and RequestID. Keep the same route and field values for an identical retry.
JSON property order and property-name casing do not affect identity. Missing and
empty optional fields are equivalent; different supplied field values (including
numeric spellings, Memo and callback URL) are conservatively treated as a conflict.
The database stores a SHA-256 fingerprint, not the raw request or API key.

An identical saved request returns its CURRENT operational order status without
another purchase. Idempotent-Replayed: true identifies a replay. Changed details
or another product with the same member/RequestID return HTTP 409 REQUEST_ID_CONFLICT.
A request still processing, interrupted, or with uncertain save outcome returns
HTTP 409 REQUEST_OUTCOME_PENDING_REVIEW. Query GET /orders using RequestID or
contact support; do not replace the RequestID to work around that response.
Requests rejected before purchase SQL retain their rejection. Corrected purchases
use a new RequestID only once the previous rejection is definite.

New successful purchase/RequestID responses include wallet_before and wallet_after,
decimal strings describing the saved request's wallet snapshots. They are captured
inside the purchase transaction and exposed only after commit, including batches.
They describe the original purchase, not the customer's current wallet after later
activity or a refund. GET /wallet remains the current wallet observation.
For an older airtime request adopted by its existing replay mechanism, unavailable
historical wallet snapshots are empty rather than invented.

Receipt and source-item writes commit with the debit/order. If the order fails,
those writes roll back while the initial pending claim is retained for review.
There is no automatic claim expiry or repeat purchase after an ambiguous failure.
An old receipt cannot be reused just because its operational record is no longer available:
the receipt persists, and unavailable current status returns 503 with saved=true.
Retained display details cannot authorize financial operations.

These protections cover REST requests first submitted after deployment. Prior
unconfirmed requests and legacy endpoints are not backfilled into this ledger.
Do not re-submit a pre-deployment uncertain request; reconcile its saved payment.
Existing pricing, cashback, delivery mapping and legacy endpoints stay unchanged.

For an older order, use GET /orders?OrderID=YOUR_ORDER_ID. The same response fields and status names apply. Current saved order details take precedence; when the order is no longer in the active retention window, its retained transaction details can be displayed. This is an individual order view, not a batch reconstruction. RequestID and BatchNo lookups, purchase results and request replay protection keep their existing operational rules. A database error returns ORDER_STATUS_UNAVAILABLE; it is not treated as a missing order. Viewing a receipt never authorizes a refund, redo or wallet movement.

Request reference

Responses generated by the REST runtime include an X-Request-Reference header. Give this reference to support when investigating a request. It identifies an HTTP attempt; continue using RequestID for purchase idempotency. Static files, IIS-generated responses and failures before the runtime starts may not include this header.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"11035265","collectionId":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","publishedId":"2sBYHaNGXy","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-11-11T19:27:27.000Z"},"item":[{"name":"Start here","item":[{"name":"Health","id":"8879f073-1faf-4f5a-841b-2679bb506f6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/health","description":"

Unauthenticated runtime health check. scope: runtime-only does not test database access, provider connectivity or purchase processing.

REST response contract (20261102-2)

Successful business responses use HTTP 200. Always inspect the JSON status: a saved\npurchase may still be ORDER_RECEIVED, ORDER_PENDING or ORDER_PROCESSING. Only a\nsaved completion returns ORDER_COMPLETED. Purchase and order lookups use the same\noperational status reader; no provider purchase is retried by response formatting.

Wallet: status=WALLET_SUCCESS, id, phoneno, balance, currency=NGN, date.\nVerification: status=VERIFIED, valid=true, customer_name, validation_reference.\nAn optional customer name/reference can be empty when the provider explicitly\nconfirms that no validation reference is required. Verification does not vend.

Errors use a non-200 HTTP status and JSON status/message:\n400 malformed request; 401 missing or invalid credentials; 403 blocked account,\nIP restriction, HTTPS or KYC requirement; 404 owned order not found;\n405 unsupported method; 413 oversized body; 415 unsupported content type;\n422 invalid input, business rejection, or VERIFICATION_REJECTED with valid=false;\n429 rate limit with Retry-After: 1; 502 malformed provider response;\n503 dependency or saved-state unavailable; 504 provider verification timeout.\nAn outage is not reported as an invalid customer. Raw provider error bodies and\ncredentials are not returned. Clients should retain RequestID before sending.

If a purchase was attempted but its result cannot be confirmed, the error retains\nrequestid, outcome=UNKNOWN, orderid when available, and next_action. An unavailable\npost-purchase status read returns ORDER_STATUS_UNAVAILABLE with saved=true when\nthe save was confirmed. Query the same reference before another purchase. Never\nautomatically submit a purchase again because a response is 5xx or a lookup is 404.\nORDER_NOT_FOUND describes an unsuccessful order lookup; it is not proof that no purchase occurred. PIN detail availability is separate from status.

Wallet and current-order money fields are decimal strings with two decimal places\nand no grouping commas. Dates are ISO 8601 with the database server's UTC offset,\nfor example 2026-11-02T12:00:00+01:00. Catalogue schemas and prices are unchanged.\nCable TV uses the submitted MobileNumber; betting uses submitted PhoneNo when\npresent, otherwise the authenticated member's phone. These phone fields accept\nlocal 0-prefixed and +234/234 formats. Accepted Memo is passed to purchase storage.

Limits are shared across each category per source IP, per IIS worker: 30 purchase\nrequests/second, 10 verification requests/second, 60 authenticated-route GET\nrequests/second. Invalid credentials also consume the category limit. Health,\nOPTIONS, documentation and private helper calls are excluded. Counters are bounded\nin memory and reset on application recycle; this is not a distributed account\nquota. A full counter bucket also returns 429 until the next second.

The response header X-Rest-Contract: 20261102-2 identifies this deployment.\nExisting REST route names, request fields, standard key authentication, financial\nfunctions, delivery mapping, commission and database procedures are retained.\nThis response contract applies only to api.nellobytesystems.com/v1.

\n","urlObject":{"path":["health"],"host":["https://api.nellobytesystems.com/v1"],"query":[],"variable":[]}},"response":[{"id":"fbd58e26-38e0-44ad-b9cb-ea99507e455e","name":"Healthy runtime","originalRequest":{"auth":{"type":"noauth"},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"OK\",\n \"version\": \"rest-v1\",\n \"scope\": \"runtime-only\"\n}"}],"_postman_id":"8879f073-1faf-4f5a-841b-2679bb506f6d"},{"name":"Wallet balance","id":"948bd683-3643-4fba-9e25-a05cb4a834f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/wallet","description":"

Current wallet snapshot.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/orders?OrderID=&IncludePINs=false","description":"

Purchase responses and GET /orders use the same current saved-status reader. Status is observed after the financial operation commits; the API does not wait for delivery or send another purchase. A response may already be ORDER_COMPLETED, or remain ORDER_RECEIVED / ORDER_PROCESSING. Poll GET /orders with the same OrderID or RequestID to observe later progress.

Every successfully read order has status, orderid, transactionid, requestid, transactiondate, producttype, productname, amount, walletbalance, paymentoption and remark, plus product-specific details. Empty detail fields are empty strings. remark is the actual saved operator/admin comment, JSON escaped; a generic success message is not substituted. An explicit pending completion receipt keeps status ORDER_PROCESSING and withholds staged final remarks/tokens until completion is saved. Dates are ISO 8601 with the database server UTC offset; amount and walletbalance are decimal strings without grouping commas. amount uses the saved debit where present, and amountcredited describes a positive saved credit (not cashback).

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

An unavailable post-purchase read retains orderid, requestid, and saved: true. HTTP 200 alone does not establish completion. Read failures use HTTP 503; missing owned orders use HTTP 404. Other errors use the REST error contract.

For a multi-phone airtime request, the top-level status covers the entire request and orders contains each child's receipt. Missing or ambiguous source records produce ORDER_STATUS_UNAVAILABLE. For operational orders, GET by a child's order ID returns the request group when its request metadata is available.

e-PIN orders retain TXN_EPIN or TXN_EPIN_DATABUNDLE when their complete owned batch is available, together with ORDER_ID and detailsstatus: AVAILABLE. detailsstatus: PENDING or UNAVAILABLE does not change the financial status or authorize another purchase. Retry the existing order lookup for unavailable PIN details. No provider requery, vend, callback, refund or wallet update is performed by this status reader.

REST response contract (20261102-2)

e-PIN asynchronous responses (20261103-1)

POST /orders/epin and /orders/databundle-epin return HTTP 202 Accepted while a\nconfirmed saved order is waiting for its complete PIN batch. The JSON retains\nthe current saved status, orderid, requestid and wallet snapshots. Location and\nstatus_url point to GET /v1/orders?OrderID=...&IncludePINs=false; Retry-After and\nretry_after_seconds suggest five seconds before the next lookup. A batch already\nready returns HTTP 200 with detailsstatus AVAILABLE and its existing PIN array.\nSaved RequestID replays follow the same rule without another purchase. An\nunconfirmed save is never converted into an accepted order.

GET /orders accepts optional IncludePINs=true|false (default true). Exactly one\nOrderID, RequestID or BatchNo is still required. Both modes require the same\nmember authentication. false returns status and readiness without transferring\nPIN values; true includes the complete owned PIN batch when ready. pins_url\npoints to the full lookup. These links contain no credentials.

GET returns HTTP 200 while the PIN batch is PENDING. AVAILABLE means all requested\nPINs were readable at that observation. An incomplete batch returns PENDING and\nno partial PIN array. A SQL failure, invalid batch or conflicting PIN data returns\nHTTP 503 with UNAVAILABLE, not a generation result. NOT_APPLICABLE means the order\nis failed, cancelled or refunded; stop polling. The saved financial status is\npreserved: ORDER_COMPLETED alone does not guarantee PIN readiness. Check\ndetailsstatus, and require AVAILABLE with the PIN array before delivering PINs.

Poll from your application: start after five seconds, then back off to 10, 20 and\n30 seconds; stop after a bounded number of attempts. A polling timeout is not a\npurchase failure or permission to refund/rebuy. Retain and query the same order\nor RequestID later. Lost POST responses are queried by RequestID. No new job,\nwebhook delivery system or PIN generator is installed by this update. Normal\ngeneration continues independently; lookup latency is not generation time.\nThe current data e-PIN purchase function creates its batch before committing,\nso it normally returns 200 with AVAILABLE. Its generation is not moved to a\nbackground worker here; the shared reader handles any later pending observation.

For large batches, use IncludePINs=false until AVAILABLE, then retrieve the PINs\nonce with IncludePINs=true. PIN retrieval is still a full batch, not pagination.\nCounts are bounded at 10,001 rows for the existing 10,000-PIN maximum; this reduces\npayloads but is not a guarantee of zero database load or blocking.

epin-polling.mjs is a server-side integration example using authenticated GETs\nonly, with bounded polling and 30-second per-request timeouts. Import waitForEpin\nand pass orderId, memberId and apiKey from your secure server configuration.\nIt never submits a purchase; store the returned PINs securely and do not log them.\nIt uses the fixed API origin and rejects redirects. Do not embed a member API key\nin public browser code. No automatic collection runner or purchase retry is added.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}},"urlObject":{"path":["orders"],"host":["https://api.nellobytesystems.com/v1"],"query":[{"key":"OrderID","value":""},{"key":"IncludePINs","value":"false"}],"variable":[]}},"response":[{"id":"4b687a44-9d25-402f-8ce6-ea3cbd0a843a","name":"Pending PIN generation","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=&IncludePINs=false","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":""},{"key":"IncludePINs","value":"false"}]},"description":"Purchase responses and GET /orders use the same current saved-status reader. Status is observed after the financial operation commits; the API does not wait for delivery or send another purchase. A response may already be ORDER_COMPLETED, or remain ORDER_RECEIVED / ORDER_PROCESSING. Poll GET /orders with the same OrderID or RequestID to observe later progress.\n\nEvery successfully read order has `status`, `orderid`, `transactionid`, `requestid`, `transactiondate`, `producttype`, `productname`, `amount`, `walletbalance`, `paymentoption` and `remark`, plus product-specific details. Empty detail fields are empty strings. `remark` is the actual saved operator/admin comment, JSON escaped; a generic success message is not substituted. An explicit pending completion receipt keeps status ORDER_PROCESSING and withholds staged final remarks/tokens until completion is saved. Dates are ISO 8601 with the database server UTC offset; amount and walletbalance are decimal strings without grouping commas. `amount` uses the saved debit where present, and `amountcredited` describes a positive saved credit (not cashback).\n\n| Status | Meaning |\n| --- | --- |\n| ORDER_RECEIVED | Saved Paid state; delivery not yet confirmed. |\n| ORDER_PENDING | Saved Pending state. |\n| ORDER_PROCESSING | Processing, or awaiting the final completion receipt. |\n| ORDER_PROCESSED | Saved Processed state; not equivalent to Completed. |\n| ORDER_COMPLETED | Saved Completed state with no pending completion marker. |\n| ORDER_REFUNDED | Saved Refunded state. |\n| ORDER_CANCELLED | Saved Cancelled state. |\n| ORDER_FAILED | Saved Failed state; this response does not itself refund anything. |\n| ORDER_FINISHED_WITH_FAILURES | All children finished, with mixed completed/refunded/cancelled/failed states. |\n| ORDER_STATUS_UNAVAILABLE | Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response. |\n| ORDER_NOT_FOUND | No owned order was found for the supplied selector. This does not prove no earlier payment occurred. |\n\nAn unavailable post-purchase read retains `orderid`, `requestid`, and `saved: true`. HTTP 200 alone does not establish completion. Read failures use HTTP 503; missing owned orders use HTTP 404. Other errors use the REST error contract.\n\nFor a multi-phone airtime request, the top-level status covers the entire request and `orders` contains each child's receipt. Missing or ambiguous source records produce ORDER_STATUS_UNAVAILABLE. For operational orders, GET by a child's order ID returns the request group when its request metadata is available.\n\ne-PIN orders retain `TXN_EPIN` or `TXN_EPIN_DATABUNDLE` when their complete owned batch is available, together with `ORDER_ID` and `detailsstatus: AVAILABLE`. `detailsstatus: PENDING` or `UNAVAILABLE` does not change the financial status or authorize another purchase. Retry the existing order lookup for unavailable PIN details. No provider requery, vend, callback, refund or wallet update is performed by this status reader.\n\nREST response contract (20261102-2)\n\nSuccessful business responses use HTTP 200. Always inspect the JSON status: a saved\npurchase may still be ORDER_RECEIVED, ORDER_PENDING or ORDER_PROCESSING. Only a\nsaved completion returns ORDER_COMPLETED. Purchase and order lookups use the same\noperational status reader; no provider purchase is retried by response formatting.\n\nWallet: status=WALLET_SUCCESS, id, phoneno, balance, currency=NGN, date.\nVerification: status=VERIFIED, valid=true, customer_name, validation_reference.\nAn optional customer name/reference can be empty when the provider explicitly\nconfirms that no validation reference is required. Verification does not vend.\n\nErrors use a non-200 HTTP status and JSON status/message:\n400 malformed request; 401 missing or invalid credentials; 403 blocked account,\nIP restriction, HTTPS or KYC requirement; 404 owned order not found;\n405 unsupported method; 413 oversized body; 415 unsupported content type;\n422 invalid input, business rejection, or VERIFICATION_REJECTED with valid=false;\n429 rate limit with Retry-After: 1; 502 malformed provider response;\n503 dependency or saved-state unavailable; 504 provider verification timeout.\nAn outage is not reported as an invalid customer. Raw provider error bodies and\ncredentials are not returned. Clients should retain RequestID before sending.\n\nIf a purchase was attempted but its result cannot be confirmed, the error retains\nrequestid, outcome=UNKNOWN, orderid when available, and next_action. An unavailable\npost-purchase status read returns ORDER_STATUS_UNAVAILABLE with saved=true when\nthe save was confirmed. Query the same reference before another purchase. Never\nautomatically submit a purchase again because a response is 5xx or a lookup is 404.\nORDER_NOT_FOUND describes an unsuccessful order lookup; it is not proof that no purchase occurred. PIN detail availability is separate from status.\n\nWallet and current-order money fields are decimal strings with two decimal places\nand no grouping commas. Dates are ISO 8601 with the database server's UTC offset,\nfor example 2026-11-02T12:00:00+01:00. Catalogue schemas and prices are unchanged.\nCable TV uses the submitted MobileNumber; betting uses submitted PhoneNo when\npresent, otherwise the authenticated member's phone. These phone fields accept\nlocal 0-prefixed and +234/234 formats. Accepted Memo is passed to purchase storage.\n\nLimits are shared across each category per source IP, per IIS worker: 30 purchase\nrequests/second, 10 verification requests/second, 60 authenticated-route GET\nrequests/second. Invalid credentials also consume the category limit. Health,\nOPTIONS, documentation and private helper calls are excluded. Counters are bounded\nin memory and reset on application recycle; this is not a distributed account\nquota. A full counter bucket also returns 429 until the next second.\n\nThe response header X-Rest-Contract: 20261102-2 identifies this deployment.\nExisting REST route names, request fields, standard key authentication, financial\nfunctions, delivery mapping, commission and database procedures are retained.\nThis response contract applies only to api.nellobytesystems.com/v1.\n\n\nFor an older order, use GET /orders?OrderID=YOUR_ORDER_ID. The same response fields and status names apply. Current saved order details take precedence; when the order is no longer in the active retention window, its retained transaction details can be displayed. This is an individual order view, not a batch reconstruction. RequestID and BatchNo lookups, purchase results and request replay protection keep their existing operational rules. A database error returns ORDER_STATUS_UNAVAILABLE; it is not treated as a missing order. Viewing a receipt never authorizes a refund, redo or wallet movement.\n\ne-PIN asynchronous responses (20261103-1)\n\nPOST /orders/epin and /orders/databundle-epin return HTTP 202 Accepted while a\nconfirmed saved order is waiting for its complete PIN batch. The JSON retains\nthe current saved status, orderid, requestid and wallet snapshots. Location and\nstatus_url point to GET /v1/orders?OrderID=...&IncludePINs=false; Retry-After and\nretry_after_seconds suggest five seconds before the next lookup. A batch already\nready returns HTTP 200 with detailsstatus AVAILABLE and its existing PIN array.\nSaved RequestID replays follow the same rule without another purchase. An\nunconfirmed save is never converted into an accepted order.\n\nGET /orders accepts optional IncludePINs=true|false (default true). Exactly one\nOrderID, RequestID or BatchNo is still required. Both modes require the same\nmember authentication. false returns status and readiness without transferring\nPIN values; true includes the complete owned PIN batch when ready. pins_url\npoints to the full lookup. These links contain no credentials.\n\nGET returns HTTP 200 while the PIN batch is PENDING. AVAILABLE means all requested\nPINs were readable at that observation. An incomplete batch returns PENDING and\nno partial PIN array. A SQL failure, invalid batch or conflicting PIN data returns\nHTTP 503 with UNAVAILABLE, not a generation result. NOT_APPLICABLE means the order\nis failed, cancelled or refunded; stop polling. The saved financial status is\npreserved: ORDER_COMPLETED alone does not guarantee PIN readiness. Check\ndetailsstatus, and require AVAILABLE with the PIN array before delivering PINs.\n\nPoll from your application: start after five seconds, then back off to 10, 20 and\n30 seconds; stop after a bounded number of attempts. A polling timeout is not a\npurchase failure or permission to refund/rebuy. Retain and query the same order\nor RequestID later. Lost POST responses are queried by RequestID. No new job,\nwebhook delivery system or PIN generator is installed by this update. Normal\ngeneration continues independently; lookup latency is not generation time.\nThe current data e-PIN purchase function creates its batch before committing,\nso it normally returns 200 with AVAILABLE. Its generation is not moved to a\nbackground worker here; the shared reader handles any later pending observation.\n\nFor large batches, use IncludePINs=false until AVAILABLE, then retrieve the PINs\nonce with IncludePINs=true. PIN retrieval is still a full batch, not pagination.\nCounts are bounded at 10,001 rows for the existing 10,000-PIN maximum; this reduces\npayloads but is not a guarantee of zero database load or blocking.\n\nepin-polling.mjs is a server-side integration example using authenticated GETs\nonly, with bounded polling and 30-second per-request timeouts. Import waitForEpin\nand pass orderId, memberId and apiKey from your secure server configuration.\nIt never submits a purchase; store the returned PINs securely and do not log them.\nIt uses the fixed API origin and rejects redirects. Do not embed a member API key\nin public browser code. No automatic collection runner or purchase retry is added.\n"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_RECEIVED\",\n \"orderid\": \"123\",\n \"transactionid\": \"123\",\n \"requestid\": \"example-epin-001\",\n \"detailsstatus\": \"PENDING\",\n \"status_url\": \"/v1/orders?OrderID=123&IncludePINs=false\",\n \"pins_url\": \"/v1/orders?OrderID=123&IncludePINs=true\",\n \"retry_after_seconds\": 5\n}"},{"id":"2a427db4-de04-4b0d-92ab-05e68a2d3514","name":"Ready - retrieve pins_url with the same member credentials","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=&IncludePINs=false","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":""},{"key":"IncludePINs","value":"false"}]},"description":"Purchase responses and GET /orders use the same current saved-status reader. Status is observed after the financial operation commits; the API does not wait for delivery or send another purchase. A response may already be ORDER_COMPLETED, or remain ORDER_RECEIVED / ORDER_PROCESSING. Poll GET /orders with the same OrderID or RequestID to observe later progress.\n\nEvery successfully read order has `status`, `orderid`, `transactionid`, `requestid`, `transactiondate`, `producttype`, `productname`, `amount`, `walletbalance`, `paymentoption` and `remark`, plus product-specific details. Empty detail fields are empty strings. `remark` is the actual saved operator/admin comment, JSON escaped; a generic success message is not substituted. An explicit pending completion receipt keeps status ORDER_PROCESSING and withholds staged final remarks/tokens until completion is saved. Dates are ISO 8601 with the database server UTC offset; amount and walletbalance are decimal strings without grouping commas. `amount` uses the saved debit where present, and `amountcredited` describes a positive saved credit (not cashback).\n\n| Status | Meaning |\n| --- | --- |\n| ORDER_RECEIVED | Saved Paid state; delivery not yet confirmed. |\n| ORDER_PENDING | Saved Pending state. |\n| ORDER_PROCESSING | Processing, or awaiting the final completion receipt. |\n| ORDER_PROCESSED | Saved Processed state; not equivalent to Completed. |\n| ORDER_COMPLETED | Saved Completed state with no pending completion marker. |\n| ORDER_REFUNDED | Saved Refunded state. |\n| ORDER_CANCELLED | Saved Cancelled state. |\n| ORDER_FAILED | Saved Failed state; this response does not itself refund anything. |\n| ORDER_FINISHED_WITH_FAILURES | All children finished, with mixed completed/refunded/cancelled/failed states. |\n| ORDER_STATUS_UNAVAILABLE | Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response. |\n| ORDER_NOT_FOUND | No owned order was found for the supplied selector. This does not prove no earlier payment occurred. |\n\nAn unavailable post-purchase read retains `orderid`, `requestid`, and `saved: true`. HTTP 200 alone does not establish completion. Read failures use HTTP 503; missing owned orders use HTTP 404. Other errors use the REST error contract.\n\nFor a multi-phone airtime request, the top-level status covers the entire request and `orders` contains each child's receipt. Missing or ambiguous source records produce ORDER_STATUS_UNAVAILABLE. For operational orders, GET by a child's order ID returns the request group when its request metadata is available.\n\ne-PIN orders retain `TXN_EPIN` or `TXN_EPIN_DATABUNDLE` when their complete owned batch is available, together with `ORDER_ID` and `detailsstatus: AVAILABLE`. `detailsstatus: PENDING` or `UNAVAILABLE` does not change the financial status or authorize another purchase. Retry the existing order lookup for unavailable PIN details. No provider requery, vend, callback, refund or wallet update is performed by this status reader.\n\nREST response contract (20261102-2)\n\nSuccessful business responses use HTTP 200. Always inspect the JSON status: a saved\npurchase may still be ORDER_RECEIVED, ORDER_PENDING or ORDER_PROCESSING. Only a\nsaved completion returns ORDER_COMPLETED. Purchase and order lookups use the same\noperational status reader; no provider purchase is retried by response formatting.\n\nWallet: status=WALLET_SUCCESS, id, phoneno, balance, currency=NGN, date.\nVerification: status=VERIFIED, valid=true, customer_name, validation_reference.\nAn optional customer name/reference can be empty when the provider explicitly\nconfirms that no validation reference is required. Verification does not vend.\n\nErrors use a non-200 HTTP status and JSON status/message:\n400 malformed request; 401 missing or invalid credentials; 403 blocked account,\nIP restriction, HTTPS or KYC requirement; 404 owned order not found;\n405 unsupported method; 413 oversized body; 415 unsupported content type;\n422 invalid input, business rejection, or VERIFICATION_REJECTED with valid=false;\n429 rate limit with Retry-After: 1; 502 malformed provider response;\n503 dependency or saved-state unavailable; 504 provider verification timeout.\nAn outage is not reported as an invalid customer. Raw provider error bodies and\ncredentials are not returned. Clients should retain RequestID before sending.\n\nIf a purchase was attempted but its result cannot be confirmed, the error retains\nrequestid, outcome=UNKNOWN, orderid when available, and next_action. An unavailable\npost-purchase status read returns ORDER_STATUS_UNAVAILABLE with saved=true when\nthe save was confirmed. Query the same reference before another purchase. Never\nautomatically submit a purchase again because a response is 5xx or a lookup is 404.\nORDER_NOT_FOUND describes an unsuccessful order lookup; it is not proof that no purchase occurred. PIN detail availability is separate from status.\n\nWallet and current-order money fields are decimal strings with two decimal places\nand no grouping commas. Dates are ISO 8601 with the database server's UTC offset,\nfor example 2026-11-02T12:00:00+01:00. Catalogue schemas and prices are unchanged.\nCable TV uses the submitted MobileNumber; betting uses submitted PhoneNo when\npresent, otherwise the authenticated member's phone. These phone fields accept\nlocal 0-prefixed and +234/234 formats. Accepted Memo is passed to purchase storage.\n\nLimits are shared across each category per source IP, per IIS worker: 30 purchase\nrequests/second, 10 verification requests/second, 60 authenticated-route GET\nrequests/second. Invalid credentials also consume the category limit. Health,\nOPTIONS, documentation and private helper calls are excluded. Counters are bounded\nin memory and reset on application recycle; this is not a distributed account\nquota. A full counter bucket also returns 429 until the next second.\n\nThe response header X-Rest-Contract: 20261102-2 identifies this deployment.\nExisting REST route names, request fields, standard key authentication, financial\nfunctions, delivery mapping, commission and database procedures are retained.\nThis response contract applies only to api.nellobytesystems.com/v1.\n\n\nFor an older order, use GET /orders?OrderID=YOUR_ORDER_ID. The same response fields and status names apply. Current saved order details take precedence; when the order is no longer in the active retention window, its retained transaction details can be displayed. This is an individual order view, not a batch reconstruction. RequestID and BatchNo lookups, purchase results and request replay protection keep their existing operational rules. A database error returns ORDER_STATUS_UNAVAILABLE; it is not treated as a missing order. Viewing a receipt never authorizes a refund, redo or wallet movement.\n\ne-PIN asynchronous responses (20261103-1)\n\nPOST /orders/epin and /orders/databundle-epin return HTTP 202 Accepted while a\nconfirmed saved order is waiting for its complete PIN batch. The JSON retains\nthe current saved status, orderid, requestid and wallet snapshots. Location and\nstatus_url point to GET /v1/orders?OrderID=...&IncludePINs=false; Retry-After and\nretry_after_seconds suggest five seconds before the next lookup. A batch already\nready returns HTTP 200 with detailsstatus AVAILABLE and its existing PIN array.\nSaved RequestID replays follow the same rule without another purchase. An\nunconfirmed save is never converted into an accepted order.\n\nGET /orders accepts optional IncludePINs=true|false (default true). Exactly one\nOrderID, RequestID or BatchNo is still required. Both modes require the same\nmember authentication. false returns status and readiness without transferring\nPIN values; true includes the complete owned PIN batch when ready. pins_url\npoints to the full lookup. These links contain no credentials.\n\nGET returns HTTP 200 while the PIN batch is PENDING. AVAILABLE means all requested\nPINs were readable at that observation. An incomplete batch returns PENDING and\nno partial PIN array. A SQL failure, invalid batch or conflicting PIN data returns\nHTTP 503 with UNAVAILABLE, not a generation result. NOT_APPLICABLE means the order\nis failed, cancelled or refunded; stop polling. The saved financial status is\npreserved: ORDER_COMPLETED alone does not guarantee PIN readiness. Check\ndetailsstatus, and require AVAILABLE with the PIN array before delivering PINs.\n\nPoll from your application: start after five seconds, then back off to 10, 20 and\n30 seconds; stop after a bounded number of attempts. A polling timeout is not a\npurchase failure or permission to refund/rebuy. Retain and query the same order\nor RequestID later. Lost POST responses are queried by RequestID. No new job,\nwebhook delivery system or PIN generator is installed by this update. Normal\ngeneration continues independently; lookup latency is not generation time.\nThe current data e-PIN purchase function creates its batch before committing,\nso it normally returns 200 with AVAILABLE. Its generation is not moved to a\nbackground worker here; the shared reader handles any later pending observation.\n\nFor large batches, use IncludePINs=false until AVAILABLE, then retrieve the PINs\nonce with IncludePINs=true. PIN retrieval is still a full batch, not pagination.\nCounts are bounded at 10,001 rows for the existing 10,000-PIN maximum; this reduces\npayloads but is not a guarantee of zero database load or blocking.\n\nepin-polling.mjs is a server-side integration example using authenticated GETs\nonly, with bounded polling and 30-second per-request timeouts. Import waitForEpin\nand pass orderId, memberId and apiKey from your secure server configuration.\nIt never submits a purchase; store the returned PINs securely and do not log them.\nIt uses the fixed API origin and rejects redirects. Do not embed a member API key\nin public browser code. No automatic collection runner or purchase retry is added.\n"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_COMPLETED\",\n \"orderid\": \"123\",\n \"transactionid\": \"123\",\n \"requestid\": \"example-epin-001\",\n \"detailsstatus\": \"AVAILABLE\",\n \"status_url\": \"/v1/orders?OrderID=123&IncludePINs=false\",\n \"pins_url\": \"/v1/orders?OrderID=123&IncludePINs=true\",\n \"ORDER_ID\": \"123\"\n}"}],"_postman_id":"f28338a3-c286-416a-aaa7-6fcbba7870e1"},{"name":"Orders - by request ID","id":"447f29f7-2710-4896-986c-80924796f12f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/orders?RequestID=","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

e-PIN asynchronous responses (20261103-1)

Your unique purchase reference: 1-64 ASCII letters, digits, underscores or hyphens. Keep it for subsequent status queries.

\n","type":"text/plain"},"key":"RequestID","value":""}],"variable":[]}},"response":[{"id":"4c275249-09e8-4a36-a026-0d3472899f74","name":"Illustrative current saved completion","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?RequestID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"RequestID","value":"","description":"Your unique purchase reference: 1-64 ASCII letters, digits, underscores or hyphens. Keep it for subsequent status queries."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_COMPLETED\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"Example operator completion message.\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"\"\n}"},{"id":"910fd7af-04d4-473a-87fc-42ea0ebb00ee","name":"Missing authentication headers","originalRequest":{"auth":{"type":"noauth"},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?RequestID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"RequestID","value":"","description":"Your unique purchase reference: 1-64 ASCII letters, digits, underscores or hyphens. Keep it for subsequent status queries."}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_CREDENTIALS\",\n \"message\": \"missing credentials\"\n}"},{"id":"84112291-680f-4642-8093-c9e45fcdc5fc","name":"No matching operational order / outside lookup window","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?RequestID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"RequestID","value":"","description":"Your unique purchase reference: 1-64 ASCII letters, digits, underscores or hyphens. Keep it for subsequent status queries."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_NOT_FOUND\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\"\n}"},{"id":"2e2ea41e-ecb2-46dd-9e6c-00771e2f4225","name":"Illustrative current pending completion","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?RequestID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"RequestID","value":"","description":"Your unique purchase reference: 1-64 ASCII letters, digits, underscores or hyphens. Keep it for subsequent status queries."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_PROCESSING\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"\"\n}"},{"id":"f9c58ae6-3ac2-40fb-800f-89e213924bdf","name":"Current status unavailable - query existing reference","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?RequestID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"RequestID","value":"","description":"Your unique purchase reference: 1-64 ASCII letters, digits, underscores or hyphens. Keep it for subsequent status queries."}]}},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_STATUS_UNAVAILABLE\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"saved\": true,\n \"message\": \"Current status could not be read. Query this order or RequestID again; do not submit another purchase.\"\n}"}],"_postman_id":"447f29f7-2710-4896-986c-80924796f12f"},{"name":"Orders - by PIN batch","id":"7af19325-224f-4b7a-9dba-2996e95016bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/orders?BatchNo=","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

e-PIN asynchronous responses (20261103-1)

Batch reference from a generated PIN batch.

\n","type":"text/plain"},"key":"BatchNo","value":""}],"variable":[]}},"response":[{"id":"aeffb1c2-e014-4097-9844-d3a2e64c0045","name":"Illustrative current saved completion","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?BatchNo=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"BatchNo","value":"","description":"Batch reference from a generated PIN batch."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_COMPLETED\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"Example saved operator completion message.\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"TXN_EPIN\": [\n {\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"mobilenetwork\": \"MTN\",\n \"sno\": \"EXAMPLE_SERIAL\",\n \"pin\": \"EXAMPLE_PIN_NOT_VALID\",\n \"amount\": \"100\"\n }\n ],\n \"detailsstatus\": \"AVAILABLE\",\n \"ORDER_ID\": \"EXAMPLE_ORDER_ID\"\n}"},{"id":"ac3af8c8-7144-43d4-bab2-1726438aac66","name":"Missing authentication headers","originalRequest":{"auth":{"type":"noauth"},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?BatchNo=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"BatchNo","value":"","description":"Batch reference from a generated PIN batch."}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_CREDENTIALS\",\n \"message\": \"missing credentials\"\n}"},{"id":"bca0f28d-b266-49e4-901d-761e750e9c29","name":"No matching operational order / outside lookup window","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?BatchNo=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"BatchNo","value":"","description":"Batch reference from a generated PIN batch."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_NOT_FOUND\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\"\n}"},{"id":"5e25f9b7-f551-45a8-982b-52ff6f563b37","name":"Illustrative current pending completion","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?BatchNo=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"BatchNo","value":"","description":"Batch reference from a generated PIN batch."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_PROCESSING\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"detailsstatus\": \"PENDING\"\n}"},{"id":"77b3da44-6d3c-48d3-9216-ae49bee36c59","name":"Current status unavailable - query existing reference","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?BatchNo=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"BatchNo","value":"","description":"Batch reference from a generated PIN batch."}]}},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_STATUS_UNAVAILABLE\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"saved\": true,\n \"message\": \"Current status could not be read. Query this order or RequestID again; do not submit another purchase.\"\n}"}],"_postman_id":"7af19325-224f-4b7a-9dba-2996e95016bf"},{"name":"Orders - by order ID","id":"48612d7a-a357-49b1-95e8-ee3ca4f49afe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/orders?OrderID=","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

e-PIN asynchronous responses (20261103-1)

Order identifier returned by the original purchase; use orderid, transactionid or ORDER_ID as appropriate.

\n","type":"text/plain"},"key":"OrderID","value":""}],"variable":[]}},"response":[{"id":"0552704d-a781-4cf3-b354-dc09ea9edafd","name":"Illustrative current saved completion","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":"","description":"Order identifier returned by the original purchase; use orderid, transactionid or ORDER_ID as appropriate."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_COMPLETED\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"Example operator completion message.\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"\"\n}"},{"id":"f20e10c2-1666-4237-9a56-b84581c6be2e","name":"Missing authentication headers","originalRequest":{"auth":{"type":"noauth"},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":"","description":"Order identifier returned by the original purchase; use orderid, transactionid or ORDER_ID as appropriate."}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_CREDENTIALS\",\n \"message\": \"missing credentials\"\n}"},{"id":"041a9438-c073-4476-9aea-5ecaf4e86d9b","name":"No matching operational order / outside lookup window","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":"","description":"Order identifier returned by the original purchase; use orderid, transactionid or ORDER_ID as appropriate."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_NOT_FOUND\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\"\n}"},{"id":"22ffd780-0309-4374-9aea-069d2ae8133a","name":"Illustrative current pending completion","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":"","description":"Order identifier returned by the original purchase; use orderid, transactionid or ORDER_ID as appropriate."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_PROCESSING\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"\"\n}"},{"id":"47c3063f-2f5c-4129-89c1-dd57ad8760c5","name":"Current status unavailable - query existing reference","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/orders?OrderID=","host":["https://api.nellobytesystems.com/v1"],"path":["orders"],"query":[{"key":"OrderID","value":"","description":"Order identifier returned by the original purchase; use orderid, transactionid or ORDER_ID as appropriate."}]}},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_STATUS_UNAVAILABLE\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"saved\": true,\n \"message\": \"Current status could not be read. Query this order or RequestID again; do not submit another purchase.\"\n}"}],"_postman_id":"48612d7a-a357-49b1-95e8-ee3ca4f49afe"},{"name":"Search transaction history","id":"167b9f0e-e8a1-4066-8d24-e8a2d2348409","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/transactions?date_from=2026-10-01&date_to=2026-10-31&limit=50","description":"

Search your retained transaction summaries. Both date_from and date_to are required. Each request covers at most 31 days, including any older retained month. Date-only YYYY-MM-DD values use Nigerian time (UTC+01:00); date_to includes that whole day. Timestamps use YYYY-MM-DDTHH:mm:ssZ or YYYY-MM-DDTHH:mm:ss+HH:mm, with mandatory seconds and timezone, no fractional seconds. Encode a plus sign as %2B. Timestamp start is inclusive and end is exclusive. Returned date_from/date_to are normalized Nigerian timestamps with an exclusive end.

Default limit 50, maximum 100. Results are newest first by date and transaction ID. count is this page only; no total count or page number. Supply next_cursor unchanged along with the same dates to get the next page; limit may change. A cursor cannot be reused for another member or date range. has_more=false returns next_cursor=\"\". An empty search succeeds with HTTP 200, TRANSACTIONS_SUCCESS and transactions=[].

This is a display-only summary search. It does not requery a provider, retry delivery, move a wallet or authorize refunds/redo. It may briefly lag recent operations. No PINs, tokens, remarks or product names are included in the list; use GET /orders?OrderID=... for individual details. amountcharged is the signed saved movement (negative debit, positive credit); walletbalance is the saved historical balance, not the current wallet. Monetary fields are decimal strings with two places, or an empty string if unavailable. productid/serviceid/variationid/providerid are saved history identifiers, not necessarily purchase catalogue codes. Unknown saved statuses return ORDER_STATUS_UNAVAILABLE, never an invented completion.

Pagination is a live view, not a frozen export: late history updates or date corrections may change earlier pages. Start a fresh search to include such changes. Limits include the existing GET rate gate and an additional 2 history searches/second per authenticated member per IIS worker. These counters reset on recycle and are not a distributed quota. HTTP 429 includes Retry-After. Invalid ranges/limits/cursors return 422. An unavailable reader or timeout returns 503, not an empty successful result. No internal storage names appear in the response.

Paste next_cursor from the previous page; keep the same dates.

\n","type":"text/plain"},"key":"cursor","value":""}],"variable":[]}},"response":[],"_postman_id":"167b9f0e-e8a1-4066-8d24-e8a2d2348409"},{"name":"Current API commission rates","id":"c609ae29-2275-4a4b-b750-56cb84c4f480","request":{"method":"GET","header":[{"key":"X-User-ID","value":""},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/commission-rates","description":"

All standard API commission rates in one JSON response: airtime, mobile databundle plans, recharge-card e-PINs and bills/services. No format flag, category selector or request body is needed. Uses this REST version's own pricing readers and plan catalogue, with no call to the main website. Rates are independent of membership; account-specific partner e-PIN prices can differ. Data e-PIN generation is excluded and retains its own checkout quotation.

Money and percentages in this response are JSON numbers (not formatted strings). wallet_debit is the amount charged upfront, benefit_after_success is credited after successful completion, and net_cost is their difference. A percentage of 4 means 4%, not 0.04. The observation time is UTC; this is not a price reservation or an atomic snapshot across all products. Purchase validation remains authoritative.

HTTP 200 / RATES_SUCCESS means all categories loaded. HTTP 503 / RATES_PARTIAL or RATES_UNAVAILABLE means some or all rates are unavailable; unavailable monetary/rate fields are null, never a fabricated zero. Only use items marked AVAILABLE. A configuration failure can return a status/message without categories. Keep X-Request-Reference for support.

Check runtime health, inspect your wallet and look up orders. Start with Health, then Wallet balance.

\n","_postman_id":"a9e16323-42e4-485a-a018-e03c56c176bb","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Airtime","item":[{"name":"Airtime networks and discounts","id":"ec64b3f9-fc91-4191-8e9b-691d81cf6f9d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/airtime/networks","description":"

Read MOBILE_NETWORK[]. Use NETWORK_ID as MobileNetwork; read MINAMOUNT, MAXAMOUNT and available BONUS codes from this response.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Amount\": \"\",\n \"MobileNumber\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/airtime","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

All ten purchase routes retain a durable request receipt keyed by the authenticated\nmember and RequestID. Keep the same route and field values for an identical retry.\nJSON property order and property-name casing do not affect identity. Missing and\nempty optional fields are equivalent; different supplied field values (including\nnumeric spellings, Memo and callback URL) are conservatively treated as a conflict.\nThe database stores a SHA-256 fingerprint, not the raw request or API key.

An identical saved request returns its CURRENT operational order status without\nanother purchase. Idempotent-Replayed: true identifies a replay. Changed details\nor another product with the same member/RequestID return HTTP 409 REQUEST_ID_CONFLICT.\nA request still processing, interrupted, or with uncertain save outcome returns\nHTTP 409 REQUEST_OUTCOME_PENDING_REVIEW. Query GET /orders using RequestID or\ncontact support; do not replace the RequestID to work around that response.\nRequests rejected before purchase SQL retain their rejection. Corrected purchases\nuse a new RequestID only once the previous rejection is definite.

New successful purchase/RequestID responses include wallet_before and wallet_after,\ndecimal strings describing the saved request's wallet snapshots. They are captured\ninside the purchase transaction and exposed only after commit, including batches.\nThey describe the original purchase, not the customer's current wallet after later\nactivity or a refund. GET /wallet remains the current wallet observation.\nFor an older airtime request adopted by its existing replay mechanism, unavailable\nhistorical wallet snapshots are empty rather than invented.

Receipt and source-item writes commit with the debit/order. If the order fails,\nthose writes roll back while the initial pending claim is retained for review.\nThere is no automatic claim expiry or repeat purchase after an ambiguous failure.\nAn old receipt cannot be reused just because its operational record is no longer available:\nthe receipt persists, and unavailable current status returns 503 with saved=true.\nRetained display details cannot authorize financial operations.

These protections cover REST requests first submitted after deployment. Prior\nunconfirmed requests and legacy endpoints are not backfilled into this ledger.\nDo not re-submit a pre-deployment uncertain request; reconcile its saved payment.\nExisting pricing, cashback, delivery mapping and legacy endpoints stay unchanged.

Load the network catalogue, choose a network and submit airtime to a phone number. Optional bonus codes come from that catalogue.

\n","_postman_id":"1ac9e0e6-6a32-4f88-b00a-1fccadbc501e","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Mobile data","item":[{"name":"Data networks and discounts","id":"eb3065be-9c08-447b-b0f7-e2e2429face9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/databundle/networks","description":"

Read MOBILE_NETWORK[] and use NETWORK_ID as MobileNetwork.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/databundle/plans","description":"

Read MOBILE_NETWORK.<network>[].PRODUCT[]. Select the network ID and plan PRODUCT_CODE, PRODUCT_NAME, PRODUCT_AMOUNT and DATA_TYPE. The response may also contain PRODUCT_ID and discount fields; new integrations should send PRODUCT_CODE as DataPlan. No network filter query is accepted; select the network from the returned catalogue.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"MobileNumber\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Load networks and plans. Use PRODUCT_CODE within the selected network; DATA_TYPE explicitly distinguishes SME and DIRECT.

\n","_postman_id":"af9ee6e1-8931-47aa-afc1-98ab5b79bccb","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Cable TV","item":[{"name":"Cable TV providers","id":"d6498329-56df-46ff-b146-8c5f7074e9a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/cabletv/providers","description":"

Read CABLE_TV[] and use TV_ID as CableTV. A provider being listed does not imply every verification path supports every provider; verification currently accepts DSTV, GOTV and Startimes.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/cabletv/packages","description":"

Read TV_ID.<provider>[].PRODUCT[] and select PACKAGE_ID as Package. Match the package to its provider and read the current PACKAGE_AMOUNT.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"CableTV\": \"\",\n \"Package\": \"\",\n \"SmartCardNo\": \"\",\n \"MobileNumber\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/cabletv","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"CableTV\": \"\",\n \"SmartCardNo\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/verify/cabletv","description":"

Read-only provider verification. No purchase is made.

REST response contract (20261102-2)

Load providers and packages, verify the smart-card number, then place an order with the matching provider and package.

\n","_postman_id":"3ac5dc61-366e-41ce-aea8-c02609e7746e","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Electricity","item":[{"name":"Electricity discos","id":"5e740136-39c5-44e8-b8aa-2d99546fa473","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/electricity/discos","description":"

Read ELECTRIC_COMPANY.<company>[]. Use the company ID as ElectricCompany and select prepaid or postpaid from PRODUCT. Read current MINAMOUNT and MAXAMOUNT; providers can impose additional restrictions.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"ElectricCompany\": \"\",\n \"MeterNo\": \"\",\n \"MeterType\": \"\",\n \"PhoneNo\": \"\",\n \"Amount\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/electricity","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"ElectricCompany\": \"\",\n \"MeterNo\": \"\",\n \"MeterType\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/verify/electricity","description":"

Read-only provider verification. No purchase is made.

REST response contract (20261102-2)

Load available discos and limits, verify the meter and meter type, then purchase. Query the order for completion and any prepaid token.

\n","_postman_id":"ff8e412d-adf4-415f-a3d0-59d0a4285cb0","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Betting","item":[{"name":"Betting providers","id":"1392c708-d788-4f03-ad4e-d6ac8f4827de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/betting/providers","description":"

Read BETTING_COMPANY[]. Send the selected PRODUCT_CODE as BettingCompany; use current limits returned with the provider.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"BettingCompany\": \"\",\n \"CustomerID\": \"\",\n \"Amount\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/betting","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"BettingCompany\": \"\",\n \"CustomerID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/verify/betting","description":"

Read-only provider verification. No purchase is made.

REST response contract (20261102-2)

Load biller codes, verify the customer ID and then fund that betting account. Verification alone is not a funding request.

\n","_postman_id":"8017421a-8306-4df0-9fdb-f4be3858d538","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Recharge e-PINs","item":[{"name":"Get e-PIN networks and discounts","id":"8723d777-bb3d-46f8-abea-15548b94f752","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/epin/networks","description":"

Pending deployment. The new e-PIN catalogue routes are documented ahead of release. Until deployment, use GET /v1/epin/discounts for network discounts.

List e-PIN networks and the recharge-card discount for each network. Use NETWORK_ID as MobileNetwork when requesting values or placing an order.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/epin/values","description":"

Pending deployment. The new e-PIN catalogue routes are documented ahead of release. Until deployment, use GET /v1/epin/discounts for network discounts.

List recharge PIN face values and available quantities. Omit MobileNetwork for all networks or pass a network ID such as 01. A zero quantity means sold out. Checkout rechecks availability; each order accepts up to 100 PINs.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Optional network ID. Omit for all networks.

\n","type":"text/plain"},"key":"MobileNetwork","value":"01"}],"variable":[]}},"response":[{"id":"380401a6-a4ac-4137-8386-3d32823f23ee","name":"Illustrative success response","originalRequest":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/epin/values","host":["https://api.nellobytesystems.com/v1"],"path":["epin","values"],"query":[{"key":"MobileNetwork","value":"01","description":"Optional network ID. Omit for all networks.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"networks\": [\n {\n \"MobileNetwork\": \"01\",\n \"name\": \"MTN\",\n \"values\": [\n {\n \"Value\": \"100\",\n \"quantity_available\": 240\n },\n {\n \"Value\": \"200\",\n \"quantity_available\": 35\n },\n {\n \"Value\": \"500\",\n \"quantity_available\": 0\n },\n {\n \"Value\": \"1000\",\n \"quantity_available\": 10\n }\n ]\n }\n ]\n}"},{"id":"ad43495e-b1f4-4799-a49d-7e5c201201b5","name":"Missing authentication headers","originalRequest":{"auth":{"type":"noauth"},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.nellobytesystems.com/v1/epin/values","host":["https://api.nellobytesystems.com/v1"],"path":["epin","values"],"query":[{"key":"MobileNetwork","value":"01","description":"Optional network ID. Omit for all networks.","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_CREDENTIALS\",\n \"message\": \"missing credentials\"\n}"}],"_postman_id":"34545075-d437-4a5f-990e-5f108b2de78f"},{"name":"Generate recharge e-PINs","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Save the confirmed order ID only. Never repeat or chain a purchase.","if (pm.response.code === 200 || pm.response.code === 202) {"," const order = pm.response.json();"," if (order.orderid) pm.collectionVariables.set(\"orderId\", String(order.orderid));","}"],"id":"ad7043de-ff55-473c-a30a-5d2e1a138531"}}],"id":"5b42419e-7813-4d4b-9af4-58fe4f808bd3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Value\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/epin","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

e-PIN asynchronous responses (20261103-1)

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}},"urlObject":{"path":["orders","epin"],"host":["https://api.nellobytesystems.com/v1"],"query":[],"variable":[]}},"response":[{"id":"cbe25a65-4c95-4ecb-8677-7f6726cb4fc5","name":"Illustrative current saved completion","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Value\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/epin"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_COMPLETED\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"Example saved operator completion message.\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"TXN_EPIN\": [\n {\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"mobilenetwork\": \"MTN\",\n \"sno\": \"EXAMPLE_SERIAL\",\n \"pin\": \"EXAMPLE_PIN_NOT_VALID\",\n \"amount\": \"100\"\n }\n ],\n \"detailsstatus\": \"AVAILABLE\",\n \"ORDER_ID\": \"EXAMPLE_ORDER_ID\"\n}"},{"id":"7d46c697-0bf4-4480-bccb-c75f70824a17","name":"Missing authentication headers","originalRequest":{"auth":{"type":"noauth"},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Value\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/epin"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_CREDENTIALS\",\n \"message\": \"missing credentials\"\n}"},{"id":"eb578383-96b9-4ec6-b2b6-7da3bd76e0e9","name":"Missing RequestID (rejected before purchase)","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Value\": \"\",\n \"Quantity\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/epin"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_REQUESTID\",\n \"message\": \"missing requestid\"\n}"},{"id":"321f4ec4-fcf2-4e0a-a84c-5e71332e0d33","name":"Current status unavailable - query existing reference","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Value\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/epin"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_STATUS_UNAVAILABLE\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"saved\": true,\n \"message\": \"Current status could not be read. Query this order or RequestID again; do not submit another purchase.\"\n}"},{"id":"c665dc27-9260-405a-8476-0dac149f7ac0","name":"Accepted e-PIN batch - poll existing order","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"Value\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/epin","description":"Purchase responses and GET /orders use the same current saved-status reader. Status is observed after the financial operation commits; the API does not wait for delivery or send another purchase. A response may already be ORDER_COMPLETED, or remain ORDER_RECEIVED / ORDER_PROCESSING. Poll GET /orders with the same OrderID or RequestID to observe later progress.\n\nEvery successfully read order has `status`, `orderid`, `transactionid`, `requestid`, `transactiondate`, `producttype`, `productname`, `amount`, `walletbalance`, `paymentoption` and `remark`, plus product-specific details. Empty detail fields are empty strings. `remark` is the actual saved operator/admin comment, JSON escaped; a generic success message is not substituted. An explicit pending completion receipt keeps status ORDER_PROCESSING and withholds staged final remarks/tokens until completion is saved. Dates are ISO 8601 with the database server UTC offset; amount and walletbalance are decimal strings without grouping commas. `amount` uses the saved debit where present, and `amountcredited` describes a positive saved credit (not cashback).\n\n| Status | Meaning |\n| --- | --- |\n| ORDER_RECEIVED | Saved Paid state; delivery not yet confirmed. |\n| ORDER_PENDING | Saved Pending state. |\n| ORDER_PROCESSING | Processing, or awaiting the final completion receipt. |\n| ORDER_PROCESSED | Saved Processed state; not equivalent to Completed. |\n| ORDER_COMPLETED | Saved Completed state with no pending completion marker. |\n| ORDER_REFUNDED | Saved Refunded state. |\n| ORDER_CANCELLED | Saved Cancelled state. |\n| ORDER_FAILED | Saved Failed state; this response does not itself refund anything. |\n| ORDER_FINISHED_WITH_FAILURES | All children finished, with mixed completed/refunded/cancelled/failed states. |\n| ORDER_STATUS_UNAVAILABLE | Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response. |\n| ORDER_NOT_FOUND | No owned order was found for the supplied selector. This does not prove no earlier payment occurred. |\n\nAn unavailable post-purchase read retains `orderid`, `requestid`, and `saved: true`. HTTP 200 alone does not establish completion. Read failures use HTTP 503; missing owned orders use HTTP 404. Other errors use the REST error contract.\n\nFor a multi-phone airtime request, the top-level status covers the entire request and `orders` contains each child's receipt. Missing or ambiguous source records produce ORDER_STATUS_UNAVAILABLE. For operational orders, GET by a child's order ID returns the request group when its request metadata is available.\n\ne-PIN orders retain `TXN_EPIN` or `TXN_EPIN_DATABUNDLE` when their complete owned batch is available, together with `ORDER_ID` and `detailsstatus: AVAILABLE`. `detailsstatus: PENDING` or `UNAVAILABLE` does not change the financial status or authorize another purchase. Retry the existing order lookup for unavailable PIN details. No provider requery, vend, callback, refund or wallet update is performed by this status reader.\n\nREST response contract (20261102-2)\n\nSuccessful business responses use HTTP 200. Always inspect the JSON status: a saved\npurchase may still be ORDER_RECEIVED, ORDER_PENDING or ORDER_PROCESSING. Only a\nsaved completion returns ORDER_COMPLETED. Purchase and order lookups use the same\noperational status reader; no provider purchase is retried by response formatting.\n\nWallet: status=WALLET_SUCCESS, id, phoneno, balance, currency=NGN, date.\nVerification: status=VERIFIED, valid=true, customer_name, validation_reference.\nAn optional customer name/reference can be empty when the provider explicitly\nconfirms that no validation reference is required. Verification does not vend.\n\nErrors use a non-200 HTTP status and JSON status/message:\n400 malformed request; 401 missing or invalid credentials; 403 blocked account,\nIP restriction, HTTPS or KYC requirement; 404 owned order not found;\n405 unsupported method; 413 oversized body; 415 unsupported content type;\n422 invalid input, business rejection, or VERIFICATION_REJECTED with valid=false;\n429 rate limit with Retry-After: 1; 502 malformed provider response;\n503 dependency or saved-state unavailable; 504 provider verification timeout.\nAn outage is not reported as an invalid customer. Raw provider error bodies and\ncredentials are not returned. Clients should retain RequestID before sending.\n\nIf a purchase was attempted but its result cannot be confirmed, the error retains\nrequestid, outcome=UNKNOWN, orderid when available, and next_action. An unavailable\npost-purchase status read returns ORDER_STATUS_UNAVAILABLE with saved=true when\nthe save was confirmed. Query the same reference before another purchase. Never\nautomatically submit a purchase again because a response is 5xx or a lookup is 404.\nORDER_NOT_FOUND describes an unsuccessful order lookup; it is not proof that no purchase occurred. PIN detail availability is separate from status.\n\nWallet and current-order money fields are decimal strings with two decimal places\nand no grouping commas. Dates are ISO 8601 with the database server's UTC offset,\nfor example 2026-11-02T12:00:00+01:00. Catalogue schemas and prices are unchanged.\nCable TV uses the submitted MobileNumber; betting uses submitted PhoneNo when\npresent, otherwise the authenticated member's phone. These phone fields accept\nlocal 0-prefixed and +234/234 formats. Accepted Memo is passed to purchase storage.\n\nLimits are shared across each category per source IP, per IIS worker: 30 purchase\nrequests/second, 10 verification requests/second, 60 authenticated-route GET\nrequests/second. Invalid credentials also consume the category limit. Health,\nOPTIONS, documentation and private helper calls are excluded. Counters are bounded\nin memory and reset on application recycle; this is not a distributed account\nquota. A full counter bucket also returns 429 until the next second.\n\nThe response header X-Rest-Contract: 20261102-2 identifies this deployment.\nExisting REST route names, request fields, standard key authentication, financial\nfunctions, delivery mapping, commission and database procedures are retained.\nThis response contract applies only to api.nellobytesystems.com/v1.\n\n\nREST purchase protection (contract 20261102-3)\n\nAll ten purchase routes retain a durable request receipt keyed by the authenticated\nmember and RequestID. Keep the same route and field values for an identical retry.\nJSON property order and property-name casing do not affect identity. Missing and\nempty optional fields are equivalent; different supplied field values (including\nnumeric spellings, Memo and callback URL) are conservatively treated as a conflict.\nThe database stores a SHA-256 fingerprint, not the raw request or API key.\n\nAn identical saved request returns its CURRENT operational order status without\nanother purchase. Idempotent-Replayed: true identifies a replay. Changed details\nor another product with the same member/RequestID return HTTP 409 REQUEST_ID_CONFLICT.\nA request still processing, interrupted, or with uncertain save outcome returns\nHTTP 409 REQUEST_OUTCOME_PENDING_REVIEW. Query GET /orders using RequestID or\ncontact support; do not replace the RequestID to work around that response.\nRequests rejected before purchase SQL retain their rejection. Corrected purchases\nuse a new RequestID only once the previous rejection is definite.\n\nNew successful purchase/RequestID responses include wallet_before and wallet_after,\ndecimal strings describing the saved request's wallet snapshots. They are captured\ninside the purchase transaction and exposed only after commit, including batches.\nThey describe the original purchase, not the customer's current wallet after later\nactivity or a refund. GET /wallet remains the current wallet observation.\nFor an older airtime request adopted by its existing replay mechanism, unavailable\nhistorical wallet snapshots are empty rather than invented.\n\nReceipt and source-item writes commit with the debit/order. If the order fails,\nthose writes roll back while the initial pending claim is retained for review.\nThere is no automatic claim expiry or repeat purchase after an ambiguous failure.\nAn old receipt cannot be reused just because its operational record is no longer available:\nthe receipt persists, and unavailable current status returns 503 with saved=true.\nRetained display details cannot authorize financial operations.\n\nThese protections cover REST requests first submitted after deployment. Prior\nunconfirmed requests and legacy endpoints are not backfilled into this ledger.\nDo not re-submit a pre-deployment uncertain request; reconcile its saved payment.\nExisting pricing, cashback, delivery mapping and legacy endpoints stay unchanged.\n\n\ne-PIN asynchronous responses (20261103-1)\n\nPOST /orders/epin and /orders/databundle-epin return HTTP 202 Accepted while a\nconfirmed saved order is waiting for its complete PIN batch. The JSON retains\nthe current saved status, orderid, requestid and wallet snapshots. Location and\nstatus_url point to GET /v1/orders?OrderID=...&IncludePINs=false; Retry-After and\nretry_after_seconds suggest five seconds before the next lookup. A batch already\nready returns HTTP 200 with detailsstatus AVAILABLE and its existing PIN array.\nSaved RequestID replays follow the same rule without another purchase. An\nunconfirmed save is never converted into an accepted order.\n\nGET /orders accepts optional IncludePINs=true|false (default true). Exactly one\nOrderID, RequestID or BatchNo is still required. Both modes require the same\nmember authentication. false returns status and readiness without transferring\nPIN values; true includes the complete owned PIN batch when ready. pins_url\npoints to the full lookup. These links contain no credentials.\n\nGET returns HTTP 200 while the PIN batch is PENDING. AVAILABLE means all requested\nPINs were readable at that observation. An incomplete batch returns PENDING and\nno partial PIN array. A SQL failure, invalid batch or conflicting PIN data returns\nHTTP 503 with UNAVAILABLE, not a generation result. NOT_APPLICABLE means the order\nis failed, cancelled or refunded; stop polling. The saved financial status is\npreserved: ORDER_COMPLETED alone does not guarantee PIN readiness. Check\ndetailsstatus, and require AVAILABLE with the PIN array before delivering PINs.\n\nPoll from your application: start after five seconds, then back off to 10, 20 and\n30 seconds; stop after a bounded number of attempts. A polling timeout is not a\npurchase failure or permission to refund/rebuy. Retain and query the same order\nor RequestID later. Lost POST responses are queried by RequestID. No new job,\nwebhook delivery system or PIN generator is installed by this update. Normal\ngeneration continues independently; lookup latency is not generation time.\nThe current data e-PIN purchase function creates its batch before committing,\nso it normally returns 200 with AVAILABLE. Its generation is not moved to a\nbackground worker here; the shared reader handles any later pending observation.\n\nFor large batches, use IncludePINs=false until AVAILABLE, then retrieve the PINs\nonce with IncludePINs=true. PIN retrieval is still a full batch, not pagination.\nCounts are bounded at 10,001 rows for the existing 10,000-PIN maximum; this reduces\npayloads but is not a guarantee of zero database load or blocking.\n\nepin-polling.mjs is a server-side integration example using authenticated GETs\nonly, with bounded polling and 30-second per-request timeouts. Import waitForEpin\nand pass orderId, memberId and apiKey from your secure server configuration.\nIt never submits a purchase; store the returned PINs securely and do not log them.\nIt uses the fixed API origin and rejects redirects. Do not embed a member API key\nin public browser code. No automatic collection runner or purchase retry is added.\n"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Location","value":"/v1/orders?OrderID=123&IncludePINs=false"},{"key":"Retry-After","value":"5"},{"key":"X-Rest-EPIN-Async","value":"20261103-1"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_RECEIVED\",\n \"orderid\": \"123\",\n \"transactionid\": \"123\",\n \"requestid\": \"example-epin-001\",\n \"detailsstatus\": \"PENDING\",\n \"status_url\": \"/v1/orders?OrderID=123&IncludePINs=false\",\n \"pins_url\": \"/v1/orders?OrderID=123&IncludePINs=true\",\n \"retry_after_seconds\": 5\n}"}],"_postman_id":"5b42419e-7813-4d4b-9af4-58fe4f808bd3"}],"id":"0c2944db-f749-468f-86c3-7105d516c336","description":"

Read airtime e-PIN discounts and generate an intentional batch. Generated PINs are private and should not be published in examples.

\n","_postman_id":"0c2944db-f749-468f-86c3-7105d516c336","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Data e-PINs","item":[{"name":"Generate data e-PINs","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Save the confirmed order ID only. Never repeat or chain a purchase.","if (pm.response.code === 200 || pm.response.code === 202) {"," const order = pm.response.json();"," if (order.orderid) pm.collectionVariables.set(\"orderId\", String(order.orderid));","}"],"id":"b39ca4fc-033d-4669-826d-ba2927d6c8ba"}}],"id":"e557ae1c-5aa6-4fbb-a956-7a4e8ae19500","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle-epin","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

e-PIN asynchronous responses (20261103-1)

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}},"urlObject":{"path":["orders","databundle-epin"],"host":["https://api.nellobytesystems.com/v1"],"query":[],"variable":[]}},"response":[{"id":"6e9e2060-088f-456c-8d70-6a352fdbd251","name":"Illustrative current saved completion","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle-epin"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_COMPLETED\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"producttype\": \"AirTime\",\n \"productname\": \"100 Credit\",\n \"amount\": \"100.00\",\n \"amountcredited\": \"\",\n \"walletbalance\": \"1000.00\",\n \"paymentoption\": \"Wallet\",\n \"remark\": \"Example saved operator completion message.\",\n \"mobilenetwork\": \"MTN\",\n \"mobilenumber\": \"EXAMPLE_PHONE\",\n \"smartcardno\": \"\",\n \"meterno\": \"\",\n \"metertoken\": \"\",\n \"customerid\": \"\",\n \"carddetails\": \"\",\n \"profileid\": \"\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"TXN_EPIN_DATABUNDLE\": [\n {\n \"transactionid\": \"EXAMPLE_ORDER_ID\",\n \"transactiondate\": \"2026-11-02T12:00:00+01:00\",\n \"batchno\": \"EXAMPLE_BATCH\",\n \"mobilenetwork\": \"MTN\",\n \"sno\": \"EXAMPLE_SERIAL\",\n \"pin\": \"EXAMPLE_PIN_NOT_VALID\",\n \"productname\": \"500MB - Weekly (SME)\"\n }\n ],\n \"detailsstatus\": \"AVAILABLE\",\n \"ORDER_ID\": \"EXAMPLE_ORDER_ID\"\n}"},{"id":"6c81d2d7-0897-4800-87ca-fb9f0409e484","name":"Missing authentication headers","originalRequest":{"auth":{"type":"noauth"},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle-epin"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_CREDENTIALS\",\n \"message\": \"missing credentials\"\n}"},{"id":"0bcbeb56-5e07-42e3-8510-8e1332571450","name":"Missing RequestID (rejected before purchase)","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"Quantity\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle-epin"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"MISSING_REQUESTID\",\n \"message\": \"missing requestid\"\n}"},{"id":"d4619bba-3627-4d23-bfff-c3aaebd5eccb","name":"Current status unavailable - query existing reference","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle-epin"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_STATUS_UNAVAILABLE\",\n \"orderid\": \"EXAMPLE_ORDER_ID\",\n \"requestid\": \"example-order-001\",\n \"saved\": true,\n \"message\": \"Current status could not be read. Query this order or RequestID again; do not submit another purchase.\"\n}"},{"id":"b02ea0ba-e369-4134-99de-ea90bf72a7d4","name":"Accepted e-PIN batch - poll existing order","originalRequest":{"method":"POST","header":[{"key":"X-User-ID","value":"","description":"Required member ID corresponding to the Bearer API key."},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"\",\n \"DataPlan\": \"\",\n \"Quantity\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/databundle-epin","description":"Purchase responses and GET /orders use the same current saved-status reader. Status is observed after the financial operation commits; the API does not wait for delivery or send another purchase. A response may already be ORDER_COMPLETED, or remain ORDER_RECEIVED / ORDER_PROCESSING. Poll GET /orders with the same OrderID or RequestID to observe later progress.\n\nEvery successfully read order has `status`, `orderid`, `transactionid`, `requestid`, `transactiondate`, `producttype`, `productname`, `amount`, `walletbalance`, `paymentoption` and `remark`, plus product-specific details. Empty detail fields are empty strings. `remark` is the actual saved operator/admin comment, JSON escaped; a generic success message is not substituted. An explicit pending completion receipt keeps status ORDER_PROCESSING and withholds staged final remarks/tokens until completion is saved. Dates are ISO 8601 with the database server UTC offset; amount and walletbalance are decimal strings without grouping commas. `amount` uses the saved debit where present, and `amountcredited` describes a positive saved credit (not cashback).\n\n| Status | Meaning |\n| --- | --- |\n| ORDER_RECEIVED | Saved Paid state; delivery not yet confirmed. |\n| ORDER_PENDING | Saved Pending state. |\n| ORDER_PROCESSING | Processing, or awaiting the final completion receipt. |\n| ORDER_PROCESSED | Saved Processed state; not equivalent to Completed. |\n| ORDER_COMPLETED | Saved Completed state with no pending completion marker. |\n| ORDER_REFUNDED | Saved Refunded state. |\n| ORDER_CANCELLED | Saved Cancelled state. |\n| ORDER_FAILED | Saved Failed state; this response does not itself refund anything. |\n| ORDER_FINISHED_WITH_FAILURES | All children finished, with mixed completed/refunded/cancelled/failed states. |\n| ORDER_STATUS_UNAVAILABLE | Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response. |\n| ORDER_NOT_FOUND | No owned order was found for the supplied selector. This does not prove no earlier payment occurred. |\n\nAn unavailable post-purchase read retains `orderid`, `requestid`, and `saved: true`. HTTP 200 alone does not establish completion. Read failures use HTTP 503; missing owned orders use HTTP 404. Other errors use the REST error contract.\n\nFor a multi-phone airtime request, the top-level status covers the entire request and `orders` contains each child's receipt. Missing or ambiguous source records produce ORDER_STATUS_UNAVAILABLE. For operational orders, GET by a child's order ID returns the request group when its request metadata is available.\n\ne-PIN orders retain `TXN_EPIN` or `TXN_EPIN_DATABUNDLE` when their complete owned batch is available, together with `ORDER_ID` and `detailsstatus: AVAILABLE`. `detailsstatus: PENDING` or `UNAVAILABLE` does not change the financial status or authorize another purchase. Retry the existing order lookup for unavailable PIN details. No provider requery, vend, callback, refund or wallet update is performed by this status reader.\n\nREST response contract (20261102-2)\n\nSuccessful business responses use HTTP 200. Always inspect the JSON status: a saved\npurchase may still be ORDER_RECEIVED, ORDER_PENDING or ORDER_PROCESSING. Only a\nsaved completion returns ORDER_COMPLETED. Purchase and order lookups use the same\noperational status reader; no provider purchase is retried by response formatting.\n\nWallet: status=WALLET_SUCCESS, id, phoneno, balance, currency=NGN, date.\nVerification: status=VERIFIED, valid=true, customer_name, validation_reference.\nAn optional customer name/reference can be empty when the provider explicitly\nconfirms that no validation reference is required. Verification does not vend.\n\nErrors use a non-200 HTTP status and JSON status/message:\n400 malformed request; 401 missing or invalid credentials; 403 blocked account,\nIP restriction, HTTPS or KYC requirement; 404 owned order not found;\n405 unsupported method; 413 oversized body; 415 unsupported content type;\n422 invalid input, business rejection, or VERIFICATION_REJECTED with valid=false;\n429 rate limit with Retry-After: 1; 502 malformed provider response;\n503 dependency or saved-state unavailable; 504 provider verification timeout.\nAn outage is not reported as an invalid customer. Raw provider error bodies and\ncredentials are not returned. Clients should retain RequestID before sending.\n\nIf a purchase was attempted but its result cannot be confirmed, the error retains\nrequestid, outcome=UNKNOWN, orderid when available, and next_action. An unavailable\npost-purchase status read returns ORDER_STATUS_UNAVAILABLE with saved=true when\nthe save was confirmed. Query the same reference before another purchase. Never\nautomatically submit a purchase again because a response is 5xx or a lookup is 404.\nORDER_NOT_FOUND describes an unsuccessful order lookup; it is not proof that no purchase occurred. PIN detail availability is separate from status.\n\nWallet and current-order money fields are decimal strings with two decimal places\nand no grouping commas. Dates are ISO 8601 with the database server's UTC offset,\nfor example 2026-11-02T12:00:00+01:00. Catalogue schemas and prices are unchanged.\nCable TV uses the submitted MobileNumber; betting uses submitted PhoneNo when\npresent, otherwise the authenticated member's phone. These phone fields accept\nlocal 0-prefixed and +234/234 formats. Accepted Memo is passed to purchase storage.\n\nLimits are shared across each category per source IP, per IIS worker: 30 purchase\nrequests/second, 10 verification requests/second, 60 authenticated-route GET\nrequests/second. Invalid credentials also consume the category limit. Health,\nOPTIONS, documentation and private helper calls are excluded. Counters are bounded\nin memory and reset on application recycle; this is not a distributed account\nquota. A full counter bucket also returns 429 until the next second.\n\nThe response header X-Rest-Contract: 20261102-2 identifies this deployment.\nExisting REST route names, request fields, standard key authentication, financial\nfunctions, delivery mapping, commission and database procedures are retained.\nThis response contract applies only to api.nellobytesystems.com/v1.\n\n\nREST purchase protection (contract 20261102-3)\n\nAll ten purchase routes retain a durable request receipt keyed by the authenticated\nmember and RequestID. Keep the same route and field values for an identical retry.\nJSON property order and property-name casing do not affect identity. Missing and\nempty optional fields are equivalent; different supplied field values (including\nnumeric spellings, Memo and callback URL) are conservatively treated as a conflict.\nThe database stores a SHA-256 fingerprint, not the raw request or API key.\n\nAn identical saved request returns its CURRENT operational order status without\nanother purchase. Idempotent-Replayed: true identifies a replay. Changed details\nor another product with the same member/RequestID return HTTP 409 REQUEST_ID_CONFLICT.\nA request still processing, interrupted, or with uncertain save outcome returns\nHTTP 409 REQUEST_OUTCOME_PENDING_REVIEW. Query GET /orders using RequestID or\ncontact support; do not replace the RequestID to work around that response.\nRequests rejected before purchase SQL retain their rejection. Corrected purchases\nuse a new RequestID only once the previous rejection is definite.\n\nNew successful purchase/RequestID responses include wallet_before and wallet_after,\ndecimal strings describing the saved request's wallet snapshots. They are captured\ninside the purchase transaction and exposed only after commit, including batches.\nThey describe the original purchase, not the customer's current wallet after later\nactivity or a refund. GET /wallet remains the current wallet observation.\nFor an older airtime request adopted by its existing replay mechanism, unavailable\nhistorical wallet snapshots are empty rather than invented.\n\nReceipt and source-item writes commit with the debit/order. If the order fails,\nthose writes roll back while the initial pending claim is retained for review.\nThere is no automatic claim expiry or repeat purchase after an ambiguous failure.\nAn old receipt cannot be reused just because its operational record is no longer available:\nthe receipt persists, and unavailable current status returns 503 with saved=true.\nRetained display details cannot authorize financial operations.\n\nThese protections cover REST requests first submitted after deployment. Prior\nunconfirmed requests and legacy endpoints are not backfilled into this ledger.\nDo not re-submit a pre-deployment uncertain request; reconcile its saved payment.\nExisting pricing, cashback, delivery mapping and legacy endpoints stay unchanged.\n\n\ne-PIN asynchronous responses (20261103-1)\n\nPOST /orders/epin and /orders/databundle-epin return HTTP 202 Accepted while a\nconfirmed saved order is waiting for its complete PIN batch. The JSON retains\nthe current saved status, orderid, requestid and wallet snapshots. Location and\nstatus_url point to GET /v1/orders?OrderID=...&IncludePINs=false; Retry-After and\nretry_after_seconds suggest five seconds before the next lookup. A batch already\nready returns HTTP 200 with detailsstatus AVAILABLE and its existing PIN array.\nSaved RequestID replays follow the same rule without another purchase. An\nunconfirmed save is never converted into an accepted order.\n\nGET /orders accepts optional IncludePINs=true|false (default true). Exactly one\nOrderID, RequestID or BatchNo is still required. Both modes require the same\nmember authentication. false returns status and readiness without transferring\nPIN values; true includes the complete owned PIN batch when ready. pins_url\npoints to the full lookup. These links contain no credentials.\n\nGET returns HTTP 200 while the PIN batch is PENDING. AVAILABLE means all requested\nPINs were readable at that observation. An incomplete batch returns PENDING and\nno partial PIN array. A SQL failure, invalid batch or conflicting PIN data returns\nHTTP 503 with UNAVAILABLE, not a generation result. NOT_APPLICABLE means the order\nis failed, cancelled or refunded; stop polling. The saved financial status is\npreserved: ORDER_COMPLETED alone does not guarantee PIN readiness. Check\ndetailsstatus, and require AVAILABLE with the PIN array before delivering PINs.\n\nPoll from your application: start after five seconds, then back off to 10, 20 and\n30 seconds; stop after a bounded number of attempts. A polling timeout is not a\npurchase failure or permission to refund/rebuy. Retain and query the same order\nor RequestID later. Lost POST responses are queried by RequestID. No new job,\nwebhook delivery system or PIN generator is installed by this update. Normal\ngeneration continues independently; lookup latency is not generation time.\nThe current data e-PIN purchase function creates its batch before committing,\nso it normally returns 200 with AVAILABLE. Its generation is not moved to a\nbackground worker here; the shared reader handles any later pending observation.\n\nFor large batches, use IncludePINs=false until AVAILABLE, then retrieve the PINs\nonce with IncludePINs=true. PIN retrieval is still a full batch, not pagination.\nCounts are bounded at 10,001 rows for the existing 10,000-PIN maximum; this reduces\npayloads but is not a guarantee of zero database load or blocking.\n\nepin-polling.mjs is a server-side integration example using authenticated GETs\nonly, with bounded polling and 30-second per-request timeouts. Import waitForEpin\nand pass orderId, memberId and apiKey from your secure server configuration.\nIt never submits a purchase; store the returned PINs securely and do not log them.\nIt uses the fixed API origin and rejects redirects. Do not embed a member API key\nin public browser code. No automatic collection runner or purchase retry is added.\n"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Location","value":"/v1/orders?OrderID=123&IncludePINs=false"},{"key":"Retry-After","value":"5"},{"key":"X-Rest-EPIN-Async","value":"20261103-1"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ORDER_RECEIVED\",\n \"orderid\": \"123\",\n \"transactionid\": \"123\",\n \"requestid\": \"example-epin-001\",\n \"detailsstatus\": \"PENDING\",\n \"status_url\": \"/v1/orders?OrderID=123&IncludePINs=false\",\n \"pins_url\": \"/v1/orders?OrderID=123&IncludePINs=true\",\n \"retry_after_seconds\": 5\n}"}],"_postman_id":"e557ae1c-5aa6-4fbb-a956-7a4e8ae19500"}],"id":"2b015dcb-1499-410c-8ffc-4a477a80efa5","description":"

Use Mobile data / Data plans for PRODUCT_CODE and network ID, then generate the requested quantity. Store returned PINs privately.

\n","_postman_id":"2b015dcb-1499-410c-8ffc-4a477a80efa5","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"Smile","item":[{"name":"Smile packages","id":"e856e744-d49d-4b5b-b561-eec899f59ba3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/smile/packages","description":"

Read MOBILE_NETWORK[\"smile-direct\"][].PRODUCT[]. Use ID as MobileNetwork and PACKAGE_ID as DataPlan. This is separate from mobile-data PRODUCT_CODE.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"smile-direct\",\n \"DataPlan\": \"\",\n \"MobileNumber\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/smile","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"MobileNetwork\": \"smile-direct\",\n \"MobileNumber\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/verify/smile","description":"

Read-only provider verification. No purchase is made.

REST response contract (20261102-2)

Use the Smile package catalogue, verify the Smile account and place an order. MobileNumber here is the Smile account identifier.

\n","_postman_id":"d1b35ad2-9ad7-4fa0-a5de-9f26a4135786","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"WAEC","item":[{"name":"WAEC packages","id":"f633d696-07c5-40c6-ab1c-bf2cd73a9da4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/waec/packages","description":"

Read EXAM_TYPE[]. Use PRODUCT_CODE as ExamType; PRODUCT_DESCRIPTION and PRODUCT_AMOUNT describe the current product.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"ExamType\": \"\",\n \"PhoneNo\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/waec","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Load current examination products and select PRODUCT_CODE as ExamType before ordering.

\n","_postman_id":"5c0ffc0f-90a3-4334-8ce0-877be0f4d35f","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}},{"name":"JAMB","item":[{"name":"JAMB packages","id":"3d5c8cbe-7c6c-48aa-8b89-8e8af7768779","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-ID","value":"","description":"

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"}],"url":"https://api.nellobytesystems.com/v1/jamb/packages","description":"

Read EXAM_TYPE[]. Use PRODUCT_CODE as ExamType; do not hard-code a previous examination product or price.

Authentication: Collection Bearer Token (apiKey) plus the X-User-ID: header.

Parameters: None. Do not add query parameters or a request body.

Saved response examples are illustrative, not live responses or current prices.

REST response contract (20261102-2)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"ExamType\": \"\",\n \"ProfileID\": \"\",\n \"PhoneNo\": \"\",\n \"RequestID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/orders/jamb","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Meaning
ORDER_RECEIVED	Saved Paid state; delivery not yet confirmed.
ORDER_PENDING	Saved Pending state.
ORDER_PROCESSING	Processing, or awaiting the final completion receipt.
ORDER_PROCESSED	Saved Processed state; not equivalent to Completed.
ORDER_COMPLETED	Saved Completed state with no pending completion marker.
ORDER_REFUNDED	Saved Refunded state.
ORDER_CANCELLED	Saved Cancelled state.
ORDER_FAILED	Saved Failed state; this response does not itself refund anything.
ORDER_FINISHED_WITH_FAILURES	All children finished, with mixed completed/refunded/cancelled/failed states.
ORDER_STATUS_UNAVAILABLE	Status could not be confirmed; retain the reference and query again. Never infer failure or resubmit a purchase from this response.
ORDER_NOT_FOUND	No owned order was found for the supplied selector. This does not prove no earlier payment occurred.

REST response contract (20261102-2)

REST purchase protection (contract 20261102-3)

Required member ID corresponding to the Bearer API key.

\n"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"ExamType\": \"\",\n \"ProfileID\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.nellobytesystems.com/v1/verify/jamb","description":"

Read-only provider verification. No purchase is made.

REST response contract (20261102-2)

Load current examination products, verify the profile and select PRODUCT_CODE as ExamType before ordering.

\n","_postman_id":"36cac83d-8589-4ea5-a399-29f4f3fae802","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","id":"5e6673d7-0a01-4c5c-8978-c9ec295509ab","name":"Nellobyte REST API v1","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"variable":[{"key":"baseUrl","value":"https://api.nellobytesystems.com/v1","description":"Production HTTPS base URL without a trailing slash."},{"key":"memberId","value":"","description":"Set your member ID locally. Keep the shared value blank."},{"key":"apiKey","value":"","description":"Set the member standard API key locally or use Postman Vault. Never share or publish it."},{"key":"requestId","value":"","description":"Choose once per intended purchase; retain for query/reconciliation. No automatic regeneration."},{"key":"orderId","value":"","description":"Copy the original order identifier after purchase."},{"key":"batchNo","value":"","description":"Copy a saved PIN batch reference."},{"key":"mobileNetwork","value":"","description":"NETWORK_ID from the airtime/data catalogue, such as 01."},{"key":"mobileNumber","value":"","description":"Destination phone number; keep leading zeroes."},{"key":"phoneNo","value":"","description":"Contact phone number; keep leading zeroes."},{"key":"amount","value":"","description":"Intended monetary amount in naira without commas."},{"key":"dataPlanCode","value":"","description":"Current PRODUCT_CODE from the chosen data network."},{"key":"cableTv","value":"","description":"TV_ID from Cable TV providers."},{"key":"cablePackage","value":"","description":"PACKAGE_ID for the chosen cable provider."},{"key":"smartCardNo","value":"","description":"Verified smart-card/IUC number."},{"key":"electricCompany","value":"","description":"Current company ID from Electricity discos."},{"key":"meterNo","value":"","description":"Verified meter number."},{"key":"meterType","value":"","description":"prepaid or postpaid, matching verification."},{"key":"bettingCompany","value":"","description":"PRODUCT_CODE from Betting providers."},{"key":"customerId","value":"","description":"Verified betting customer identifier."},{"key":"epinValue","value":"","description":"Requested airtime recharge-card denomination."},{"key":"quantity","value":"","description":"Intentional number of PINs, a positive integer."},{"key":"smileNetwork","value":"smile-direct","description":"Smile network ID from its catalogue."},{"key":"smilePackage","value":"","description":"PACKAGE_ID from Smile packages."},{"key":"smileAccount","value":"","description":"Verified Smile account identifier."},{"key":"waecExamType","value":"","description":"PRODUCT_CODE from WAEC packages."},{"key":"jambExamType","value":"","description":"PRODUCT_CODE from JAMB packages."},{"key":"profileId","value":"","description":"Verified JAMB profile identifier."}]}