Preview: the API is being built and these endpoints may change
Integrate with a coding agent
The prompt to paste into your coding agent, and the files it should read.
Every page of these docs is plain markdown at its own address, so a coding agent can read exactly what you read. Paste this into your agent and it has what it needs.
text
Integrate SimConnectNG into this project to sell airtime and data.
Read these first:
- https://simconnectng.com/llms.txt (index of every docs page)
- https://simconnectng.com/docs/quickstart.md
- https://simconnectng.com/docs/concepts/idempotency.md
- https://simconnectng.com/docs/concepts/webhooks.md
Rules:
- Read the API key from the SIMCONNECT_KEY environment variable. Never hardcode it.
- The base URL is https://api.simconnectng.com/api/v1. Every response is { success, data, message, code }; branch on code.
- Send an Idempotency-Key with every sale (POST /api/v1/airtime, POST /api/v1/data), derived from our own order id.
- Name what to sell with product_code (such as MTN-VTU for airtime or MTN-SHARE-1GB-30D for data) and the number with phone_number.
- Treat the transaction status as the truth: successful or failed is final; anything else, such as pending, is still on its way.
- Lists are data.items; follow data.page.next_cursor with the cursor query parameter.
- Verify the SimConnect-Signature header on every webhook before using it.
- Amounts are naira, numbers with at most two decimals.
- Use test mode (a scn_test_ key) until I say otherwise.What the agent should end up with
- A small client that sends airtime and data with an idempotency key.
- A webhook handler that checks the signature and updates your order by
client_reference. - A test that sends to a number ending in
0000and handles the failure.
Files for agents
| File | What it holds |
|---|---|
/llms.txt | Every docs page, one line each, with its markdown address |
/llms-full.txt | Every docs page in one file |
/docs/<page>.md | Any single page as markdown |