# iDEAL 2.0

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

## General requirements

The handling of iDeal payments with Saferpay requires:

* A [corresponding license ](https://docs.saferpay.com/home/master/licensing)and thus 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.
* An iDeal contract **with Worldline.** Others are not supported.

{% hint style="info" %}
For iDeal activation on the Saferpay terminal, please contact your sales contact.
{% endhint %}

### Technical requirements

The general integration of iDEAL can only be done via the [Payment Page](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/payment-page) and requires the following things to be noted:

* The notification URLs, inside the**`Notification`** conatiner are **mandatory**, in order to avoid missing payment successes. See the [Payment Page process](https://docs.saferpay.com/home/licences-and-interfaces/payment-page#notification.successnotifyurl-and-notification.failnotifyurl) for further information.
* The parameter [**`Payment.Payernote`**](https://docs.saferpay.com/home/master/common-saferpay-terms-glossary#payernote) is mandatory. If it is not set, Saferpay will set the Saferpay [**`Transaction.Id`**](https://docs.saferpay.com/home/master/common-saferpay-terms-glossary#transactionid) as its value.
* The [**`Payment.OrderId`**](https://docs.saferpay.com/home/master/common-saferpay-terms-glossary#orderid) is limited to a length of 18 and **no special characters**. Saferpay will automatically filter any special character, to prevent issues.
* iDEAL does not support the [Iframe integration](https://docs.saferpay.com/home/integration-guide/general-information/iframe-integration-and-css). [Saferpay will break out of the IFrame, if necessary](https://docs.saferpay.com/home/general-information/iframe-integration-and-css#iframe-support).
* **Refunds** are technically not directly supported by iDeal. Due to that, Saferpay will perform the refund through other means. Thusly, the payer will not see the refund in their iDeal-App. Aside that, the refund is processed normally.

Furthermore, for other flows (Refunds etc.), please refer to the table Below

### Supported features

| Feature                                                                                                           |                                        Support                                       |
| ----------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------: |
| Capture/Cancel                                                                                                    |                                           ❌                                          |
| Multipart Captures                                                                                                |                                           ❌                                          |
| Secure Card Data                                                                                                  |                                           ❌                                          |
| [Refunds](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/transaction-interface/refunds) | <p><a href="#technical-requirements">✅<br><strong>(needs attention)</strong></a></p> |
| Recurring Payments                                                                                                |                                           ❌                                          |
| 3D Secure                                                                                                         |                                           ❌                                          |
| Dynamic Currency Conversion (DCC)                                                                                 |                                           ❌                                          |
| Mail Phone Order                                                                                                  |                                           ❌                                          |
| [Testing](#testing)                                                                                               |                                           ✅                                          |
| Omni-Channel                                                                                                      |                                           ❌                                          |

## Payment Page integration

iDeal is integrated via the standard [Payment Page integration](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/payment-page).&#x20;

## Testing

Please refer to [this chapter](https://docs.saferpay.com/home/testing-and-go-live#ideal), if you want to test iDEAL.