# Manage settlement instruments

Settlement instruments define where loan funds are sent or received — currently limited to bank accounts. Each settlement instrument belongs to an investor and stores the banking details needed for fund transfers. Use the Settlement Instruments page to create instruments, review account details, and update nicknames or external IDs.

**Availability:** Requires the beta toggle to be enabled. If you don't see **Settlement Instruments** in your sidebar, contact Peach support.
**Required permissions:** `settlement.instrument:list`, `settlement.instrument:read` (to view); `settlement.instrument:create` (to add); `settlement.instrument:update` (to edit)

## View settlement instruments

From the Admin Portal sidebar, select **Settlement Instruments**. The list displays all settlement instruments across all investors for your company.

| Column | Description |
|  --- | --- |
| **Settlement instrument** | The instrument nickname (if set) and the Peach-assigned identifier. |
| **Investor** | The legal name and ID of the investor that owns this instrument. |
| **Institution** | The name of the bank or financial institution. |
| **Account** | The account holder type (Business or Personal) and the last four digits of the account number. |
| **Status** | The instrument status: Active, Pending, or Inactive. |


Use the search bar to find instruments by name, ID, or other visible fields. Select the column management icon to show, hide, or reorder columns.

## Add a settlement instrument

1. From the **Settlement Instruments** list, select **+ New**.
2. Fill in the instrument details across the four sections described below (see [field reference](#settlement-instrument-fields)).
3. Select **Create new Settlement instrument**.


### Investor selection

Select the investor that owns this instrument. The dropdown displays each investor's legal name and ID.

### Instrument details

Provide the instrument type, an optional nickname, and an optional external ID. The instrument type is currently limited to **Bank Account**.

### Bank account

Enter the account holder name, account holder type, account type, routing number, and account number. The routing number must be exactly nine digits.

### External instrument settings

Specify whether the instrument is external, set the initial status, and — if the status is Inactive — select an inactive reason. The default status is **Pending**.

## View and edit a settlement instrument

1. From the **Settlement Instruments** list, select a row to open the detail drawer.
2. The drawer displays the full instrument configuration, including bank account details (with the account number masked to the last four digits), investor, instrument type, and timestamps.
3. Select **Edit** to modify the nickname and external ID.
4. Select **Save** to apply changes, or **Cancel** to discard.


If you have unsaved changes and attempt to close the drawer or select **Cancel**, a confirmation dialog titled "You have unsaved changes" appears with the message "Are you sure you want to exit? Your changes will not be saved." Select **Exit** to discard your changes, or **Cancel** to continue editing.

**Note:** Only the nickname and external ID can be updated after creation. Bank account details, investor assignment, and instrument type are set at creation and cannot be changed through the Admin Portal.

## Settlement instrument fields

### Create fields

| Field | Description | Required | Values / Format |
|  --- | --- | --- | --- |
| **Investor** | The investor that owns this instrument. | Yes | Dropdown of investors |
| **Instrument type** | The type of settlement instrument. | Yes | Bank Account |
| **Nickname** | A friendly name for the instrument, displayed in the list and drawer header. | No | Text |
| **External ID** | Your company's internal identifier for this instrument. | No | Text |
| **Account holder name** | The name on the bank account, as it appears at the financial institution. | Yes | Text |
| **Account holder type** | Whether the account belongs to a business or an individual. | Yes | Business, Personal |
| **Account type** | The type of bank account. | Yes | Checking, Savings |
| **Routing number** | The bank routing number. | Yes | Exactly 9 digits |
| **Account number** | The bank account number. | Yes | Minimum 4 characters |
| **Is external** | Whether this instrument is managed outside of Peach. | Yes | True, False |
| **Status** | The current status of the instrument. | No | Active, Pending (default), Inactive |
| **Inactive reason** | The reason the instrument is inactive. Required when the status is Inactive. | Conditional | Fraud Alert, Updated, Not Verified, Expired, Failed, Deleted |


### Read-only fields (detail drawer)

| Field | Description |
|  --- | --- |
| **ID** | The Peach-assigned settlement instrument identifier (shown in the drawer subtitle). |
| **Investor** | The legal name and ID of the investor that owns this instrument. |
| **Instrument type** | The type of settlement instrument (currently Bank Account). |
| **Account holder name** | The name on the bank account, as it appears at the financial institution. |
| **Account holder type** | Whether the account belongs to a business or an individual. |
| **Account type** | The type of bank account (Checking or Savings). |
| **Routing number** | The bank routing number. |
| **Institution** | The name of the financial institution, derived from the routing number. |
| **Account number** | Displayed as the last four digits only (masked). |
| **Is external** | Whether this instrument is managed outside of Peach. |
| **Created at** | The date and time the instrument was created. |
| **Updated at** | The date and time the instrument was last modified. |


## Related pages

- [Manage investors](/servicing-operations/admin-portal/admin-portal-investors)
- [Manage loan tapes](/servicing-operations/admin-portal/admin-portal-loan-tapes)
- [Admin Portal overview](/servicing-operations/admin-portal/admin-portal-overview)