payments
Payments

Wero Merchant Payment 1.0.1

  • Early access

Enables merchants to create Wero payment request and retrieve the request status.

Eu

Payments across the EU

Enables seamless cross‑border payments within the EU. Customers can pay directly from their own bank account.

wow

New functionalities

Introduces additional capabilities. Available features include recurring payments (subscriptions) and pay‑upon‑delivery options.

lock

Safe and secure

Built on the trusted and resilient IT infrastructure of European banks, offering the same high standards that merchants know from iDEAL.

Overview

Wero is a new European payment scheme that will gradually replace iDEAL. The Wero Merchant Payment API can be used by merchants to enable payments across Western Europe via the European Payment Initiative (EPI) scheme. 

Currently, the Wero Merchant Payment API is in Early Access (pilot phase). In October 2026, the API will be available in production to enable merchants to start their technical migration.

The Wero Merchant Payment API provides following functionalities:

  • Initiation of a Wero payment
  • Retrieval of the status of the Wero payment
     

Requirements

To use this API in a production environment, you must have the following:

  • A contract for Wero.
     

Pricing

Pricing information will be provided once it becomes available.

Note: This API is currently in Early Access (pilot phase) and therefore limited to a fixed number of users. If you are interested to use this API, please contact us.

Summary

 
Use this API to:
  • Initiate a Wero payment
  • Retrieve the status of a payment request

Usable by:

This API can be used by merchants that have a Wero contract.

Availability:

This API is available for ABN AMRO merchants in the Netherlands.

Note: This API is currently in Early Access (pilot phase) and therefore limited to a fixed number of users. If you are interested to use this API, please contact us.

How it works

robot

1. Set up your application

Register your application and integrate the Wero Merchant Payment API. Configure your signing keys and prepare the JWS assertion needed to request access tokens.

payment

2. Initiate payment request

Use your access token to create a Wero payment requests. Redirect customers to the Wero payment flow provided by their own bank.

check

3. Retrieve payment status

Use the same access token to request the status of previously created payment requests. Statuses are provided via the Wero scheme and reflect the customer’s completed banking action.

What you need to use this API

one
  • Register an account.
  • Start building your integration in the sandbox environment.
  • The sandbox allows you to simulate Wero payment flows without executing real payments.
Register an account
two
  • Check the requirement section.
  • Make sure you have the right contracts.
  • If you are not sure which contract you need, please contact support.
Not sure? Get support
three
  • Obtain an OV or EV TLS certificate from a supported provider (Digicert, Sectigo, Entrust, or Quo Vadis).
  • Ensure the organization name on the certificate matches the name on the API contract.
  • Submit the request for production access.
Request Production Access

Start building in our sandbox

Want to see what you can do with this API? Add a new app and start experimenting in our sandbox.

Learn the basics
Go to API Documentation

TelephoneNeed help?

Check the frequently asked questions or contact us. We are happy to help.
 

Get support Learn the basics