> ## Documentation Index > Fetch the complete documentation index at: https://waffo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Merchant Portal cashier customization > Configure cashier Logo, theme styles, sub-merchant styles, publishing rules, and permissions in the Merchant Portal. 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 Log in with an account that has the required permissions. Go to **Checkout → Cashier Customization**. Use the left configuration panel to update the Logo, theme colors, base font size, and corner radius. Use the preview area on the right side to check the cashier display. Cashier customization page overview ## Upload merchant Logo Upload the cashier Logo on the **Features** page. | Item | Description | | - | - | | Supported formats | `PNG`, `JPG`, `SVG` | | Recommended size | `40 x 40 px` | | Before upload | Click or drag to upload | | After upload | Replace 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 | Field | Description | | - | - | | Primary Color | Primary color for buttons and highlighted elements | | Background Color | Page background color | | Middle Bg Color | Middle area background color | | Text Color | Main text color | | Secondary Text Color | Secondary text color | | Tertiary Text Color | Tertiary text color | | Danger / Error Color | Danger or error state color | | Info Message Box Color | Information message box color | ### Style parameters | Field | Description | | - | - | | Font Size Base | Base font size | | Border Radius | Corner radius | ## Set the payment method ranking scope In **Cashier Ranking**, use **Rank payment methods by country** to control the payment method ranking scope. By default, the system ranks payment methods based on their popularity in each country or region. After you customize the order on this page, click **Save & Publish** to apply the new ranking. Cashier Ranking with Rank payment methods by country enabled, the IDN selector, and multiple payment methods | Switch state | Ranking and display behavior | | - | - | | On | The country or region selector is available. Select a country or region to configure its payment method order. | | Off | After you confirm the change, the country or region selector is unavailable. All countries and regions share one payment method order and appear on the same cashier page. | Turning off the switch does not disable payment method ranking. It replaces separate country or region rankings with one shared ranking. To change the ranking scope: Select the product type that you want to configure at the top of the page. When the switch is on, select a country or region and update the payment method order for that scope. To use a shared ranking, turn off the switch and click **Turn off** in the confirmation dialog. Check the preview on the right, then click **Save & Publish**. The setting is saved separately for each product type. A SubMID that uses the MID configuration inherits the MID switch and ranking. A separately configured SubMID can save its own setting. If the shared ranking contains more payment methods than the limit shown on the page, the live cashier continues to group payment methods by country or region. Keep country or region ranking enabled, or reduce the number of payment methods to display. ## Move a payment method out of a group In **Cashier Ranking**, you can move a supported payment method from its original group to the top-level ranking area so that it appears as a separate item. Cashier Ranking with the eWallet group expanded, top-level payment methods, and drag handles on the right Expand the group that contains the payment method. Use the drag handle on the right side of the payment method to move it to the target position in the top-level list. Confirm that the payment method shows **Pulled out** and identifies its original group with **From**. Reorder it in the top-level list as needed. Check the preview on the right, then click **Save & Publish**. To undo the change, drag the separate item back to its original payment type group heading. If the original group has no other payment methods, drag the item to the empty group row. Dropping the item on a different payment type group changes only its top-level order. It does not add the item to that group. The combined credit and debit card group does not support moving an individual payment method out of the group. The ranking is saved for the current MID or SubMID, product type, and ranking scope. After you save and publish, newly created orders use the latest ranking. ## 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: Turn off **Apply MID config to all SubMIDs**. Click **Edit** in the sub-merchant list. Configure **Features** and **Style** in the same way as the main merchant. 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 | Role | View configuration | Modify and save | | - | - | - | | Super Admin | Supported | Supported | | Admin | Supported | Supported | | General | Supported | Not supported | | Read-only | Supported | Not supported | | Dev | Supported | Not supported | | Dispute Manager | Not supported | Not supported | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.