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

# Connect a gateway

> Bring your own gateway account: Bouclay charges through it with your keys

Bouclay doesn't process payments itself. You connect the account you already have with a payment gateway, and Bouclay uses your keys to save cards, charge them, and refund. The money settles straight into your gateway account.

## Supported gateways

| Gateway | Availability | Currencies Bouclay can charge in |
| - | - | - |
| **Bachs** | Every account (new, marked Early access) | USD, NGN, GHS, KES, MWK, RWF, TZS, UGX, XAF, XOF, ZMW |
| **Paystack** | On request | NGN, GHS, ZAR, KES, USD, XOF |
| **Flutterwave** | On request | NGN, USD, EUR, GBP, KES, GHS, ZAR, UGX, TZS, XOF, XAF, MWK, RWF |
| **Nomba** | On request | NGN, GBP, EUR, USD, CDF |

> [!NOTE]
>
> These are the currencies Bouclay supports for each gateway. Which ones your own account can actually take depends on your agreement with the gateway, so check with them.

## Connect

**1. Open the gateway**

In the dashboard, open **Developers → Payment gateways** and pick your gateway.

**2. Paste your test keys**

Copy the API keys from your gateway's dashboard. Start with test keys, so you can try everything without real money.

**3. Set up the inbound webhook**

The gateway page shows an **Inbound webhook URL**. Paste it into your gateway's dashboard, where it asks for a webhook or callback URL. If the gateway gives you a webhook signing secret, paste it back into Bouclay. This is how your gateway tells Bouclay that a payment went through.

**4. Connect your live account**

When you are ready for real payments, choose **Connect live account** and repeat with your live keys and live webhook settings. See [Going live](https://docs.bouclay.com/get-started/go-live.md).

Bouclay encrypts your gateway keys and only uses them to act for you.

## Using more than one gateway

> [!NOTE]
>
> Early access. Write to [hello@bouclay.com](mailto:hello@bouclay.com) to turn on Paystack, Flutterwave, Nomba or routing between gateways.

You can connect several gateways and choose which collects what:

* **The order of the list is the routing.** The first gateway is your primary; the others are backups, tried in order for each new payment.
* **A currency can have its own order.** For example, prefer Paystack for GHS and Bachs for everything else.
* **Pause one currency on one gateway.** If a gateway's KES payments start failing, pause KES on it. New KES payments go to your next gateway, while its NGN and other currencies keep running.

A saved card always charges through the gateway that saved it, because the gateway's card token only works there. So routing decides where **new** cards and one-off payments go; renewals on a saved card stay on its gateway.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.