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

# Merchant API

> Use the Sarafa Merchant API to collect payments, send funds, swap balances, and reconcile transactions.

The Merchant API lets your business connect Sarafa to your checkout, website, accounting system, or operations workflow.

## What you can do

<CardGroup cols={2}>
  <Card title="API keys" icon="key-round" href="/merchant/api/api-management">
    Create and manage sandbox and production access from the dashboard.
  </Card>

  <Card title="Authentication" icon="shield-check" href="/merchant/api/authentication">
    Send your API key in the `x-api-key` header.
  </Card>

  <Card title="Wallets" icon="wallet" href="/merchant/api/wallets">
    List balances and inspect a wallet.
  </Card>

  <Card title="Collections" icon="download" href="/merchant/api/collections">
    Request money from a customer.
  </Card>

  <Card title="Transfers" icon="send" href="/merchant/api/transfers">
    Send money to another account or supported destination.
  </Card>

  <Card title="Swaps" icon="repeat-2" href="/merchant/api/swaps">
    Convert one wallet balance into another supported currency.
  </Card>
</CardGroup>

## Base path

All Merchant API endpoints in this guide use the `/v3` path.

## Basic request pattern

```bash theme={null}
curl https://serviceapi.sarafa.ss/v3/wallets \
  -H "x-api-key: YOUR_API_KEY" \
  -H "environment: sandbox"
```

Use sandbox while testing. Omit the `environment` header only when you are ready to use production.