---
title: Integrate with a coding agent
nav: Coding agents
description: The prompt to paste into your coding agent, and the files it should read.
group: start
order: 3
---

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 `0000` and 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 |