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

# Payments Overview

> How Khaime processes payments across gateways and currencies.

# Payments

Khaime acts as a payment orchestrator — you send a charge request, and Khaime routes it to the right gateway based on the customer's currency and location.

## Payment Flow

<Steps>
  <Step title="Customer selects currency">
    Via IP auto-detection or manual selection on your storefront.
  </Step>

  <Step title="You create a charge">
    Call `POST /payments/charge` with the amount, currency, and customer details. Include the customer's country when available so fee detection and geography reports stay accurate.
  </Step>

  <Step title="Khaime routes to gateway">
    Khaime picks the best gateway for the customer's currency and region.
  </Step>

  <Step title="Customer pays">
    Via Stripe Payment Element (embedded) or Paystack redirect (hosted).
  </Step>

  <Step title="Khaime confirms">
    Webhook `payment.succeeded` fires with transaction details.
  </Step>
</Steps>

## Supported Gateways

| Gateway     | Currencies                          | Type                       |
| ----------- | ----------------------------------- | -------------------------- |
| Stripe      | USD, EUR, GBP, CAD, AUD, + 135 more | Embedded (Payment Element) |
| Paystack    | NGN, GHS, KES, ZAR                  | Redirect (hosted page)     |
| StartButton | GHS                                 | Redirect                   |
| PayPal      | USD, EUR, GBP                       | Redirect                   |

## Fee Structure

| Fee Type            | Rate            |
| ------------------- | --------------- |
| Khaime platform fee | 6%              |
| Stripe processing   | \~2.9% + 30¢    |
| Paystack processing | \~1.5% (capped) |

Fees can be absorbed by the merchant or passed to the customer (configurable per business in the dashboard).