Payment methods

You can let ICEPAY handle payment-method selection or display the available payment methods in your own checkout.

If you do not provide a payment method when creating a payment, the customer is sent to ICEPAY Checkout where they can choose from the methods available for your merchant.

If you want the customer to choose a payment method in your own checkout, retrieve the available methods first and provide the selected method when creating the payment.

Tip

You do not need to retrieve payment methods if you want ICEPAY Checkout to handle payment-method selection.

Request

Retrieve the payment methods available for your merchant.

The response contains an id and description for each available payment method.

Use the id as the payment method type when creating a payment.

Provide a payment method

After the customer selects a payment method in your checkout, include its id in the paymentMethod object when creating the payment.

For example:

{
  "paymentMethod": {
    "type": "ideal"
  }
}

Do not hard-code the available payment methods in your integration. Retrieve them from the API so your checkout reflects the methods available for the merchant.

Redirect the customer

How you continue the payment depends on whether you provided a payment method.

Without a payment method

If no payment method is provided, use links.checkout from the payment response.

The customer is redirected to ICEPAY Checkout where they can choose how they want to pay.

With a payment method

If you provide a payment method, the payment response may contain links.direct.

Use this URL to send the customer directly to the selected payment method without showing the ICEPAY Checkout payment-method selection first.

Note

links.checkout is always available. If your integration specifies a payment method, use links.direct instead when it is returned.

Create the payment

Once the customer has selected a payment method, provide its id when creating the payment.

Create a payment

Create the payment and send the customer to the appropriate checkout or payment URL.

Continue with the API

Refund a payment

Return all or part of a completed payment to the customer.

Back to the overview

Return to the Checkout API integration overview.