> ## 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 API v1

> Collect mobile money payments, send transfers and make payouts with the PrimePay API.

Version 1 of the PrimePay API covers:

* **Payments**: collecting money from customers by mobile money.
* **Transfers**: moving money to merchant accounts and PrimePay wallets.
* **Payouts**: sending money to Airtel Money, TNM Mpamba and bank accounts.
* **Payment links**: a checkout address you send to a customer.
* **Checkout sessions**: a PrimePay payment page for one order on your website.

## Environments

| Environment | Address | Keys |
| - | - | - |
| Live | `https://api.primepay.mw` | Live keys (`sk_live_…`) |
| Sandbox | `https://sandbox-api.primepay.mw` | Test keys (`sk_test_…`). Sandbox money is never real and can't reach live accounts. |

All requests and responses are JSON. Amounts are decimal numbers in Malawi Kwacha (`MWK`) with at most 2 decimal places.

> [card] [Authentication](https://docs.primepay.mw/api-reference/authentication.md)
>
> API keys and the server IP list.

> [card] [Idempotency](https://docs.primepay.mw/api-reference/idempotency.md)
>
> Retry safely without double charges.

> [card] [Errors](https://docs.primepay.mw/api-reference/errors.md)
>
> The error shape every endpoint uses.

> [card] [Testing in sandbox](https://docs.primepay.mw/api-reference/sandbox.md)
>
> Test without real money.


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