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)
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.
- From the Settlement Instruments list, select + New.
- Fill in the instrument details across the four sections described below (see field reference).
- Select Create new Settlement instrument.
Select the investor that owns this instrument. The dropdown displays each investor's legal name and ID.
Provide the instrument type, an optional nickname, and an optional external ID. The instrument type is currently limited to 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.
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.
- From the Settlement Instruments list, select a row to open the detail drawer.
- 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.
- Select Edit to modify the nickname and external ID.
- 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.
| 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 |
| 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. |