> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesh.larkwave.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Collect payments, hold money and move it, on your bank's rails, with one API.

Mesh is the developer API your bank offers its merchants, built by Larkwave. With one API key your systems can:

* **Collect payments** into virtual accounts: permanent collection accounts, or a one-off account for a single invoice or order.
* **Hold money** in wallets for your business and your customers, each held to the customer's KYC tier.
* **Move money**: between wallets, to any Nigerian bank, or to your own account at the bank.
* **Hear about it** as it happens, through signed webhooks or by polling events.

Everything you create through Mesh also appears in your bank's merchant portal, because both read the same records.

> [card] [Quickstart](https://docs.mesh.larkwave.org/quickstart.md)
>
> Make your first call and take a test payment in a few minutes.

> [card] [How Mesh works](https://docs.mesh.larkwave.org/how-mesh-works.md)
>
> Where Mesh runs and how a call reaches your bank's ledger.

> [card] [Authentication](https://docs.mesh.larkwave.org/essentials/authentication.md)
>
> API keys, IP allowlists and what a key may do.

> [card] [API reference](https://docs.mesh.larkwave.org/api-reference/introduction.md)
>
> Every endpoint, with a playground.

## The basics

| | |
| - | - |
| **Base URL** | `https://<your bank's Mesh host>/v1/...`. Your bank gives you the host. |
| **Authentication** | An `X-Api-Key` header, sent from an IP address on the key's allowlist. |
| **Test and live** | One URL. An `lsk_test_` key reaches the bank's sandbox; an `lsk_live_` key reaches real money. |
| **Format** | JSON, with `snake_case` fields. Amounts are integers in kobo (`amount_minor`). |
| **Responses** | Always `success`, `data`, `message` and `request_id`, plus a numeric `code` on failure. |
| **Creating** | Every create takes an `Idempotency-Key` header, so a retry never creates twice. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.