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

# Coverage

> The currencies, countries and payment methods the API accepts.

The API accepts three currencies: `NGN`, `GHS` and `KES`. A request in any other currency is rejected with `422`.

> [!NOTE]
>
> This page lists what the platform can route. What is switched on for your account can be narrower.
> `GET /v1/currencies` and `GET /v1/payouts/institutions` return what you can use today.

## Currencies

| Code | Currency | Country | Minor unit | Decimals |
| - | - | - | - | - |
| `NGN` | Nigerian Naira | Nigeria `NG` | kobo | 2 |
| `GHS` | Ghanaian Cedi | Ghana `GH` | pesewa | 2 |
| `KES` | Kenyan Shilling | Kenya `KE` | cent | 2 |

```bash
curl "$PAYVE_API_URL/v1/currencies"
```

```json
{
  "data": [
    { "code": "NGN", "name": "Nigerian Naira", "decimals": 2, "supportsVA": true },
    { "code": "GHS", "name": "Ghanaian Cedi", "decimals": 2, "supportsVA": false },
    { "code": "KES", "name": "Kenyan Shilling", "decimals": 2, "supportsVA": false }
  ]
}
```

`supportsVA` says whether Payve issues a permanent virtual account for that currency. Today that is `NGN` only.

## Payouts

| Country | Currency | Bank transfer | Mobile money |
| - | - | - | - |
| Nigeria | `NGN` | Yes | No |
| Ghana | `GHS` | Yes | Yes |
| Kenya | `KES` | Yes | Yes |

Nigeria pays out to bank accounts only. `GET /v1/payouts/institutions?country=NG&type=mobile_money` returns an empty list.

The `method` field accepts `bank_transfer` and `mobile_money` for payouts.

## Pay-ins

| Method | `method` value | Currencies | How the payer pays |
| - | - | - | - |
| Virtual account | `virtual_account` | `NGN`, `GHS`, `KES` | Transfers the exact amount to a one-off account. |
| Bank transfer | `bank_transfer` | `NGN`, `GHS`, `KES` | Transfers to your virtual account. |
| Card | `card` | `NGN`, `GHS`, `KES` | Enters card details, then a PIN or one-time code. |
| Mobile money | `mobile_money` | Sandbox only | Approves a prompt on their phone. |
| EFT | `eft` | Sandbox only | Is redirected to their bank. |

> [!WARNING]
>
> Mobile money and EFT pay-ins work in the sandbox but no live route carries them today. Do not
> build a live flow on them. Test the method you plan to launch with before you go live.

## Conversions

You can convert between any two of `NGN`, `GHS` and `KES` for which a rate exists. `POST /v1/quotes` returns `404` when a pair has no rate.

## Name checks

| Country | Bank account name check |
| - | - |
| Nigeria | Yes |
| Ghana | Yes |
| Kenya | Yes |

See [Name check](/guides/name-check.md).

## Indicative rates

`GET /v1/rates` lists the current rate for each pair. It needs no key. Use it to show a rough rate; use a [quote](/guides/quotes.md) for the rate and fee you will actually get.

```json
{
  "data": [
    {
      "fromCurrency": "NGN",
      "toCurrency": "GHS",
      "rate": "0.0093",
      "updatedAt": "2026-11-18T09:58:00.000Z"
    }
  ]
}
```
