Skip to content
ICEPAY Documentation logoICEPAY Documentation logoICEPAY Documentation

Configure your merchant

Configure your ICEPAY merchant details, payment methods, and checkout branding.

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

A merchant represents your business configuration in ICEPAY. It contains your business details, payment-method settings, checkout configuration, credentials, and processing mode.

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

Before you start

Section titled “Before you start”

Have the following information ready:

  • Your business and merchant details.
  • Your business website URL.
  • The payment methods you want to offer.
  • A logo and banner image if you want to customize the checkout page.
  • Any business, compliance, or verification information requested by ICEPAY.

Configure your merchant

Section titled “Configure your merchant”

  1. Sign in to the ICEPAY Portal

    Open the ICEPAY Portal and sign in with your ICEPAY account.

    If you belong to more than one ICEPAY Account, select the account that contains the merchant you want to configure.

  2. Select your merchant

    Open the merchant area 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 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. Complete the merchant and business details

    Open the merchant settings and complete any missing business, operational, or compliance information.

    The exact fields depend on your merchant configuration and ICEPAY onboarding process. If ICEPAY requests additional information or documents, provide them before continuing with your onboarding.

  5. Confirm the processing mode

    Confirm that the merchant is configured for the processing mode you expect to use during setup.

    Use Test mode while developing and configuring your integration. Test mode is intended for integration testing and does not process real customer payments.

  6. Review the available payment methods

    Open the payment-method settings and review the payment methods available for your merchant.

    Payment-method availability and configuration depend on your ICEPAY setup. If a payment method needs to be enabled or changed, contact ICEPAY so the team can assist with the configuration.

    Do not assume that every payment method shown in the Portal is immediately available for processing.

  7. Customize your checkout page

    If supported for your merchant, open Customize Checkout to configure the appearance of the checkout and 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.

  8. Review your integration details

    Confirm that your integration details are ready for the next stage of onboarding, including:

    • The correct Merchant ID.
    • The correct test credentials.
    • Your Redirect URL, if applicable.
    • Your Webhook URL, if applicable.
    • The expected processing mode.
    • The payment methods agreed with ICEPAY.

  9. Save and verify your configuration

    Save any changes you make in the Portal.

    Verify that:

    • Your business and website details are correct.
    • The merchant is active and in the expected status.
    • The expected processing mode is selected.
    • The required payment methods are available.
    • Checkout branding appears as expected.
    • Your integration details are correct.

What happens next?

Section titled “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.

Next: Create your first payment

Troubleshooting

Section titled “Troubleshooting”
I cannot see my merchant

Ask your account administrator to confirm that you have access to the correct ICEPAY Account and that the merchant is assigned to it.

Also confirm that your invitation was accepted and that your 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 ICEPAY Support or your account administrator.

A payment method is unavailable

Payment methods may require configuration by ICEPAY.

Contact ICEPAY with your Merchant ID and the payment methods you want to offer. Do not enable or rely on a payment method until ICEPAY confirms that it is available for your merchant.

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.

I cannot update an important merchant detail

Some business, compliance, or verification details may require assistance from ICEPAY.

Contact ICEPAY Support or your account administrator and include your Merchant ID and the detail that needs to be changed.