iDeal

iDeal transactions can also be processed via the Saferpay JSON API. However, as iDeal is a third party provider, there are a few things to consider.

Requirements

The handling of iDeal payments with Saferpay requires:

  • The corresponding Saferpay eCommerce licence and thus the existence of a valid identification with a username and password for the Saferpay system.
  • Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.
  • A valid iDeal merchant account.
  • iDeal is only available via the PaymentPage flow!
  • NotifyUrl: The NotifyUrl is mandatory, in order to avoid missing payment successes. See the Payment Page process for further information!

Attention: For iDeal activation on the Saferpay terminal, please contact your sales contact.

Session Timeouts

Due to special technical restrictions by iDeal, you have to be very careful using it in time-sensitive scenarios. iDeal-transactions usually are finished within the Saferpay Payment Page timeout of 20 minutes. However, due to processing-limitations, iDeal response-times can be way higher than this time frame. So if your session runs into a timeout during this window, it could be, that the transaction is successful, even though your system does not recognize it as such! We generally recommend setting the timeout to 35 minutes, however the processing can take up to 12 hours on iDeal-side! If you are running a time-sensitive process, that requires your session to be lower, than this timne frame, we recommend not using iDeal! Furthermore, we highly recommend using the NotifyUrl for the Saferpay Payment Page, which will be called, once we (Saferpay) get a successful response from iDeal! This way your shop does get the necessary information in case of a success, even after 12 hours and can initiate further processing.

Bank Pre-Selection

You may want to implement the Bank selection for iDeal payments into your shop, or just pre-select the bank for your customer, so they do not have to. Saferpay offers an option, to skip the selection page and jump right to your customers online banking site, so he/she may perform the payment.

Attention: This feature is only available with SpecVersion 1.15 and up!

In order to pre-select the bank, you have to set the parameter PaymentMethods with the value IDEAL, in order to pre-select iDeal in general and then you have to fill in the parameter PaymentMethodsOptions.Ideal.IssuerId with one of the following values, depending on which bank you want to pre-select:

Attention: These Values are issued, by iDeal and underly changes, as they seem necessary! Further information, may be acquired over here.

Last update: 20.05.2020

Test Environment Values

Bank Value
Test Bank 1 0091
Test Bank 2 0092

Production Values

Bank Value
ABN AMRO ABNANL2A
ASN Bank ASNBNL21
bunq BUNQNL2A
Handelsbanken HANDNL2A
ING INGBNL2A
Knab KNABNL2H
Moneyou MOYONL21
Rabobank RABONL2U
RegioBank RBRBNL21
SNS SNSBNL2A
Triodos Bank TRIONL2U
Van Lanschot FVLBNL22

SEPA manual Refunds for iDeal

Saferpay does offer the possibility to accept refunds for certain SEPA-based payment methods. However those need special attention. Reason being, that SEPA does not directly offer refunds, which is just in the nature of the payment-system itself. Due to this, Saferpay offers a workaround, to make manual SEPA-refunds easier for the merchant.

Step 1: Activation

Before you -the merchant- can start accepting refunds, they need to be activated inside the Saferpay Backoffice: alt text

Step 2: Executing refunds

Once the activation has been done, you can execute refunds, like any other payment method. Either via API, or inside the Saferpay Backoffice.

Step 3: Uploading the refunds into your online-banking

This is, where SEPA-refunds deviate from other payment methods, like credit cards. As mentioned before, SEPA does not offer direct refunds via the processing itself. This is why Saferpay first collects all executed refunds inside the backoffice: alt text

These refunds need then to be exported into a special XML-File, which can be done right there inside the Backoffice. The created XML-file can then be uploaded into your online banking-portal, which executes these refunds in a batch, eliminating the need, of doing them all manually. You can download an example-file here.

Important: It may be necessary to contact your bank, for this import-feature to be activated! Some also may not offer it at all!

Caution: SEPA-refund-files from the test-environment can't be uploaded into online-banking portals, since they only contain test-data, thus non-valid IBANs!

Back to Top