Miracle Docs

Portal Overview

The Miracle Portal is a unified web application for managing your PSP operations. It serves five experience modes based on your user layer — each designed as a purpose-built experience, not a stripped-down version of another.


Experience Modes

Operator Portal

Full platform management. As an operator, you have access to merchant onboarding (companies, merchants, KYB, partners), infrastructure configuration (terminals, providers), payment routing, fee schedules, risk management, settlement and withdrawal oversight, and user administration across the entire platform.

Merchant Portal

Payment operations for your business. As a merchant user, you see your transaction history, balance overview, webhook configuration, and API key management. The interface is streamlined for day-to-day payment operations without the complexity of platform-wide controls.

Company Portal

Company-level management across merchants. As a company user, you see the merchants under your company, financial data, business settings, and team management. The navigation is similar to the merchant experience but scoped to the company level.

Owner Portal

Super-operator with platform-level management. As an owner, you inherit the full operator navigation with cross-tenant data scope, plus exclusive sections for tenant management, platform settings, platform revenue, analytics, and the global provider registry.

Partner Portal

View assigned merchants, commissions, settlements, and withdrawals. The partner experience is a minimal flat navigation designed for partners who need visibility into their referred merchants and earned commissions.

Your experience mode is determined automatically when you sign in. You do not choose a mode manually — the Portal reads your user layer from your account and renders the appropriate interface.


  • Left sidebar groups pages by domain (Transactions, Merchants, Routing, etc.). The sections you see depend on your user layer and permissions.
  • Entity context switching lets operators scope their view to a specific merchant. When you select a merchant context, lists and dashboards filter to show only that merchant's data.
  • Livemode / testmode toggle in the header switches between production and sandbox environments. See Live / Test Mode for details.

Key Features

  • Server-driven UI: page structure, columns, filters, and available actions are all configured on the server. The Portal renders what the backend provides, pre-filtered by your permissions. Nothing is hardcoded on the client side.
  • Role-based access: you see only the sections and actions your permissions allow. If a page or button is not visible, your role does not include that permission.
  • Real-time data: lists and detail pages reflect the current state. Dashboard widgets update automatically.

Portal Sections

Operator Sidebar

The table below shows the main sidebar sections available to operators.

SectionWhat it covers
DashboardKPIs, quick actions, activity overview (standalone item)
Approval QueuesPending approvals with badge count (standalone item)
MerchantsCompanies, merchants, KYB submissions, partners
PaymentsTransactions, payment links, refund requests, routing rules, decline reasons
InfrastructureTerminals, providers
FinanceFee schedules, fee assignments, settlements, provider settlements, withdrawals, withdrawal methods, withdrawal method config, earnings, funding accounts
Risk ManagementAntifraud plans, scoring rules, block/allow lists, risk config, reports
AdministrationUsers, roles, API keys, invitations, impersonation

Merchant Sidebar

Merchant users see a streamlined set of sections focused on business operations.

SectionWhat it covers
DashboardPayment metrics, balance overview, KYB status (standalone item)
PaymentsTransactions, payment links, refund requests
FinanceBalance, statements, settlements, withdrawals, withdrawal methods, earnings
BusinessKYB verification, users, invitations
SettingsIntegration, webhooks, API keys
ReportsReports

Merchant user management is inside the Business section (not a standalone "Users" section or inside Settings). This reflects how merchants think about "my team" as part of their business, not as a platform administration task.

Company Sidebar

Company-layer users see the same sections as merchants, plus the Merchants section for managing merchants under their company.

Owner Sidebar

Owners inherit the full operator navigation plus an exclusive Platform section (tenants, platform settings, platform revenue, analytics) and a separate Providers section for the global provider registry.

Partner Sidebar

Partners see a flat list of standalone items: Dashboard, My Merchants, Commissions, Settlements, Withdrawals, Profile. No collapsible sections.

On this page