# 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 ](/home/master/licensing.md)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" %}
Need an iDeal contract? Simply [contact our sales](/home/integration-guide/support.md#worldline-sales-team) to get one.
{% endhint %}

### Technical requirements

The general integration of iDEAL can only be done via the [Payment Page](/home/integration-guide/licences-and-interfaces/payment-page.md) 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/integration-guide/payment-methods/pages/-Me4jFEJClrxX7AII0gz#notification.successnotifyurl-and-notification.failnotifyurl) for further information.
* The parameter [**`Payment.Payernote`**](/home/master/common-saferpay-terms-glossary.md#payernote) is mandatory. If it is not set, Saferpay will set the Saferpay [**`Transaction.Id`**](/home/master/common-saferpay-terms-glossary.md#transactionid) as its value.
* The [**`Payment.OrderId`**](/home/master/common-saferpay-terms-glossary.md#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](/home/integration-guide/general-information/iframe-integration-and-css.md). [Saferpay will break out of the IFrame, if necessary](/home/integration-guide/general-information/iframe-integration-and-css.md#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](/home/integration-guide/licences-and-interfaces/transaction-interface/refunds.md) | <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](/home/integration-guide/licences-and-interfaces/payment-page.md).&#x20;

## Testing

Please refer to [this chapter](/home/integration-guide/testing-and-go-live.md#ideal), if you want to test iDEAL.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.saferpay.com/home/integration-guide/payment-methods/ideal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.