# Investor Experience

This section provides an overview of what investors see and experience when they visit your offering on the Offering Manager site (<https://om.bitbond.com>) and go through the investment process. Understanding the investor journey can help you optimize your offering configuration, Invest Page content, and support processes.

Investors access your offering via a single domain (<https://om.bitbond.com>) with path-based routing. For example:

* Offering Invest Page: `<https://om.bitbond.com/invest/{subdomain}/{slug}>`
* Portfolio page: `<https://om.bitbond.com/invest/{subdomain}/portfolio>`

## Invest Page

When an investor visits your offering URL (`/invest/{subdomain}/{slug}`), they see a branded Invest Page with the following elements:

* If an investor visits the root path (`/invest/{subdomain}`), they are automatically redirected to the active offering’s Invest Page.
* If no active offering is published or the sale has closed, they see a lock icon and a notice: **No active offering available**.
* If an investor visits the direct offering URL (`/invest/{subdomain}/{slug}`) after the sale has closed, the hero card shows a lock icon and a notice stating **Offering closed**, and the **Invest Now** button is disabled.
* If you have configured a scheduled (draft) offering, visitors to its slug URL see a **Coming Soon** page with a rocket icon and the message *“Coming Soon”* until you publish it.
* If an investor visits a non-existent slug (`/invest/{subdomain}/{slug}`) for an offering that does not exist, they see a search icon and an **Offering not found** message.

### Navigation Bar

The top of the page shows:

* Your logo (if uploaded)
* The offering name
* A button to either log in (for new visitors) or view their portfolio (if already signed in)

### Hero Section

A visually prominent card at the top of the page featuring:

* The offering name and token symbol
* Price per token and minimum investment
* A live countdown timer showing days, hours, minutes, and seconds remaining until the sale ends
* A progress bar displaying:
  * Total raised vs. the hard cap
  * Total reserved vs. the hard cap (if any)
  * Percentage of the hard cap committed
  * Number of investors
* Current limited-time discount badge (if configured) showing the discount percentage, label, and either time remaining or remaining cap
* An **Invest Now** call-to-action button (disabled when the sale has closed)

The hero card uses your configured primary color as a gradient background.

### Pricing and Participation Stats

In the hero card itself, the following statistics are highlighted:

* Price per token
* Minimum investment
* Countdown to sale close
* Raised vs. hard cap (with reserved amount if any)
* Investor count

### Content Sections

Below the hero card, the page continues with the sections you configured in the Invest Page Builder:

* **About this Offering** — Your project description.
* **Bond Details** — (If configured) A grid of fixed-income parameters: ISIN, coupon rate, coupon frequency, maturity date, issuer.
* **Offering Documents** — Downloadable documents (prospectus, T\&Cs, etc.) with labels indicating if investor agreement is required.
* **Links** — External resource links (website, litepaper, social media, imprint, privacy policy).
  * Interactive API reference: <https://om.bitbond.com/api/docs>
* **Limited-time Discounts** — (If configured) A panel listing upcoming discount windows with start/end dates, discount percentage, cap amounts, and countdown labels.
* **Our Team** — Team member grid with photos (or initials), names, roles, and bios.
* **Roadmap** — A vertical timeline of project milestones showing completed and upcoming items.

### Compliance Information

An information box at the bottom summarizes key compliance details:

* Whether KYC is required
* The cancellation period
* The minimum investment amount

### Final Call-to-Action

A second **Invest Now** button at the bottom of the page encourages investors to proceed if the sale is still open.

## Investment Checkout

When an investor clicks **Invest Now**, they enter a multi-step checkout flow.

![investor checkout](/files/y9fGyoc3IgkbdnnyFf3G)

### Step 1: Investment Amount

The investor enters their desired investment amount using a real-time calculator:

* The amount is validated against the offering’s minimum and maximum limits.
* The equivalent number of tokens is calculated based on the token price.
* If discount tiers are configured, any applicable discount is applied, updating the per-token price and resulting token amount.
* A summary shows the investment amount, token price (with any discount), and the number of tokens to be received.

### Step 2: Authentication

The investor signs in or creates an account. Available authentication methods include:

* **Email and password** — The investor enters their email and password, or registers a new account.
* **Privy (social login & wallet)** — If Privy is configured, the investor can sign in with Google or connect a crypto wallet. Privy automatically provisions an embedded MPC wallet for investors who do not have their own.

### Step 3: Investor Details

The investor provides required personal or business information:

**For individual investors:**

* First name and last name
* Phone number
* Postal address (street, city, state/region, postal code, country)

**For institutional investors (additional fields):**

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

If you configured custom AML/suitability questions (supported types: text, yes/no, checkbox), they appear in this step as well.

The investor also confirms their wallet address. Issuers can configure an **investor wallet policy** (`byo_only`, `investor_choice`, `custodial_only`).

* If `custodial_only` or `investor_choice` is selected, an EVM-compatible wallet can be provisioned via [Tangany](https://tangany.com), and the address is auto-filled.
* Multi-chain (EVM, Solana, etc.) wallet support ensures the correct network is selected.
* For provisioned MPC wallets, investors can export their private key or wallet via Privy.

### Step 4: KYC Verification

If KYC is required for the offering, the investor completes identity verification through one of the supported providers:

* **Sumsub** — An embedded widget appears directly within the checkout page. The investor follows on-screen instructions to upload documents and complete checks.\
  Learn more at [Sumsub](https://sumsub.com).
* **Blockpass** — (If enabled) The investor is directed to Blockpass to complete verification. The system polls for status updates.\
  Learn more at [Blockpass](https://www.blockpass.org).

The checkout flow waits for the KYC result. Once approved, the investor can proceed. If rejected, they are informed and cannot continue.

### Step 5: Payment

The investor selects a payment method from those enabled for the offering:

**Bank Transfer (SEPA/Wire):**

* The investor sees your bank details (bank name, account holder, IBAN, BIC).
* A unique reference code (e.g., OM-1234-ABCD) is displayed with a copy button.
* Instructions emphasize including this reference code in the transfer subject line for automatic matching.
* The order status is set to **Pending** until payment confirmation (via CSV reconciliation or manual update).

**Credit/Debit Card (**[**Checkout.com**](https://www.checkout.com)**):**

* A secure card payment form is embedded directly in the checkout page.
* The investor enters card details and submits payment via Checkout.com.
* Upon success, the order is automatically marked **Paid**.

**Crypto Payments (hosted PSP via** [**Coinbase Commerce**](https://www.coinbase.com/commerce)**):**

* Investors are redirected to a hosted payment page by Coinbase Commerce where they can pay with supported crypto tokens.
* Issuers can choose to settle proceeds in fiat or keep them as crypto.
* Upon payment confirmation, the order status is updated automatically.

**Stablecoin (on-chain):**

* The investor is shown a unique deposit address and QR code.
* Accepted tokens and blockchain networks are listed.
* The system monitors the blockchain and confirms payment upon receipt.

### Step 6: Confirmation

After submitting their order, the investor sees a confirmation screen with:

* Order reference code
* Investment amount and token amount
* Selected payment method
* For bank transfers: a reminder of wire instructions and reference code
* For stablecoin: the deposit address and expected amount

The investor also receives a confirmation email with these details.

### Document Agreements

If any offering documents require investor agreement, checkboxes appear during checkout. The investor must check each required agreement box to submit the order.

## Embedded Widget

You can embed the offering or portfolio experience in your own site or app:

* Investment widget: `<https://om.bitbond.com/invest/{subdomain}/{slug}/widget>`
* Portfolio widget: `<https://om.bitbond.com/invest/{subdomain}/portfolio/widget>`

## Portfolio View

Signed-in investors can access their portfolio from the navigation bar. The portfolio page provides two tabs: **Portfolio** and **Settings**.

### Portfolio Tab

#### Wallet Card

* Displays one or more wallet addresses (EVM, Solana, etc.) with copy buttons and explorer links.
* Shows token holdings aggregated across all paid orders with real-time on-chain balances.
* For Privy-managed MPC wallets, an **Export Private Key** button allows secure key export via Privy.

#### Summary Stats

* Total invested amount
* Total number of orders
* Number of paid orders

#### Order List

Each order appears as a card showing:

* Offering name (link back to the Invest Page)
* Reference code
* Investment amount, token amount, and order date
* Current status badge (Pending, Paid, Processing, Cancellation Requested, Refunded, Cancelled, Failed)
* Payment method
* For stablecoin orders: transaction hash with a link to the blockchain explorer, confirmation timestamp, and any flag reason

#### Order Cancellation

If the offering has a cancellation period configured and the order is within the allowed window, a **Cancel Order** button appears. Orders can only be cancelled while in **Pending** status and before the configured deadline. Upon cancellation request, the issuer is notified to process a refund.

### Settings Tab

Investors can manage their profile and settings:

* View and update personal or business details
* Review KYC status with badges (Not Started, Pending, Approved, Rejected)
* Manage connected wallets and view wallet history entries
* Log out

***

External API documentation is available as an interactive OpenAPI reference at <https://om.bitbond.com/api/docs>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bitbond.com/asset-tokenization-suite/offering-manager/investor-experience.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
