Integration model

Define system ownership and the mandatory separation of PAMM accounts.

Responsibility boundaries

Component	Customer-facing responsibility
External CRM	Users, KYC, internal wallets, products, sponsors or IBs, interface, approvals, and its own reconciliation.
PAMM API	MT5 account provisioning or registration, subscriptions, capital synchronization, withdrawals, controlled unassignment, and performance fee records.
MT5	Final source for accounts, balances, executed money movements, and trading operations.

The PAMM API accepts integration commands and exposes their resulting state. It does not replace the CRM’s customer ledger or authorization process.

How capital moves

CRM-authorized funds
        │
        ▼
Investor MT5 account ── mirrored operating movement ──► Master MT5 account
        │                                                   │
        └── fee debit ──► Master payment account ◄──────────┘

1. External capital is credited only to the Investor account.
2. On assignment, the engine queues the Investor’s current balance for reflection in the Master.
3. Later Investor deposits and withdrawals produce corresponding operating adjustments.
4. Eligible gains contribute to the Investor’s performance fee calculation.
5. The fee is debited from the Investor and credited to the Master’s payment account.

Never deposit directly into a Master account. Its balance must be the consequence of Investor capital and PAMM movements. An external Master deposit breaks pool reconciliation.

Existing MT5 accounts

/master/add and /investor/add register accounts that already exist in MT5. This path is intended for coordinated migrations. For new integrations, prefer /master/create and /investor/create so the account roles are provisioned consistently.

Previous: Overview

Review the account model and sequence.

Next: Authentication

Configure secure server-to-server access.