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

# Create Wallet

> Create a wallet for a specific currency

This endpoint is used to create a wallet for a specific currency.

***

## 🇳🇬 NGN Wallet Creation Flow

For NGN (Nigerian Naira) wallets, identity verification is required before wallet creation.

### Step 1: Identity Verification

Call the utility endpoint (see Utility Section) `/utility/identity-verification` and provide the BVN of one of the founders/directors.

### Step 2: Create Wallet

After successful identity verification, call this endpoint and provide:

| Field                       | Value                                      |
| --------------------------- | ------------------------------------------ |
| `currency`                  | `NGN`                                      |
| `bvn`                       | Same BVN used during identity verification |
| `companyRegistrationNumber` | The company's RC (registration) number     |

**Sample NGN Payload:**

```json theme={null}
{
  "currency": "NGN",
  "bvn": "12345678901",
  "companyRegistrationNumber": "123456"
}
```

***

## Other Currencies (e.g. GHS – Ghanaian Cedi)

For other currencies like GHS, no identity verification is required. Simply provide the currency.

**Sample GHS Payload:**

```json theme={null}
{
  "currency": "GHS"
}
```

***

## Notes

<Callout type="info">
  * The `bvn` and `companyRegistrationNumber` fields are **required only for `NGN`**.
  * For currencies like `GHS`, `XOF`, `XAF`, etc., these fields **must be omitted**.
  * Providing invalid or unnecessary fields may result in **validation errors**.
</Callout>

***

## Request Body

**Content-Type:** `application/json`

```json theme={null}
{
  "currency": "GHS"
}
```

### Schema

| Field                       | Type     | Required   | Description                                    |
| --------------------------- | -------- | ---------- | ---------------------------------------------- |
| `currency`                  | `string` | ✅ Always   | The currency code (e.g. `NGN`, `GHS`, `XOF`)   |
| `bvn`                       | `string` | ✅ NGN only | Bank Verification Number of a founder/director |
| `companyRegistrationNumber` | `string` | ✅ NGN only | The company's RC number                        |