Skip to main content
You can configure the default Waffo cashier style in the Merchant Portal without code changes. After you save and publish the configuration, newly created orders use the latest style.
API parameters still have higher priority than Portal configuration. If the order creation request includes paymentInfo.cashierAppearance, that order uses the style passed in the API request.

Open the configuration page

1

Log in to Merchant Portal

Log in with an account that has the required permissions.
2

Open cashier customization

Go to Checkout → Cashier Customization.
3

Update settings

Use the left configuration panel to update the Logo, theme colors, base font size, and corner radius.
4

Preview the cashier

Use the preview area on the right side to check the cashier display.
Cashier customization page overview
Upload the cashier Logo on the Features page.
ItemDescription
Supported formatsPNG, JPG, SVG
Recommended size40 x 40 px
Before uploadClick or drag to upload
After uploadReplace or delete the Logo
Logo upload area
Replace and delete controls after a Logo is uploaded
Logo configuration guidance

Set cashier style

Configure the cashier theme on the Style page. You can apply a preset theme or customize colors and style parameters based on your brand guidelines.
Style page theme configuration

Color fields

FieldDescription
Primary ColorPrimary color for buttons and highlighted elements
Background ColorPage background color
Middle Bg ColorMiddle area background color
Text ColorMain text color
Secondary Text ColorSecondary text color
Tertiary Text ColorTertiary text color
Danger / Error ColorDanger or error state color
Info Message Box ColorInformation message box color

Style parameters

FieldDescription
Font Size BaseBase font size
Border RadiusCorner radius

Preview the result

As you update settings, the preview area on the right side shows the cashier result in real time. You can switch the country or region to check the display for different currencies, languages, and payment methods.
Preview result for different countries or regions
Some style fields may not appear immediately in the current preview. This usually does not mean the configuration failed. Cashier page structure can vary by country, region, or product type. If the current preview page does not contain the affected element, the style change will not be visible. Switch to another country, region, or product type to continue checking.

Configure sub-merchant styles

If your account has sub-merchants (SubMIDs), the main merchant (MID) configuration applies to all sub-merchants by default.
Sub-merchant list after unified configuration is disabled
To configure a separate style for a sub-merchant:
1

Disable unified configuration

Turn off Apply MID config to all SubMIDs.
2

Edit a sub-merchant

Click Edit in the sub-merchant list.
3

Configure the style

Configure Features and Style in the same way as the main merchant.
4

Save the configuration

After saving, the sub-merchant status is shown as Customized.
Configuring one sub-merchant does not affect other sub-merchants.
Sub-merchant independent configuration page
To restore a sub-merchant to the main merchant configuration, click Reset in the sub-merchant list and confirm.
Reset a sub-merchant configuration
If you enable unified configuration again, existing sub-merchant custom styles are cleared and all sub-merchants use the main merchant configuration again.
Confirmation before enabling unified configuration again

Save and publish

Changes on the page apply only to the current preview. They are not automatically applied to real orders. After you click Save & Publish:
  1. The current configuration is saved.
  2. Newly created orders use the latest configuration.
If you update settings but do not click Save & Publish, real orders continue to use the last saved configuration.
Save and Publish button

Permissions

RoleView configurationModify and save
Super AdminSupportedSupported
AdminSupportedSupported
GeneralSupportedNot supported
Read-onlySupportedNot supported
DevSupportedNot supported
Dispute ManagerNot supportedNot supported