Appearance

Brands ​

Purpose: Setup and configure white-label brand/store fronts, custom domains, visual templates, and localized currencies.

Overview ​

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. This shields the parent gateway server brand from checkout customers.

Brands List

Getting Here ​

To access the Brands settings:

  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 ​

The Brands management view contains:

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.

Create Brand Wizard Empty

Fields & Options Reference ​

Brand Settings Field Reference ​

Field / InputTypeRequired?DefaultDescription
Business NameText InputYes—The public facing name of the store.
Contact EmailText InputNo—General business contact email address.
PhoneText InputNo—General business contact phone number.
StatusSelectYesActiveOptions: Active (online), Suspended (blocks checkout), Pending.
TimezoneSelectYesAsia/DhakaSet timezone for reports and date offsets.
Default CurrencyText InputYesBDTCurrency symbol for transactions and ledgers.
Custom DomainText InputNo—Fully qualified domain name mapping to this brand context.
Brand LogoFile UploadNo—Upload file for the checkout brand logo. Recommended: 200x60px PNG.
Brand FaviconFile UploadNo—Browser tab icon. Recommended: 32x32px ICO/PNG.
Primary Theme ColorColor PickerNo#0d9488Theme color for major buttons and accents.
Accent Theme ColorColor PickerNo#0f766eTheme color for button hover states.
Support Contact EmailText InputNo—Customer queries from checkout will route here.
Custom CSS OverridesText AreaNo—Stylesheet rule overrides loaded on the checkout page.
Custom JavaScriptText AreaNo—Script overrides loaded on checkout.

Step-by-Step: How to Use This Page ​

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.

Configuration Guide ​

  • 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 ​

  • ✅ Do: Double-check that your Support Contact Email is active, as customers will receive this address for transaction queries.
  • ✅ Do: Append clear and custom CSS Overrides to make your checkout page align with your main website's look.
  • ❌ Don't: Change the default currency after transactions have been processed, as it will cause inconsistencies in reporting.
  • ❌ Don't: Type http:// or https:// in the custom domain field; only enter the hostname (e.g. pay.example.com).

Must Do ​

⚠️ 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.

  • Domains — Manage DNS checks and domains.
  • Staff — Create and assign staff to brands.
  • Themes — Switch brand visual templates.