Create your first test payment

The quickest way to make your first ICEPAY payment is to create a Payment Link in the ICEPAY Portal.

You can use the payment link to open the ICEPAY Checkout Page. From there, select a payment method and complete your first test payment.

Before you start

Make sure that:

• Your merchant is configured.
• You can access the Payment Links page in the ICEPAY Portal.
• You have an enabled merchant available.
• You know the amount, currency, and reference you want to use for the test payment.

Caution

Test Payment Links do not process real payments. Make sure you select a merchant in Test mode while following this guide.

Never share your Merchant Secret. The Portal creates the Payment Link using your merchant configuration, so you do not need to copy credentials into this guide or expose them in your browser or application.

Create a Payment Link

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 use.

2. Open Payment Links

   In the Portal, open Payment Links.

   This page lists Payment Links for the selected ICEPAY Account or merchant. If you have not created a link yet, the list will be empty. Each entry shows its checkout key, reference, amount, status, processing mode and creation date.

   The Portal labels the ICEPAY payment key as the checkout key. The reference is the value you enter to link the payment to an order in your system. See Payment identifiers for the distinction.

3. Start creating a Payment Link

   Select Create Payment Link.

   The ICEPAY Portal opens a form where you can enter the details for the payment.

4. Enter the payment details

   Complete the form with:

   Field	Example	Description
   Reference	ORD-16307	An identifier that links the payment to an order in your system.
   Amount	29.99	The amount you want to use for the test payment.
   Currency	EUR	Select the currency for the payment. The Portal currently supports EUR, GBP, and USD.
   Merchant	My store	Select the enabled merchant that you want to use.
   Expiration	7 days	Choose how long the Payment Link remains valid. By default, it expires after 7 days.

5. Create the Payment Link

   Select Create Payment Link.

   If the link is created successfully, the ICEPAY Portal displays the generated checkout link together with the payment reference and amount.

6. Open or share the checkout link

   Copy the checkout link and open it in your browser.

   The Portal also displays a QR code for the link. You can scan the QR code with a mobile device to open the same ICEPAY Checkout Page.

7. Complete the test checkout

   Select a method on the ICEPAY Checkout Page, then follow the instructions on the ICEPAY Payment Page or the payment provider’s page to complete the test payment.

8. Verify the payment in the Portal

   Return to Payment Links and find the link using its reference.

   Review the payment status. Depending on the checkout flow, a Payment Link can show statuses such as:

   Status	Description
   Started	The Payment Link has been created or the payment flow has started.
   Expired	The Payment Link is no longer valid.
   Completed	The payment has been marked as completed.

   Status updates may not appear immediately. Refresh the page and allow time for the checkout and follow-up processing to finish.

What this test demonstrates

This test confirms the basic ICEPAY payment flow:

1. The Portal creates a Payment Link for your selected merchant.
2. The customer opens the link and selects a method on the ICEPAY Checkout Page.
3. The customer completes the payment.
4. The payment and its status can be monitored in the Portal.

You can now choose how you want to continue with ICEPAY.

What’s next?

Choose an integration method

Choose a platform integration, a Checkout SDK, or a direct integration with the ICEPAY Checkout API.

Go live

Complete the final setup steps and prepare to accept live payments.

---

Troubleshooting

Payment Links is not visible

Your ICEPAY User Account may not have permission to access Payment Links.

Ask your account administrator to confirm that:

• You are using the correct ICEPAY Account.
• Your invitation was accepted.
• Your ICEPAY User Account is enabled.
• You have permission to view Payment Links.

No enabled or test merchant is available

Confirm that the merchant is assigned to the correct ICEPAY Account and is enabled.

If no merchant is available in Test mode, contact your account administrator or the ICEPAY team. Include your account details and Merchant ID if available.

Payment Link creation fails

Check that:

• A merchant is selected.
• The selected merchant is enabled.
• The amount is valid.
• A supported currency is selected.
• The reference is completed.
• The expiry value is valid.

If the link still cannot be created, contact the ICEPAY team and include the error message and Merchant ID. Do not include your Merchant Secret.

The Payment Link has expired

Create another Payment Link with a new expiry period.

An expired link cannot be used to complete the original checkout flow.

The payment status has not been updated

Refresh the Payment Links page and confirm that you are viewing the correct account and merchant.

Status updates may take some time after the checkout is completed. If the status remains unchanged, contact the ICEPAY team with the payment key (shown as the checkout key in the Portal), your reference, the Merchant ID, and the approximate time of the test payment.

Never send your Merchant Secret or other credentials in a support request.