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

# API Reference

> Complete reference for every merchant API endpoint.

This reference documents every endpoint reachable with a **merchant API key** and its
[scopes](/scopes). All endpoints are served under `/merchant/api` on the
[base URL](/introduction#base-url).

<Info>
  Except `POST /merchant/api/auth` and `GET /merchant/api/status`, every endpoint requires
  an `Authorization: Bearer <token>` header with the matching scope. See
  [Authentication](/authentication).
</Info>

Pick an endpoint from the sidebar to see its parameters, request body, and response
schema, or start with these:

<CardGroup cols={2}>
  <Card title="Generate a token" icon="key" href="/api-reference/authentication/generate-a-scoped-bearer-token">
    Exchange your API key + secret for a scoped Bearer token.
  </Card>

  <Card title="Collect a payment" icon="money-bill-transfer" href="/api-reference/payments/collect-a-payment-from-a-customer">
    Initiate a mobile-money collection from a customer.
  </Card>
</CardGroup>