wongate.com ↗
Commercial digital platform

Move money.
Build trust.
Scale further.

A polished, practical guide to configuring and operating Wongate for wallets, remittance, payments, cards, marketplaces, and financial operations.

● For platform owners, operators, merchants, agents, and end users
AOAlex Okafor•••
Total balance$42,840.50 ↗ +$240.20 today
↑Send↓Receive⇄Exchange▣Cards
Received from James+$500.00
Merchant payment−$89.99
Welcome to Wongate

One platform, every financial workflow.

Wongate brings wallets, cross-border money movement, P2P payments, virtual cards, merchant collection, marketplace commerce, and operational controls into one configurable platform.

◈

Wallet infrastructure

Manage fiat and crypto balances with clear, auditable actions.

Explore wallets →
↗

Global payments

Configure corridors, gateways, QR payments, and settlement workflows.

Explore payments →
✓

Trust & controls

Build operational confidence with identity, AML, fraud, and role controls.

Explore security →
00
Before you install

Server requirements

Prepare the hosting environment before uploading Wongate. Exact versions can depend on the Wongate release you received; confirm them against that release's composer.json and release notes.

01

Runtime

  • PHP version supported by your Wongate release (PHP 8.3+ is a sensible baseline for the supplied Laravel-based product; use the release's stated requirement).
  • PHP extensions: openssl, pdo, tokenizer, xml, json, fileinfo, mbstring, curl, bcmath, and ctype.
  • Enable allow_url_fopen if required by the release or its integrations.
02

Database & web server

  • MySQL 8.0+ or MariaDB 10.3+ (confirm compatibility with the delivered schema).
  • Apache with URL rewriting or Nginx with the correct Laravel front-controller configuration.
  • HTTPS certificate for the production hostname.
03

Access & services

  • cPanel File Manager, database tools, and PHP selector.
  • SSH/Terminal is recommended for Artisan and Composer commands.
  • Writable by the PHP process: storage/ and bootstrap/cache/.
  • Queue processing and scheduled tasks configured where the enabled features need them.
Release-specific check

Do not upgrade PHP, Laravel, or database versions by guessing. If your hosting panel cannot provide the release's required runtime or extensions, ask the host to enable them before installation.

01
Deployment walkthrough

Installation guide for cPanel

This walkthrough assumes you have a licensed Wongate release archive and the database installation instructions supplied with that release.

Protect your application files

Laravel's web document root must be the release's public/ directory. Keep .env, app/, vendor/, SQL dumps, and the rest of the application outside the publicly served directory whenever your host allows it. Never publish default passwords or real secrets.

1

Back up and upload the Wongate release

Back up the target account before replacing an existing site. In cPanel File Manager, upload the Wongate archive to a private application directory (for example /home/CPANEL_USER/wongate) and extract it there. Do not upload an archive containing secrets to a public download location.

Confirm that the extracted release includes its expected Laravel folders, such as app/, bootstrap/, public/, resources/, routes/, and storage/.

2

Point the domain to Laravel's public directory

In cPanel Domains, set the site's document root to the release's public/ folder, for example /home/CPANEL_USER/wongate/public. If the provider forces public_html, follow its supported Laravel deployment method so only the public entry point and public assets are served. Do not expose the project root.

Enable HTTPS for the domain and make sure the certificate covers the exact hostname.

3

Create a database and database user

Use cPanel's MySQL Databases tool to create a database and a dedicated user. Assign the privileges needed by the release's schema installation. Use a unique password and record the final database name/user exactly as cPanel displays them (cPanel often adds an account prefix).

Use either the SQL import supplied with the release or the documented migration/install process—do not import a schema and then blindly rerun migrations unless the release specifically instructs you to.

4

Install the supplied database schema

If the Wongate release includes a database dump, import that release's documented SQL file using phpMyAdmin. Check the release instructions for the correct filename and location; do not assume it has a particular name. Otherwise, use the release's official migration or installer procedure.

Confirm the import completed without errors and that the database tables were created before proceeding.

5

Configure the environment file

In the project root (not the public directory), copy the release's .env.example to .env if that is how the release is packaged. Set the production URL and database settings:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://your-domain.example

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=CPANEL_DATABASE_NAME
DB_USERNAME=CPANEL_DATABASE_USER
DB_PASSWORD=USE_A_UNIQUE_SECRET

Use the actual keys from the delivered release's environment template. Generate an application key using the release's documented command if one is not already provided. Keep that key stable after installation; changing it can invalidate encrypted data and sessions. Never paste real credentials into documentation or support messages.

6

Set safe file ownership and permissions

Ensure the PHP-FPM/web-server account can write to storage/ and bootstrap/cache/. Use the narrowest permissions supported by your host, commonly directory mode 775 with correct ownership. Avoid 777; ask hosting support to correct ownership if permission changes alone do not work.

7

Install dependencies and clear stale caches

If SSH is available and the release includes composer.json and composer.lock, run Composer with the same PHP version used by the website, using the release's deployment instructions. If dependencies are pre-bundled, do not run an unrequested dependency upgrade.

cd /home/CPANEL_USER/wongate
php artisan optimize:clear

Run Artisan from the Laravel project root. Do not run installation commands against a different project directory by mistake.

8

Configure queues and scheduled tasks

If the enabled features use queued mail, notifications, or jobs, configure a persistent queue worker through a hosting-supported process manager. On cPanel without a process manager, ask the host which queue-worker method it supports and use Wongate's release instructions.

If the release explicitly supports a cron-based worker, use its documented command and the correct PHP CLI path. A short-lived pattern may look like this (replace paths and PHP binary after confirming them with your host):

* * * * * cd /home/CPANEL_USER/wongate && /path/to/php artisan queue:work --stop-when-empty --max-time=55 --tries=3

Do not schedule a worker that stays running every minute; this can create overlapping worker processes. Add Laravel's schedule:run cron only if the release uses scheduled tasks.

9

Finish first-run configuration

Open the site over HTTPS and follow the release's first-run or administrator setup instructions. Create a unique administrator account; do not rely on example credentials from unrelated scripts or sample documentation. Configure mail, payment providers, SMS, API/webhook settings, and any enabled compliance integrations from the admin area using production-safe secrets.

10

Test before launch

Verify sign-in, registration, password reset, mail delivery, queue activity, and each enabled payment or wallet flow in the appropriate sandbox. Confirm transaction references and ledger/reconciliation behavior. Check application and PHP logs, then disable debug mode and remove temporary installers, SQL dumps, and backups from all public paths.

Need an Nginx server instead?

Use a dedicated Nginx virtual host for each hostname. Its root should point to Wongate's Laravel public/ directory, and the site must pass non-file requests to /index.php?$query_string. Do not point multiple unrelated domains at the same project root. See Production readiness and your server administrator for PHP-FPM and TLS paths.

02
Getting started

Access & onboarding

Set up secure entry points and route new users and agents through an accountable approval journey.

Wongate user sign-in screen
User sign-inCredentials and verification entry point.
Wongate agent registration form
Agent applicationCollect details for an approval workflow.
Wongate two-factor authentication settings
Account securityUse layered controls before production access.
03
Everyday money

User wallet

Give customers a clear view of balances, identity status, transactions, remittance, and plans.

Wongate user dashboard
User dashboardBalances, quick actions, and recent activity.
Wongate wallets screen
WalletsFiat and crypto wallets with transaction actions.
Wongate user remittance screen
International remittanceCorridors, exchange rates, and transfer amounts.
Wongate subscription plans
Subscription plansCompare feature access and account limits.
04
Local operations

Agents

Support cash-in and cash-out operations with queues, approvals, commissions, and clear handover controls.

Wongate agent dashboard
Agent dashboardDaily counter activity, commissions, and pending requests.
05
Business payments

Merchants & payments

Connect merchants to wallets, gateways, API credentials, webhooks, and QR collection.

Wongate merchant dashboard
Merchant dashboardReadiness, wallet coverage, and gateway status.
Wongate merchant API console
API configurationSandbox, production, gateways, and webhooks.
Wongate merchant QR code
Merchant QRReceive payments into a selected wallet.
06
Commerce layer

Marketplace & commerce

Configure peer-to-peer offers, products, vendors, escrow, commissions, and order limits.

Wongate P2P marketplace dashboard
P2P marketplaceOffers, fees, disputes, and marketplace status.
Wongate e-shop marketplace
E-shop marketplaceCatalog-driven vendor commerce.
Wongate escrow management
Escrow managementRelease conditions and dispute states.
07
Digital assets

Cards & digital assets

Manage virtual card lifecycle, cardholders, providers, and crypto asset configuration.

Wongate virtual cards
Virtual cardsRequests, spend, and cardholder access.
Wongate cardholder management
CardholdersIdentity registry and provider compatibility.
Wongate crypto management
Crypto managementSupported assets and operational controls.
08
Control centre

Administration & finance

Keep the operation observable with queues, user management, treasury settings, deposits, ledger, and reconciliation.

Wongate administrator dashboard
Admin dashboardPriority queues and operational statistics.
Wongate admin user list
User accountsSearch, verification, roles, and activity.
Wongate currency management
Currency managementRates, fees, limits, and role access.
Wongate deposit methods
Deposit methodsManual and automatic funding providers.
Wongate ledger
LedgerDouble-entry references and balances.
Wongate reconciliation
ReconciliationRun status and mismatch monitoring.
09
Trust framework

Compliance & security

Protect customers and the business with identity, sanctions, fraud, biometrics, permissions, and integrations.

Wongate AML dashboard
AML dashboardScreenings, cases, and high-risk users.
Wongate sanctions settings
Sanctions settingsProvider configuration and review controls.
Wongate fraud analytics
Fraud analyticsAlert severity and confirmed fraud rate.
Wongate roles and permissions
Roles & permissionsGranular access for operational teams.
Wongate integration center
IntegrationsCore provider registry and statuses.
Wongate system modules
System modulesAML, fraud, and device controls.
10
Make it yours

Reporting & configuration

Adapt the commercial experience with analytics, corridors, gift cards, rewards, and feature controls.

Wongate business analytics
Business analyticsMonitor performance and adoption.
Wongate remittance corridors
Remittance corridorsPairs, spreads, fees, and limits.
Wongate Wallet Earn
Wallet EarnStaking plans, stakes, and rewards.
Wongate feature controls
Feature controlsToggle wallet actions by role.
Before launch

Production readiness

Use this final pass before opening a client deployment to production traffic.

Need a hand?

Build your next money experience with confidence.

For implementation questions, feature requests, and customization inquiries, contact the Wongate team.

Contact support →