# Balances

## Wallets

Moneywave wallets enable you maintain an active balance, which is needed for payouts. Wallets serve as payout sources.

Wallets can be setup in each currency and your moneywave profile can have multiple wallets in the same currency.  

{% hint style="info" %}
 When creating a wallet, kindly note the **password** used. This is required to **access the wallet for payouts**.
{% endhint %}

## Create Wallet

<mark style="color:green;">`POST`</mark> `https://staging.moneywaveapp.com/v1/wallet`

Create a wallet on your profile

#### Headers

| Name          | Type   | Description         |
| ------------- | ------ | ------------------- |
| Authorization | string | Authorization Token |

#### Request Body

| Name       | Type   | Description                                                            |
| ---------- | ------ | ---------------------------------------------------------------------- |
| name       | string | Name to call or identify the wallet                                    |
| currency   | string | Currency for holding balance                                           |
| user\_ref  | string | Unique user reference or ID, required to identify this wallet via API. |
| lock\_code | string | Password required to access the wallet                                 |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "success",
    "data": {
        "enabled": true,
        "threshold": 0,
        "id": 552,
        "name": "Test Wallet NGN",
        "uref": "398276485",
        "merchantId": 1,
        "currencyId": 1,
        "balance": 0,
        "updatedAt": "2018-02-26T04:53:54.000Z",
        "createdAt": "2018-02-26T04:53:54.000Z"
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
When **user\_ref** is **"0"**, The wallet is considered a main wallet, and currency transactions would default to this wallet. To transact from a different wallet, the appropriate user\_ref must be passed.&#x20;
{% endhint %}

## Wallet Balance

<mark style="color:blue;">`GET`</mark> `https://staging.moneywaveapp.com/v1/wallet`

Return Balance and other details for a specific or multiple wallets using filters

#### Query Parameters

| Name     | Type   | Description                |
| -------- | ------ | -------------------------- |
| id       | string | filter by wallet ID        |
| uref     | string | filter by wallet user\_ref |
| currency | string | filter by wallet currency  |

#### Headers

| Name          | Type   | Description         |
| ------------- | ------ | ------------------- |
| Authorization | string | Authorization token |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "success",
    "data": [
        {
            "id": 545,
            "name": "GHS wallet",
            "balance": 4910,
            "enabled": true,
            "currency": "GHS",
            "createdAt": "2016-11-25T11:09:06.000Z",
            "updatedAt": "2018-05-16T14:11:31.000Z",
            "uref": "0"
        }
    ]
}
```

{% endtab %}
{% endtabs %}