> For the complete documentation index, see [llms.txt](https://docs.payengine.co/payengine-api-v2.5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payengine.co/payengine-api-v2.5/onboarding/add-merchants-bank-account.md).

# Add Merchant's Bank Account

## Add Bank Account

<mark style="color:green;">`POST`</mark> `https://<Platform-host>/merchant/:merchant_id/bank-accounts`

Adds a new bank account for a merchant.

#### Path Parameters

| Name                                           | Type   | Description                                  |
| ---------------------------------------------- | ------ | -------------------------------------------- |
| merchant\_id<mark style="color:red;">\*</mark> | String | Merchant ID for which account is being added |

#### Request Body

| Name                                              | Type       | Description                                                      |
| ------------------------------------------------- | ---------- | ---------------------------------------------------------------- |
| is\_default                                       | true/false | Is this account default for this merchant? true if not provided. |
| account\_type<mark style="color:red;">\*</mark>   | N\|Y\|G    | <p>Checking = N<br>Saving = Y</p><p>General Ledger = G</p>       |
| account\_number<mark style="color:red;">\*</mark> | String     | Bank account number                                              |
| routing\_number<mark style="color:red;">\*</mark> | String     | Bank routing number                                              |
| account\_name<mark style="color:red;">\*</mark>   | String     | Account display name                                             |

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

```javascript
{
    "message": "merchant updated",
    "data": {
        "id": "802db58e-9f7e-4825-af6d-a2779f08038d",
        "name": "My Bank Account 2022-01-17T20:46:32.723Z",
        "last_4": "2345",
        "data": {
            "account_type": "N"
        },
        "active": true
    }
}
```

{% endtab %}
{% endtabs %}
