Type: Online Banking / Bank Redirect Payment Method (Netherlands)

Payment Flow:

Customer selects iDEAL at checkout.

The merchant creates or confirms a PaymentIntent with payment_method_data.type = ideal.

UseePay returns next_action.redirect.url when customer action is required.

The customer is redirected to the iDEAL payment page, or the iDEAL page is displayed in the checkout flow.

Customer completes the payment using a Netherlands bank app or wallet.

After payment completion, the user is returned to the merchant site, and the merchant receives the payment result by webhook.

Refunds: Supports full and partial refunds; refund processing time depends on channel and acquiring rules.

Notes:

Before enabling Ideal payments, please contact UseePay customer service to apply for Ideal activation.

iDEAL is available globally, but customers must have a Dutch bank account. The primary settlement currency is EUR; if another currency is provided, currency conversion will be performed and additional fees may apply.

Supported Transaction Types

Product Support

Supported Countries

One-time Payment

💳 Payment Methods and Amount Limits

1. iDEAL

Currency	Minimum Amount	Maximum Amount
EUR	Depends on channel configuration	Depends on channel configuration

💡 iDEAL amount limits may vary depending on the merchant configuration, acquiring channel, and risk rules.

Integration Guide

Required Fields

Field	Required	Description
`currency`	Required	example `EUR`
`payment_method_data.type`	Required	Must be `ideal`.
`payment_method_data.billing.address.country`	Required	example `NL`.
`payment_method_data.billing.address.fisrt_name`	Required	.
`payment_method_data.billing.address.last_name`	Required	.
`return_url`	Required	URL to return the customer after payment authentication.
`device_data.ip_address`	Required	Customer IP address for risk analysis.

Create and Confirm a PaymentIntent

Create and confirm a PaymentIntent with payment_method_data.type = ideal.

{
  "amount": 10,
  "currency": "EUR",
  "merchant_order_id": "order_202606080001",
  "confirm": true,
  "auto_capture": true,
  "return_url": "https://example.com/return",
  "customer": {
    "email": "customer@example.com",
    "first_name": "Maria",
    "last_name": "Silva",
    "address": {
      "country": "NL"
    }
  },
  "payment_method_data": {
    "type": "ideal",
    "billing": {
      "email": "customer@example.com",
      "name": "Maria Silva",
      "first_name": "Maria",
      "last_name": "Silva",
      "phone": "+5511999999999",
      "address": {
        "country": "NL",
        "city": "Sao Paulo",
        "state": "SP",
        "postcode": "01001000",
        "line1": "Praca da Se 1"
      }
    }
  },
  "device_data": {
    "ip_address": "203.0.113.10",
    "browser": {
      "user_agent": "Mozilla/5.0"
    }
  }
}

When the PaymentIntent requires customer action, the response includes next_action.redirect.

{
  "id": "1012606080000000001",
  "status": "requires_customer_action",
  "currency": "EUR",
  "amount": 10,
  "next_action": {
    "type": "redirect",
    "redirect": {
      "method": "GET",
      "url": "https://pay.dlocal.com/gmf-apm/payments/N-example"
    }
  }
}

Redirect the customer to next_action.redirect.url to complete the payment

iDEAL

💳 Payment Methods and Amount Limits#

1. iDEAL#

Integration Guide#

Required Fields#

Create and Confirm a PaymentIntent#

Flowchart#