Install and enable

• Bicrypto core installed and running — see Installing Bicrypto
• The purchase code for Forex Broker & Investments — product ID 36668679 — from your MashDiv dashboard
• Shell access to the app server, for pnpm updator
• The cron process alive — check /admin/system/cron shows jobs running
• At least one currency your customers already hold in a FIAT or SPOT wallet

1. The Forex Broker & Investments card — click it to open the product page. The Forex & Multi-Asset Trading card beside it is the separate terminal product
2. Its switch stays disabled, reading Activate license first, until the licence is activated

1. Open the Extension Manager — Admin → System → Extension Manager (/admin/system/extension), heading Add-ons & Integrations. On the Extensions tab, or by searching for Forex, find Forex Broker & Investments and click the card — not the Forex & Multi-Asset Trading card next to it, which is the separate terminal product. Until the licence is activated the switch on the card is disabled and reads Activate license first.

2. Activate the licence — on the product page press Activate License. Paste the purchase code from your MashDiv dashboard, optionally an email address for update notifications, and press Activate License. The screen confirms License Activated! and returns you to the product page a couple of seconds later. If the server has no outbound access, the License File tab on the same screen takes the licence certificate downloaded from your MashDiv dashboard instead, placed as license.txt in the lic folder at the project root.

   1. Paste the purchase code here
   2. Activate License — then wait for the redirect back to the product page
   3. License File — the offline route, for a server with no outbound HTTPS
   4. The product's name and Product ID — 36668679 for this one

3. Install the release — back on the product page, now licensed, the Overview tab has a release panel. If it offers Install v…, press it; if it says Up to date on a product you have only just licensed, press Check for Updates once, then install whatever it offers. The Releases tab holds the notes for the version you are being offered — read them first.

   Install downloads the release, verifies it and extracts it over the project root. It runs no migrations, builds nothing and restarts nothing, so finish it from a shell on the server:

   pnpm updator

   That is the finalise chain — stop, dependencies, schema, seed data, frontend build, start — and it is what creates the seven tables below and the addon's routes. If the panel still says Up to date after the check there is nothing to download; go straight to the next step.

   1. Check for Updates, then Install v… when it is offered
   2. Releases — the notes for the version you are about to install
   3. The Enabled switch — step 4, not yet

4. Switch it on — turn the Enabled switch on, in the product page heading or on the card in the Extension Manager, which is usable now that the licence is verified. This is the product's only on/off switch; there is no separate settings screen and no .env variable. It takes effect without a restart: the admin screens and /forex appear at once, and the scheduler picks up processForexInvestments on its next re-sync, within a minute.

5. Confirm the surfaces appear — Forex Broker & Investments shows up under Admin → Extensions → Investment Products, the user area answers at /forex, and /admin/system/cron lists processForexInvestments under the forex category.

The Forex Broker & Investments item in the admin extensions menu checks access.forex.account, not access.forex. An operator granted only access.forex can load the dashboard by URL but will not see the menu entry. Grant both.

All four are checked server-side. A customer whose verification level does not carry the feature is refused even if they call the API directly. This applies only on installs with verification enforcement switched on — with it off the platform is never stricter than the screens allow.

create_forex_account is deliberately not fatal to the rest of the page. A customer who is not cleared to open a new live account still gets their demo account and every account they already hold, so tightening your levels never locks an existing customer out of their own balance.

Nothing else in the product settles an investment. If the cron process is not running, investments pass their end date and stay ACTIVE indefinitely — the principal has already left the customer's forex account and nothing returns it. Customers notice this within hours of your first short-duration plan maturing.

Check lastRun and lastRunError on that job before investigating anything else about a missing payout.

1. Create a duration — /admin/forex/duration, add 1 HOUR.

2. Create a plan — /admin/forex/plan. Give it a name, pick a wallet type and currency your test user actually holds, set min profit 1, max profit 20, profit percentage 10, default result WIN, minimum amount 10, maximum amount 1000. Attach the 1 HOUR duration. Set its status to active — plans are created disabled.

3. Sign in as the test user and open /forex/dashboard — a DEMO and a LIVE account are provisioned on first visit.

4. Deposit — from the LIVE account card, deposit an amount you hold in the matching wallet. This settles instantly; the forex account balance should change on the spot.

5. Invest — /forex/plan, open your plan, choose the 1-hour duration, accept the terms and invest. The forex account balance drops by the principal.

6. Force settlement — rather than waiting, open /admin/system/cron, find processForexInvestments and run it manually once the end date has passed.

7. Check the payout — the investment reads COMPLETED / WIN at /admin/forex/investment, and the customer's forex account is back up by principal plus 10%.

8. Withdraw — submit a withdrawal as the customer, then approve it at /admin/forex/withdraw. The wallet is credited only at that point.