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

# PrimePay developer docs

> Collect mobile money payments, send money and create payment links in Malawi with the PrimePay API.

PrimePay lets your business take payments from **Airtel Money**, **TNM Mpamba** and **PrimePay Wallet** customers, and send money out to mobile money numbers, bank accounts, other merchants and PrimePay wallets. Everything you can do in the [dashboard](https://dashboard.primepay.mw/) for money in and money out, you can do from your own system with the API.

All amounts are in Malawi Kwacha (`MWK`).

## What you can build

> [card] [Payments](https://docs.primepay.mw/api-reference/payments-overview.md)
>
> Ask a customer to pay from their mobile money account. They approve on their phone and you get the result by webhook.

> [card] [Hosted checkout](https://docs.primepay.mw/api-reference/checkout-overview.md)
>
> Send customers from your website to a PrimePay payment page for one order, then confirm the result on your server.

> [card] [Payment links](https://docs.primepay.mw/api-reference/payment-links-overview.md)
>
> Make a checkout address you send by WhatsApp, SMS, email or QR code. No checkout page to build.

> [card] [Transfers](https://docs.primepay.mw/api-reference/transfers-overview.md)
>
> Move money to another merchant account or a PrimePay wallet.

> [card] [Payouts](https://docs.primepay.mw/api-reference/payouts-overview.md)
>
> Send money to Airtel Money, TNM Mpamba and bank accounts.

## How an integration works

**1. Get your keys**

Sign in to the [dashboard](https://dashboard.primepay.mw/), open your account and copy its API keys. Test keys (`sk_test_…`) work on the sandbox API; live keys (`sk_live_…`) work on the live API once your business is verified.

**2. Build against the sandbox**

The sandbox behaves like the live API, with money that isn't real. Follow the [quickstart](https://docs.primepay.mw/quickstart.md) to take your first test payment in a few minutes.

**3. Receive results by webhook**

Mobile money payments finish on the customer's phone, so the result arrives later. Add a webhook endpoint under **Settings › Webhooks** and PrimePay calls it when a payment succeeds or fails. See [Webhooks](https://docs.primepay.mw/api-reference/webhooks.md).

**4. Go live**

List your server's addresses under **Settings › Security**, switch to your live keys and the live API address. Nothing else changes.

## The two environments

| Environment | API address | Keys |
| - | - | - |
| Sandbox | `https://sandbox-api.primepay.mw` | Test keys, `sk_test_…` |
| Live | `https://api.primepay.mw` | Live keys, `sk_live_…` |

> [card] [Start with the quickstart](https://docs.primepay.mw/quickstart.md)
>
> Take a test payment from start to finish.


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