Gateway Routing

Khaime automatically routes each payment to the best gateway based on the customer’s currency and region. You don’t need to configure or select gateways — it’s handled for you.

How It Works

You send a charge request with the customer’s currency
Khaime selects the optimal gateway for that currency and region
The response tells you which checkout flow to use

Checkout Flows

The charge response includes a payment_gateway field. Your integration needs to handle two checkout types:

Flow	When	What to do
Embedded	`client_secret` is returned	Mount a payment element on your page using `client_secret` + `publishable_key`
Redirect	`payment_url` is returned	Redirect the customer to the hosted payment page

Example Response

// Embedded flow
{
  "payment_gateway": "...",
  "client_secret": "pi_xxx_secret_xxx",
  "publishable_key": "pk_xxx",
  "charge_id": "charge_xxx"
}

// Redirect flow
{
  "payment_gateway": "...",
  "payment_url": "https://...",
  "charge_id": "charge_xxx"
}

Supported Regions

Khaime supports payments across multiple regions including:

Africa — Nigeria, Ghana, Kenya, South Africa, and more
North America — United States, Canada
Europe — UK, Eurozone
Asia-Pacific — Australia and expanding

The list of supported currencies and regions is growing. Check the multicurrency page for the full list.

Integration Reference

See the WooCommerce plugin payment flow for a working example that handles both embedded and redirect checkout flows.

Multicurrency Subscriptions

Getting Started

Payments

Webhooks

Gateway Routing

Gateway Routing

How It Works

Checkout Flows

Example Response

Supported Regions

Integration Reference

​Gateway Routing

​How It Works

​Checkout Flows

​Example Response

​Supported Regions

​Integration Reference

Gateway Routing

How It Works

Checkout Flows

Example Response

Supported Regions

Integration Reference