API

Download ICEPAY API Postman collection

Checksum header

All our API endpoints are secured by a Checksum header.
In the postman collection you’ll find a pre-request script with a Javascript example.

Payment methods

Use the getmypaymentmethods endpoint to load your payment methods. This API will return a list of available payment methods and issuers.

It's also possible to hardcode payment methods and issuers in your implementation, but make sure that the iDEAL issuers are updated. These can be updated multiple times a year. Below an overview of the actual iDEAL issuers and the IssuerKeyword in our API

Issuer name	IssuerKeyword
ABN AMRO	ABNAMRO
ASN Bank	ASNBANK
bunq	BUNQ
ING	ING
Knab	KNAB
Rabobank	RABOBANK
Revolut	REVOLUT
SNS	SNSBANK
RegioBank	SNSREGIOBANK
Triodos Bank	TRIODOSBANK
Van Lanschot	VANLANSCHOT
Yoursafe	YOURSAFE
N26	NTSBDEB1

Create transaction

The checkout endpoint is used to create a simple payment.

Amount is in cents.

The OrderId must be unique.
However, you can use the reference for non-unique identifiers.

URLCompleted and URLError are where a customer gets sent after the payment has been completed or aborted. Use these landing pages to inform the customer but not to change the internal order status. You should only use URLPostback for this to prevent race conditions. This API endpoint will return a PaymentID, which you can later use in the Postback WebHooks or refund request.

Payment methods and issuers examples

Below contains a sample of PaymentMethodCode and IssuerKeyword that can be used.
Note that these can also be received through the getmypaymentmethods endpoint.

Payment method	PaymentMethodCode	IssuerKeyword
iDEAL	IDEAL	ABNAMRO
PayPal	PAYPAL	DEFAULT
Online Überweisen	ONLINEUBERWEISEN	DEFAULT