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.

​

Core Concepts

Khaime is a complete commerce infrastructure platform. These docs primarily cover the Partner API and plugin integrations — for merchants who want to connect their existing stores (WooCommerce, WordPress, custom platforms) to Khaime’s payment and multicurrency capabilities.

​

Currencies & Conversion

Khaime operates with two currency concepts:

• Baseline Currency: The merchant’s home currency (e.g., USD). Products are priced in this currency. Payouts settle in this currency.
• Customer Currency: The currency the customer sees and pays in (e.g., NGN). Determined by IP geolocation or explicit selection.

Exchange rates are updated frequently and cached with volatility-aware TTLs — stable pairs are cached longer, volatile pairs refresh more often.

​

Gateway Routing

Khaime automatically selects the optimal payment gateway based on the customer’s currency and location. Supported regions include Africa, North America, Europe, and more. Merchants don’t need to configure individual gateways — Khaime handles the routing.

​

Environments

Sandbox uses test credentials for each gateway (Stripe test mode, Paystack test keys). No real charges are made.

​

Amounts

All monetary amounts in the API are expressed in the smallest currency unit:

​

Fees

Khaime’s fee structure:

• Platform fee: 6% of the transaction amount
• Gateway fee: Varies by provider (Stripe ~2.9% + 30¢, Paystack ~1.5%)
• Who pays: Configurable per merchant — customer can absorb fees or merchant can

Fee details are included in every charge response.

​

Webhooks

Khaime sends real-time notifications for payment events. Webhooks are:

• Signed with HMAC-SHA256 using your webhook secret
• Retried up to 3 times with 2-second delays
• Idempotent — each event has a unique event_id for deduplication

Learn more →