Configure your merchant

After creating your ICEPAY Account, configure your merchant before continuing with payment integration.

A merchant represents a sales channel in ICEPAY, such as a store or application. It contains your business details, payment method settings, checkout configuration, credentials, and processing mode.

This guide covers the initial merchant configuration. For payment testing and live processing, continue with the dedicated guides linked at the end of this guide.

Before you start

Have the following information ready:

• Your trade name.
• Your business website URL.
• A logo and banner image if you want to customise the ICEPAY Checkout Page and ICEPAY Payment Page.

Caution

Never share your Merchant Secret. Store it securely and do not include it in website code, browser JavaScript, public repositories, or any files that others can access.

Configure your merchant

1. Sign in to the ICEPAY Portal

   Open the ICEPAY Portal and sign in with your ICEPAY User Account.

   If your ICEPAY User Account is connected to multiple ICEPAY Accounts, select the ICEPAY Account that contains the merchant you want to configure.

2. Select your merchant

   Open Merchants in the main menu and select the merchant you want to configure.

   If you cannot see the merchant, ask your account administrator to confirm that:

   • You were invited to the correct ICEPAY Account.
   • Your invitation was accepted.
   • Your ICEPAY User Account is enabled.
   • You have permission to manage merchants.

3. Review the general merchant details

   Review the merchant information shown in the Portal, including details such as:

   • Merchant ID.
   • Merchant description.
   • Business website URL.
   • Merchant status.
   • Activation status.
   • Processing mode.
   • Merchant Secret and other credentials.

   Confirm that the information is correct before continuing.

4. Customise your ICEPAY Checkout Page and ICEPAY Payment Page

   If supported for your merchant, open Customize Checkout to configure the appearance of the ICEPAY Checkout Page and ICEPAY Payment Page.

   You can optionally provide:

   • A banner image.
   • A logo or icon.

   Save the changes when you are finished. You can reset the checkout appearance to the default settings if necessary.

5. Save and verify your configuration

   Save any changes you make in the ICEPAY Portal.

   Verify that:

   • Your business and website details are correct.
   • Checkout branding appears as expected.

What happens next?

After configuring your merchant, continue with the guide for creating your first payment. That guide explains how to use your merchant configuration in a payment flow and how to verify your integration.

Continue: Your first test payment

Create and complete your first test payment.

---

Troubleshooting

I cannot see Merchants in the menu

Confirm that your invitation was accepted and that your ICEPAY User Account has the required permissions.

The merchant details are incomplete or incorrect

Review the merchant settings and update the available information.

If a field cannot be changed, or if the information is related to compliance or verification, contact the ICEPAY team.

A payment method is unavailable

In Test mode, all payment methods offered by ICEPAY are available. In Live mode, only the payment methods activated for your account are shown.

If you have questions about available or activated payment methods, contact the ICEPAY team.

My checkout branding does not appear

Confirm that:

• The logo and banner files meet the upload requirements.
• You saved the checkout settings.
• You are viewing the checkout for the correct merchant.
• Your browser is not displaying a cached version of the page.

Reset the checkout settings to the defaults and save them again if the custom branding still does not appear.