Skip to main content
Buckaroo is a leading payment service provider based in the Netherlands that provides comprehensive payment processing solutions across multiple payment methods and regions. iDEAL is a popular online banking payment method in the Netherlands that allows customers to pay directly from their bank account. It is widely used for e-commerce transactions and provides instant payment confirmation.

Setup

Please follow the common Buckaroo instructions to get set up with Buckaroo. After setting up your Buckaroo account, make sure iDEAL is enabled as a payment method in your store settings.

Features

Buckaroo iDEAL payments support the following features:
  • Refunds - Refund transactions in full or in part
  • Transaction synchronization - Keep payment statuses synchronized with Buckaroo
  • Deep linking - Direct integration with iDEAL payment flow links

Supported countries

Buckaroo supports transactions from buyers in NL.

Supported currencies

Buckaroo supports processing payments in EUR.

Limitations

The following features are not supported by this connector:
  • Delayed capture - Authorization and capture must happen together
  • Partial capture - Cannot capture a portion of the authorized amount
  • Void - Cannot cancel transactions once initiated
  • Payment method tokenization - Cannot store payment methods for recurring transactions
  • Zero auth - Zero-dollar verification transactions are not supported
  • Settlement reporting - Settlement reporting is not available

Integration

For iDEAL, the default integration for Buckaroo is through a redirect to a hosted payments page.

Redirect integration

Start by creating a new transaction with the following required fields.
var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "EUR",
    Country = "NL",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "ideal",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);
After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status.
{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/buckaroo/apm.html?token=..."
  },
  "method": "ideal"
}
Redirect the buyer to the approval_url (open in a browser or Webview) so they can complete authentication and approve the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

Testing

Buckaroo has instructions on how to test iDEAL.