iDEAL via Adyen

​

Supported workflows

​

Before you begin

1. Set up an Adyen integration in your workspace. Follow the Adyen integration setup guide if you don’t have one yet.
2. Ask Adyen to enable iDEAL on your Adyen merchant account.
3. In the Payrails Portal, go to Settings → Integrations, open your Adyen integration, select iDEAL under Payment methods, and save.
4. Add iDEAL as a payment option in your workflow.

​

Request fields for Adyen

​

Authorize an iDEAL payment

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "iDeal",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      },
      "storeInstrument": true
    }
  ],
  "meta": {
    "order": {
      "reference": "order-1234"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Adyen handles iDEAL

• Adyen captures iDEAL payments automatically. When Adyen confirms the authorization, Payrails also records the capture, so the payment completes in one step.
• When the payment succeeds, Payrails stores the customer’s IBAN and account holder name from Adyen on the instrument, if Adyen returns them.
• To save the instrument, set storeInstrument to true on the payment composition. Adyen then creates a SEPA Direct Debit mandate, and Payrails charges later merchant-initiated transactions (MIT) against it as SEPA Direct Debit. An MIT requires the stored PSP token.