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 | N26 |
| Nationale Nederlanden | NATIONALENEDERLANDEN |
Create transaction
The checkout endpoint is used to create a simple payment.
Request
| Variable | Information |
|---|---|
| Timestamp | |
| Amount | In cents |
| Country | |
| Currency | |
| Description | |
| Issuer | |
| Language | |
| OrderID | Must be unique + maxium 10 characters |
| PaymentMethod | |
| Reference | for non-unique identifiers. |
| URLCompleted | Where a customer gets sent after the payment has been completed. Use these landing pages to inform the customer but not to change the internal order status. |
| URLError | Where a customer gets sent after the payment has been aborted. Use these landing pages to inform the customer but not to change the internal order status. |
| URLPostback | Use this URL to change the internal order status. |
| EndUserIP |
Response
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 |