> ## 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.

# Errors

> The error shape every PrimePay API endpoint returns.

Every error has the same shape:

```json theme={null}
{
  "error": {
    "code": "insufficient_funds",
    "message": "Not enough available balance for MWK 25,000.00."
  }
}
```

Use `code` in your code; show `message` to people. Codes are listed under each endpoint.

| Errors for | Where |
| - | - |
| Authentication | [Authentication errors](https://docs.primepay.mw/api-reference/authentication.md#authentication-errors) |
| Payments and refunds | [Payment errors](https://docs.primepay.mw/api-reference/payments-overview.md#payment-errors) and [refund errors](https://docs.primepay.mw/api-reference/payments-overview.md#refund-errors) |
| Transfers | [Transfer errors](https://docs.primepay.mw/api-reference/transfers-overview.md#transfer-errors) |
| Payouts | [Payout errors](https://docs.primepay.mw/api-reference/payouts-overview.md#payout-errors) |
| Payment links | [Payment link errors](https://docs.primepay.mw/api-reference/payment-links-overview.md#payment-link-errors) |
| Hosted checkout | [Checkout errors](https://docs.primepay.mw/api-reference/checkout-overview.md#checkout-errors). These also carry `type` and `param`. |


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