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 |