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

# Introduction

> Pretium — move value between stablecoins and African fiat rails.

<img src="https://mintcdn.com/pretium/bGz9JG1CZ4dOo36K/images/landing.jpg?fit=max&auto=format&n=bGz9JG1CZ4dOo36K&q=85&s=07b4ea274713e90bbbd0ecaace9b40ab" alt="Pretium stablecoin and African payment rails" className="landing-hero" width="1600" height="533" data-path="images/landing.jpg" />

Pretium (served at `{{base_url}}`) lets partners collect and disburse fiat across African markets, settle with stablecoins on-chain, and run hosted checkout. For AI assistants, add Pretium as an [MCP server](/guides/agents) in Cursor, Claude, or ChatGPT — no REST agent integration required.

## Onboarding process

[Register on the partner dashboard](https://merchant.xwift.africa/register) with your name, email, and business name. Pretium emails a password, issues API keys immediately, and gives you 14 days to submit KYB / KYC. See [Onboarding](/onboarding) for sign-in, keys, and the KYB steps.

## What you can build

<CardGroup cols={2}>
  <Card title="Offramp" icon="arrow-up-from-bracket" href="/guides/offramp">
    Convert on-chain stablecoin payments into mobile money or bank payouts.
  </Card>

  <Card title="Onramp" icon="arrow-down-to-bracket" href="/guides/onramp">
    Collect local fiat and settle stablecoins to a wallet address.
  </Card>

  <Card title="Checkout" icon="cart-shopping" href="/guides/checkout">
    Hosted settlement flow with a checkout key and order lifecycle.
  </Card>

  <Card title="AI agents (MCP)" icon="robot" href="/guides/agents">
    Add Pretium in Cursor, Claude, or ChatGPT and let agents pay via MCP tools.
  </Card>
</CardGroup>

## Supported markets

| Currency | Country | Prefix |
| - | - | - |
| KES | Kenya | `/kes`, `/v1/.../KES` |
| UGX | Uganda | `/ugx` |
| NGN | Nigeria | `/ngn` |
| GHS | Ghana | `/ghs` |
| MWK | Malawi | `/mwk` |
| CDF | DR Congo | `/cdf` |
| ETB | Ethiopia | `/etb` |
| TZS | Tanzania | `/tzs` |
| ZMW | Zambia | `/zmw` |
| RWF | Rwanda | `/rwf` (utilities) |

## API surfaces

| Surface | Base path | Auth header value |
| - | - | - |
| Unified payments | `/v1`, `/v2` | Partner `consumer_key` |
| Account | `/account` | Partner `consumer_key` |
| Collection & disbursement | `/{currency}` | Partner `consumer_key` |
| Checkout | `/v1/checkout` | Partner `checkout_key` |
| AI agents | [MCP guide](/guides/agents) | MCP server (`mcp.pretium.africa`), not REST |

Almost all partner Pretium endpoints are **POST** with a JSON body.

## Response envelope

Successful and error responses share a consistent shape:

```json theme={null}
{
  "code": 200,
  "message": "Exchange rates",
  "data": {}
}
```

Errors omit `data` and use `400`, `401`, `403`, or `404` in both the HTTP status and `code` field.

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Make your first authenticated request in under five minutes.
  </Card>

  <Card title="Authentication" icon="lock" href="/authentication">
    How API keys and checkout keys work for Pretium.
  </Card>
</CardGroup>


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