> For the complete documentation index, see [llms.txt](https://docs.fonbnk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fonbnk.com/countries/cameroon.md).

# Cameroon

How to on-ramp and off-ramp XAF in Cameroon: mobile money, airtime, KYC, limits and API examples.

| countryIsoCode | currencyIsoCode | Status | Generated on |
| -------------- | --------------- | ------ | ------------ |
| `CM`           | `XAF`           | Live   | 2026-10-09   |

{% hint style="warning" %}
The walkthroughs ran in sandbox on 2026-10-09. The limits, fields and KYC rules are a snapshot of production on 2026-10-09. They change when providers change, so build against [Get available currencies](https://docs.fonbnk.com/server-to-server/api-endpoints/get-available-currencies.md) and the `fieldsToCreateOrder` of each quote, not against this page.
{% endhint %}

Start with [Countries](https://docs.fonbnk.com/countries.md): it has the keys, the signing helpers, the order statuses and the retry rules that every country page uses. To take payments without the API, open the Pay Widget with `countryIsoCode=CM`, see [URL params](https://docs.fonbnk.com/widget-integration/url-params.md).

## Payment channels

Each channel has its own page with the walkthrough. Open a channel:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Mobile money</strong></td><td>On-ramp and off-ramp</td><td><strong>Learn more →</strong></td><td><a href="https://docs.fonbnk.com/countries/cameroon/mobile-money.md">Mobile money</a></td></tr><tr><td><strong>Airtime</strong></td><td>Off-ramp only</td><td><strong>Learn more →</strong></td><td><a href="https://docs.fonbnk.com/countries/cameroon/airtime.md">Airtime</a></td></tr></tbody></table>

On-ramp means the user pays local currency and gets crypto. Off-ramp means the user pays crypto and gets local currency.

| Channel                                                                    | paymentChannel | On-ramp | Off-ramp | On-ramp transfer type | carrierCode           | Typical settlement |
| -------------------------------------------------------------------------- | -------------- | ------- | -------- | --------------------- | --------------------- | ------------------ |
| [Mobile money](https://docs.fonbnk.com/countries/cameroon/mobile-money.md) | `mobile_money` | Yes     | Yes      | `stk_push`            | `cm_mtn`, `cm_orange` | —                  |
| [Airtime](https://docs.fonbnk.com/countries/cameroon/airtime.md)           | `airtime`      | No      | Yes      | —                     | `cm_mtn`, `cm_orange` | —                  |

## Quirks

{% hint style="info" %}
XAF is shared by several countries. Always send `countryIsoCode` with `currencyCode`.
{% endhint %}

## Verify the user

Before the first order, read the user's KYC state. `requiredKycType` says which level the user must pass, and `kycDocuments` lists the documents to submit. Without the order amounts in the request it answers for the user's past orders only, so send them when you have a quote: see [Get user KYC state](https://docs.fonbnk.com/server-to-server/api-endpoints/get-user-kyc-state.md). The rules for Cameroon are in [the reference](#kyc-rules).

{% tabs %}
{% tab title="curl" %}
{% code overflow="wrap" %}

```bash
ENDPOINT='/api/v2/user/kyc?userEmail=user%40example.com&countryIsoCode=CM'
TIMESTAMP=$(($(date +%s) * 1000))
curl "$FONBNK_BASE_URL$ENDPOINT" \
  -H "x-client-id: $FONBNK_CLIENT_ID" \
  -H "x-timestamp: $TIMESTAMP" \
  -H "x-signature: $(fonbnk_sign "$TIMESTAMP" "$ENDPOINT")"
```

{% endcode %}
{% endtab %}

{% tab title="TypeScript" %}
{% code overflow="wrap" %}

```typescript
const response = await fonbnkRequest('GET', '/api/v2/user/kyc?userEmail=user%40example.com&countryIsoCode=CM');
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Response (sandbox, a new user, KYC fields only)" overflow="wrap" %}

```json
{
  "requiredKycType": null,
  "reachedKycLimit": false,
  "offrampKycRequired": false,
  "isNgBvnBlocked": false,
  "isNgBvnSupportLocked": false
}
```

{% endcode %}

## Reference (production, 2026-10-09)

### Limits

Per order, for a merchant on the default limits, with `CELO_USDT` on the crypto leg. Another asset, another carrier or your own account limits can change them: [Get order limits](https://docs.fonbnk.com/server-to-server/api-endpoints/get-order-limits.md) answers for your request.

| Route                             | Min (XAF) | Max (XAF) | Min (USD) | Max (USD) |
| --------------------------------- | --------- | --------- | --------- | --------- |
| On-ramp, Mobile money (`cm_mtn`)  | 670       | 334,424   | 1         | 500       |
| Off-ramp, Mobile money (`cm_mtn`) | 604       | 301,338   | 1         | 500       |
| Off-ramp, Airtime (`cm_mtn`)      | 2,000     | 20,000    | 3.94      | 39.42     |

### KYC rules

Off-ramp KYC is off in Cameroon. A rule fires when one order falls in its per-order range, or when the user's lifetime successful orders pass its allowance. When several rules fire, the higher level wins. See [KYC](https://docs.fonbnk.com/kyc.md).

| Route   | Level      | Per order (USD)  | Lifetime volume (USD) | Lifetime orders |
| ------- | ---------- | ---------------- | --------------------- | --------------- |
| On-ramp | `advanced` | $1 to any amount | over $1               | —               |

The documents production accepts:

| Level      | Document                                  | Fields to collect                          |
| ---------- | ----------------------------------------- | ------------------------------------------ |
| `advanced` | Driving License                           | `first_name`, `last_name`, `dob`, `images` |
| `advanced` | National IDs, Consular IDs & Diplomat IDs | `first_name`, `last_name`, `dob`, `images` |
| `advanced` | Passports                                 | `first_name`, `last_name`, `dob`, `images` |

### Fees

Every quote lists its fees in `cashout.feeSettings` and charges them in `cashout.chargedFees`. The amounts depend on your account, so this page names the fees and not their values. When your account sets a fee of its own, the quote also lists a `merchant_fee` that goes to `merchant`.

| Fee id        | Recipient    | Routes                                                                                            |
| ------------- | ------------ | ------------------------------------------------------------------------------------------------- |
| `service_fee` | `platform`   | On-ramp, Mobile money (`cm_mtn`); Off-ramp, Mobile money (`cm_mtn`); Off-ramp, Airtime (`cm_mtn`) |
| `gas`         | `blockchain` | On-ramp, Mobile money (`cm_mtn`)                                                                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fonbnk.com/countries/cameroon.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
