# Investor & Order Management

The Offering Manager (<https://om.bitbond.com>) provides issuer users with comprehensive tools to view, filter, and manage your investors and their orders. The platform integrates KYC verification via [Sumsub](https://sumsub.com) and [Blockpass](https://www.blockpass.org) (configurable in Settings) and supports three payment methods for investors: bank transfer (SEPA/wire), card payments via [Checkout.com](https://www.checkout.com), and stablecoin payments. All manual administrative actions—such as creating investors, updating orders, and reconciling payments—are recorded in the Audit Trail. For a complete API reference, visit the interactive OpenAPI spec at <https://om.bitbond.com/api/docs>.

## Investors List

The **Investors** page shows all investors across all of your offerings. At the top, summary cards display:

* **Total Investors** — The total number of unique investors.
* **KYC Approved** — The number of investors who have passed identity verification via [Sumsub](https://sumsub.com) or [Blockpass](https://www.blockpass.org), with a percentage of the total.
* **Total Invested** — The aggregate investment amount across all investors.

![investors list](https://1296188560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhtayBZtqzlQ0pTHYlIS%2Fuploads%2Fgit-blob-c9de3f9ba63057af0f6e5bbbb46cf9b1ff1de321%2Finvestors-list.png?alt=media)

### Adding an Investor

To manually add a new investor:

1. Click the **Add Investor** button in the top-right corner.
2. Complete the form, including:
   * Personal information (name, email, phone, address).
   * Investor type (Individual or Institutional).
   * Multi-chain wallet address (optional) — select the chain (EVM, Solana, etc.) and enter the address.
   * Initial KYC status (None, Pending, Approved, or Rejected).
3. Submit to create the investor profile.\
   All manually created investors appear immediately in the list and are recorded in the Audit Trail.

### Filtering and Searching

You can narrow down the investor list using several filters and the search box:

* **Search** — Search by investor name, email address, or wallet address.
* **KYC Status** — Filter by identity verification status: None, Pending, Approved, or Rejected.
* **Investor Type** — Filter by Individual or Institutional investors.
* **Offering** — Show only investors who participated in a specific offering.
* **Country** — Filter by the investor's country.

### Investor Table

Each row displays:

* **Investor** — Name, email address, and (for institutional investors) company name, or (for individual investors) country.
* **Type** — Individual or Institutional badge.
* **KYC Status** — Current KYC verification status (None, Pending, Approved, or Rejected).
* **Offerings** — Number of offerings the investor has participated in.
* **Total Invested** — The total amount invested across all offerings.
* **Orders** — Total number of orders placed.
* **Wallet** — Abbreviated multi-chain wallet address, or a dash if not provided.
* **Registered** — The date the investor registered.

Click on any investor row to view or edit their detailed profile.

### Pagination

If the investor list is longer than one page, use the **Previous** and **Next** buttons at the bottom to navigate between pages.

## Investor Detail Page

Clicking on an investor opens their detail page, where you can view and edit profile information.

### Profile

* Full name
* Investor type (Individual or Institutional)
* Email address
* Phone number (if provided)
* Postal address (if provided), including:
  * Address Line 1
  * Address Line 2 (optional)
  * City
  * State/Region
  * Postal code
  * Country
* Wallet Addresses — List of all registered wallets, including chain type (EVM, Solana, etc.)
* Registration date
* **Edit** button — Update any of the above fields or change the KYC status (None, Pending, Approved, Rejected) as needed.

### Business Details (Institutional Investors)

For institutional investors, additional fields are displayed and editable:

* Company name
* Registration number
* Legal form (e.g., GmbH, Ltd, AG)
* Jurisdiction
* LEI (Legal Entity Identifier)
* VAT ID
* Representative role

### Summary

* Current KYC status
* Total invested amount
* Number of offerings participated in
* Total number of orders

### Order History

A table of all orders placed by this investor, showing:

* Offering name
* Investment amount
* Token amount
* Order status
* Reference code
* Order date

## Orders Page

Each offering has a dedicated **Orders** page, accessible from the offering detail page by clicking **Orders**. Here you can also manually create new orders on behalf of investors.

![orders list](https://1296188560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhtayBZtqzlQ0pTHYlIS%2Fuploads%2Fgit-blob-c884dee3e2827cb3ff54e3465101a3b8a375f6ff%2Forders-list.png?alt=media)

### Manual Order Creation

1. Click the **Create Order** button.
2. Select an existing investor or enter investor details.
3. Specify:
   * Investment amount
   * Payment method — choose bank transfer (SEPA/wire), card payments via [Checkout.com](https://www.checkout.com), stablecoin, or Manual.
   * KYC status if needed.
4. Submit to generate an order reference code and add the order to the ledger.\
   All manually created orders appear immediately in the order list and are logged in the Audit Trail.

### Filtering Orders

Use the status filter dropdown to show only orders with a specific status:

* **All Statuses** — Show all orders.
* **Pending** — Orders awaiting payment.
* **Processing** — Payments being processed.
* **Paid** — Confirmed and completed payments.
* **Cancellation Requested** — Investors who have requested cancellation.
* **Refunded** — Orders that have been refunded.
* **Cancelled** — Cancelled orders.
* **Failed** — Orders that failed processing.
* **Expired** — Orders that were not completed within the payment window.

### Order Table

Each row in the orders table shows:

* **Investor** — Name, email, and KYC status.
* **Amount** — Investment amount in fiat and equivalent token amount.
* **Status** — Current order status badge.
* **Ref Code** — The unique reference code for this order (e.g., OM-1234-ABCD), displayed in monospace font.
* **Date** — When the order was placed.
* **Actions** — Available actions for this order (see below).

#### Order Statuses Explained

| Status                     | Meaning                                                                     |
| -------------------------- | --------------------------------------------------------------------------- |
| **Pending**                | The investor has placed an order but payment has not been received yet.     |
| **Processing**             | Payment is being processed (e.g., a card payment is being captured).        |
| **Paid**                   | Payment has been confirmed. The order is complete.                          |
| **Cancellation Requested** | The investor has requested to cancel their order within the allowed window. |
| **Refunded**               | The order has been refunded to the investor.                                |
| **Cancelled**              | The order has been cancelled.                                               |
| **Failed**                 | The payment failed (e.g., a card was declined).                             |
| **Expired**                | The payment window elapsed without completion and the order expired.        |

### Manual Status Updates

You can manually update an order's status using the action buttons:

* **Pending** or **Processing** orders can be marked as **Paid** after verifying a manual payment.
* **Cancellation Requested** orders can be marked as **Refunded** after processing the refund.

All manual status changes are logged in the Audit Trail for compliance purposes.

### Sending Payment Reminders

For orders in **Pending** status, click the email icon in the Actions column to send a payment reminder via email.

### Contacting Investors

If an investor provided a phone number, a phone icon appears in the Actions column. Click it to initiate a call directly.

### Stablecoin Payment Details

For orders paid with stablecoin, additional details appear below the order row:

* **Transaction hash** with a link to the blockchain explorer.
* **Chain** — The blockchain network used (e.g., Ethereum, Polygon).
* **Expected vs. Received amount** — Comparison with badges indicating overpayment or shortfall.
* **Confirmation timestamp** — When the on-chain payment was confirmed.
* **Flag status** — A warning if the payment was flagged for review, with the reason.

## Bank Transfer Reconciliation

For offerings that accept bank transfers, you can bulk-reconcile payments by uploading a bank statement CSV:

1. Navigate to the offering detail page.
2. In the **Reconciliation** section, click **Choose CSV** and select your bank statement export.
3. Click **Reconcile**.
4. The system scans the CSV for reference codes (format OM-XXXX-XXXX).
5. Matched orders are automatically updated to **Paid**.
6. A summary displays the number of matched and skipped transactions.\
   All reconciliation actions are recorded in the Audit Trail.

## Exporting Investor Wallet Addresses

After your offering closes and payments are confirmed, export a list of funded investor wallet addresses:

1. Navigate to the offering detail page.
2. Click **Export CSV**.
3. A plain-text file is downloaded containing one wallet address per line (no headers).
   * The export uses the offering’s configured token chain to select the correct wallet (EVM, Solana, etc.).
   * By default, only **Paid** orders are included.
4. Use this list to perform a bulk token distribution.

For custom filters or to include additional statuses, use the API endpoint:

```
GET /api/issuer/orders/export-wallets?offeringId={OFFERING_ID}&statuses=paid,refunded
```

## Audit Trail

The **Audit Trail** page logs all administrative actions across offerings, investors, and orders. You can filter entries by offering, entity type (Investor or Order), action, date range, and user.

1. In the sidebar, click **Audit Trail**.
2. Use the filters to narrow the log entries.
3. Review each entry’s timestamp, user, entity, action type, and details for compliance and record-keeping.

For a complete API reference, visit the interactive OpenAPI spec at <https://om.bitbond.com/api/docs>.