Skip to main content
OwnPay operates as a single-owner, multi-brand payment gateway system. The primary administrator can create and customize distinct brand identities (stores) that operate under their own domain hostnames, email support routes, visual color palettes, and CSS styles.

Getting here

  1. Log in to the OwnPay admin dashboard as the super-administrator
  2. Under the PEOPLE section in the left sidebar, click Brands

Page sections

1. Brands list table

Lists all configured brands on the server:
  • ID: The unique database identifier of the brand (merchant_id)
  • BUSINESS: The visual trade name
  • DOMAIN: The verified custom domain linked to the brand
  • CURRENCY: Default base ledger and checkout currency (e.g., BDT, USD)
  • STATUS: Active, Suspended, or Pending
  • CREATED: Date the brand was registered
  • ACTIONS: Click Edit to modify brand options, routing settings, and stylesheet overrides

2. Create brand wizard

Accessed by clicking the + Add Brand button:
  • Business Info: Name, contact info, timezone, and default base currency
  • Custom Domain: Link the white-label domain name (e.g., pay.mybusiness.com)
  • Visual Customization & Branding: Upload brand logo and favicon, set primary and accent colors, support mail routes, custom checkout footer text, and inject custom CSS/JavaScript codes

Fields and options reference

Step-by-step: creating a new brand

  1. Click the + Add Brand button
  2. Under Business Info, type the Business Name (e.g., Alpha Store)
  3. Set the base Default Currency (e.g., USD)
  4. Under Custom Domain, input the domain (e.g., pay.alphastore.com)
  5. Choose custom branding colors matching your store’s palette
  6. Click Create to save

Domain middleware resolution

When a custom domain is mapped:
  1. Set the domain name in the Custom Domain input
  2. Configure a CNAME record in your DNS provider pointing your domain to the OwnPay server IP address
  3. The platform’s DomainMiddleware will capture the incoming HTTP host, verify the DNS connection, and automatically load this brand context (custom theme, colors, logo) while blocking access to /admin routes

Best practices

  • Double-check that your Support Contact Email is active, as customers will receive this address for transaction queries
  • Append clear and custom CSS Overrides to make your checkout page align with your main website’s look
  • Do not change the default currency after transactions have been processed, as it will cause inconsistencies in reporting
  • Do not type http:// or https:// in the custom domain field; only enter the hostname (e.g., pay.example.com)
Ensure staff users are explicitly assigned to their brand. If they try to access a brand they are not assigned to, they will be blocked by system role access controls.

Common mistakes and troubleshooting

  • Domains - Manage DNS checks and domains
  • Staff - Create and assign staff to brands
  • Themes - Switch brand visual templates
Last modified on July 15, 2026