# FAQ & Troubleshooting

## General

**Where do I access the Offering Manager admin panel?**\
Go to <https://om.bitbond.com> to access the login page. After logging in, you'll be redirected to your dashboard.

**What is a tenant?**\
A tenant is your organization’s dedicated account on the Offering Manager platform. Each tenant is identified by a unique slug and has its own admin panel, offerings, investors, and settings. Tenant data is completely isolated — information is never shared across tenants.

**Can I run multiple offerings at the same time?**\
Yes. You can create and manage as many offerings as you need. Each offering has its own configuration, pricing, dates, and investor landing page.

**What currencies are supported?**\
The Offering Manager supports EUR, USD, GBP, and CHF as base currencies for offering pricing and reporting.

## Account & Login

**I forgot my password. How do I reset it?**\
Use the password reset link on the login page (`/admin/forgot-password`) to receive a reset email. If you logged in with Google SSO, you do not have a separate password — simply use the Google sign-in option.

**I set up two-factor authentication and lost my authenticator app. What do I do?**\
Use one of the backup codes that were provided when you enabled 2FA. Each backup code can only be used once. If you have no remaining backup codes, contact Bitbond support for assistance.

**Can I switch from email/password login to Google SSO?**\
Yes. If your account email matches a Google account, you can use either login method. The system links both methods to the same account automatically.

**I received an invitation to join the Offering Manager. How do I accept it?**\
Follow the link in the invitation email to open the Accept Invitation page (`/admin/accept-invite`). Complete the form to set your login credentials. Once accepted, you can log in to the admin panel.

## Offerings

**What is the difference between a soft cap and a hard cap?**\
The **soft cap** (funding target) is the minimum amount you aim to raise. The **hard cap** is the absolute maximum the offering will accept. The progress bar on the investor landing page shows progress toward the hard cap.

**Can I edit an offering after it is active?**\
Yes, you can update most offering settings while it is active, including payment methods, documents, discount tiers, and landing page content. However, changing fundamental parameters (such as pricing or caps) on a live offering should be done carefully, as it may affect existing investors’ expectations.

**What happens when I change an offering's status to Closed?**\
Closing an offering prevents new investments. Existing orders are not affected — pending orders remain pending, and paid orders remain paid. You can still manage orders, send reminders, and process refunds after closing.

**How do I make an offering visible to investors?**\
Change the offering status from **Draft** to **Active**. Only active offerings are accessible to investors via their landing page URL.

**How can I view the audit history for an offering?**\
On the offering detail page, click **Audit Trail** to see all events related to that offering, including configuration changes, document uploads, and status updates. You can filter by date or event type.

**Can I embed a checkout widget on my website?**\
Yes. Each offering provides an embeddable widget at:

```
https://om.bitbond.com/invest/{tenantSlug}/{offeringSlug}/widget
```

You can include this URL in an iframe or script tag to integrate the investment flow directly into your own site.

## Payment Methods

**Why is a payment method greyed out when I create an offering?**\
A payment method is unavailable if the required credentials have not been configured in Settings. For example:

* Bank transfer requires bank details (bank name, IBAN, BIC).
* Card payments require Checkout.com keys (<https://www.checkout.com>).
* Stablecoin requires an extended public key for each supported chain (EVM-compatible, Solana, etc.).

Configure the missing credentials in **Settings** and the payment method will become available.

**How does bank transfer reconciliation work?**\
When investors pay by bank transfer, they are given a unique reference code (e.g., OM-1234-ABCD) to include in their transfer subject line. To reconcile payments, export a CSV from your bank, then upload it on the offering detail page. The system matches transactions by reference code and automatically marks matching orders as Paid.

**What if an investor sends a bank transfer without the reference code?**\
The automatic reconciliation will not match the transaction. You will need to manually identify the payment and update the order status to Paid from the Orders page.

**How are stablecoin payments verified?**\
Each investor receives a unique deposit address derived from your extended public key. The system monitors multiple chains (EVM-compatible, Solana, and others) for incoming transactions to that address. When a matching deposit is detected and confirmed, the order is automatically updated. Payments that do not match the expected amount are flagged for manual review.

**What is the “Manual” payment method and when should I use it?**\
The **Manual** payment method lets you record offline or custom payment arrangements. No automatic reconciliation is performed — you create the order and later mark it as Paid or update its status manually from the Orders page.

## KYC & Compliance

**Which KYC providers are supported?**\
The Offering Manager integrates with Sumsub (<https://sumsub.com>) and Blockpass (<https://www.blockpass.org>). You can configure one or both in **Settings** and require verification on a per-offering basis.

**Is KYC required for all offerings?**\
No. KYC is optional per offering. When creating or editing an offering, you can choose whether to require KYC verification. If disabled, investors can invest without identity verification.

**What are blocked countries?**\
Blocked countries are jurisdictions whose residents are prevented from investing in your offering. This is enforced during the KYC verification process. You configure the blocked country list when creating or editing an offering.

**What is the cancellation period?**\
The cancellation period is the number of days an investor has to cancel their order after placing it. For example, a 14-day cancellation period means investors can cancel within 14 days. This is often required by financial regulations. Set it to 0 if no cancellation period applies.

## Activity & Audit Log

**Where can I view the system activity and audit trail?**\
The Audit Trail page in the admin panel (`/admin/audit-trail`) shows all system events, including offering updates, order status changes, investor profile edits, and more. Use the filters to scope entries by offering, investor, or event type.

**How do I filter the audit log by offering?**\
On the Audit Trail page, open the Offering filter dropdown and select the offering you want to inspect. The log will refresh to show only events related to that offering.

**How do I filter the audit log by investor?**\
On the Audit Trail page, open the Investor filter dropdown and select the investor you want to inspect. The log will refresh to show only events related to that investor.

## Investors & Orders

**How do I manually create an investor?**\
Go to **Investors** in the admin sidebar and click **New Investor**. Fill in the investor’s details, including name, email, wallet addresses, and KYC status. The investor record is created immediately and appears in the list.

**Can I edit an investor’s profile or KYC status after creation?**\
Yes. On the **Investors** page, open an investor’s profile to update details such as wallet addresses, contact information, and KYC status. All changes are logged in the audit trail.

**Which blockchain wallets can I store for an investor?**\
You can add multiple wallet addresses per investor across supported chains, including EVM-compatible chains (Ethereum, BSC, etc.) and Solana. Specify the chain for each address when creating or editing the investor profile.

**How do I manually create an order for an investor?**\
Navigate to an offering’s **Orders** page and click **Create Order**. Select the investor, enter the amount, choose a payment method (including **Manual**), and set the status. The new order appears in the list and is tracked like any other order.

**Can I manually mark an order as Paid?**\
Yes. On the Orders page, click the status update button next to a Pending or Processing order to mark it as Paid. This action is logged in the audit trail.

**How do I send a payment reminder to an investor?**\
On the Orders page, click the email icon next to a Pending order. The system sends a reminder email to the investor with their order details and payment instructions.

**What does a “flagged” stablecoin payment mean?**\
A stablecoin payment is flagged when the received amount does not match the expected amount (either overpaid or underpaid). Flagged payments require manual review — check the transaction details on the blockchain explorer and update the order status as appropriate.

**How do I export investor wallet addresses for token distribution?**\
Navigate to the offering detail page and click **Export CSV**. The export generates a CSV file with columns: `address`, `amount`, and `chain`. Only investors with a confirmed (Paid) payment and a valid wallet address are included. Use this file with the Bitbond Token Tool for bulk token distribution.

## Settings & Security

**Are my API keys and credentials stored securely?**\
Yes. All sensitive credentials (API keys, extended public keys, webhook secrets) are encrypted with AES-256 before being stored in the database. They are never exposed to the frontend or included in API responses.

**Can I use a custom domain for my investor pages?**\
Yes. Go to **Settings** and enter your custom domain in the Custom Investor Domain section. You will need to configure a CNAME DNS record pointing your domain to `om.bitbond.com`. Once DNS propagates, your investor pages will be accessible at your custom domain.

**How do I generate a new API key?**\
Go to **Settings**, scroll to the API Access section, and click **Generate New API Key**. The key is shown once — copy it immediately.

## API & Integrations

**Where can I find the public API documentation?**\
The public API is documented as an interactive OpenAPI reference at <https://om.bitbond.com/api/docs>.

**What is the base URL for the public API?**\
All public API requests use the base URL:

```
https://om.bitbond.com/api/public
```

## Team Management

**What access do team members have?**\
All team members within a tenant have full access to the admin panel, including offerings, investors, orders, settings, and team management. There are no role-based permission differences among team members.

**How do I invite a new team member?**\
Go to **Team** in the admin sidebar and click **Invite Team Member**. Enter the member’s email address and send the invite. They will receive an email with a link to accept the invitation and set their login credentials.

**How do I accept an invitation to join the Offering Manager?**\
Follow the link in the invitation email to open the Accept Invitation page (`/admin/accept-invite`). Complete the form to set your login credentials. Once accepted, you can log in to the admin panel.

**Can I remove a team member without losing their data?**\
Yes. Deactivating a team member revokes their login access but preserves all historical data associated with their account. If you need to permanently delete a team member (e.g., invited by mistake), you can do so only if they have no associated order history.
