# WA Gateway

> WA Gateway connects your WhatsApp number to your website, shop, ERP and AI agents: send order updates, invoices and reminders, receive replies by webhook, and pay by M-Pesa or card.

WA Gateway is a WhatsApp gateway: an account links WhatsApp numbers (as linked devices, like WhatsApp Web), then sends and receives messages through a REST API, signed webhooks or an MCP server. Billing is by plan, paid by M-Pesa or card through IntaSend.

## Rules for agents

- Sign-up needs the owner: a 6-digit code goes to their WhatsApp and must be confirmed. Ask them for it.
- Payments need the owner: you can start one, they approve it with their M-Pesa PIN or on the checkout page.
- Only message people who expect it. Unsolicited bulk messages get numbers banned by WhatsApp.
- Keep API keys secret; send them only as `Authorization: Bearer <key>`.

## Quick start

1. List plans: `GET https://whatsapp.nergaa.cloud/api/v1/plans`
2. Start sign-up: `POST https://whatsapp.nergaa.cloud/api/v1/signup` with {email, phone, name}. The owner receives a code.
3. Confirm: `POST https://whatsapp.nergaa.cloud/api/v1/signup/verify` with {email, code}. Returns `api_key` and the first number's `instance_id`.
4. Link the number: `POST https://whatsapp.nergaa.cloud/api/v1/instances/{id}/start` returns a QR code (PNG data URL) for the owner to scan in WhatsApp → Linked devices. Or `POST …/pair` with {phone} for a code to type.
5. Send: `POST https://whatsapp.nergaa.cloud/api/v1/instances/{id}/send` with {to: "254712345678", text: "…"}.
6. Receive: `POST https://whatsapp.nergaa.cloud/api/v1/webhooks` with {url, events: ["message"]}.
7. Pay: `GET https://whatsapp.nergaa.cloud/api/v1/billing`, then `POST https://whatsapp.nergaa.cloud/api/v1/billing/pay` with {plan_id, method: "mpesa", phone} or {method: "checkout"} (gives a checkout_url for the owner). Follow `GET …/billing/payments/{id}`.

## Links

- [API reference](https://whatsapp.nergaa.cloud/docs): every endpoint with examples
- [OpenAPI 3.1](https://whatsapp.nergaa.cloud/openapi.json): machine-readable
- [MCP server](https://whatsapp.nergaa.cloud/mcp): Streamable HTTP; tools for sign-up, numbers, messages, webhooks, billing
- [Pricing](https://whatsapp.nergaa.cloud/pricing)
- [Integrations](https://whatsapp.nergaa.cloud/integrations): WooCommerce, Shopify, ERPNext, n8n, Zapier, Make
- [Full reference for LLMs](https://whatsapp.nergaa.cloud/llms-full.txt)

## Plans

- Starter (id `pln_c3813edb4c05d108bd22`): Free, 1 number(s), 5000 messages/month, 5-day trial
- Test (id `pln_df0211fccbb2294ae016`): USD 1 per month, 1 number(s), 1000 messages/month, 1-day trial
- Basic (id `pln_e85873bf89715ee1c1df`): USD 2 per month, 1 number(s), 1000 messages/month, 5-day trial
- Basic Fremium (id `pln_a78f4d2f4d4c52a5af81`): USD 5 per month, 3 number(s), unlimited messages, 5-day trial
- Premium (id `pln_c989131a9c4f8a118886`): USD 20 per month, 10 number(s), unlimited messages, 5-day trial