iDEAL | Wero - Paybyrd

iDEAL | Wero is an online payment method that enables consumers to pay online through their own bank. In addition to webshops, other organizations that are not part of the e-commerce market also offer this payment method. iDEAL | Wero is used beyond e-commerce — for energy bills, donations, mobile credits, and local taxes.

How it works

Flowchart depicting iDEAL | Wero payment flow

When a customer selects iDEAL | Wero, they are redirected to their bank’s online banking page to log in and complete the payment. Regardless of the outcome, the customer is then redirected to the merchant store. The transaction result is delivered via webhook. Query the API or listen for webhook notifications to confirm the final status. We accept the following banks:

Bank code	Bank name
BUNQNL2A	Bunq
INGBNL2A	Ing
KNABNL2H	Knab
RABONL2U	Rabobank
RBRBNL21	RegioBank
SNSBNL2A	SNS Bank
TRIONL2U	Triodos Bank
ABNANL2A	ABN AMRO
FVLBNL22	Van Lanschot
ASNBNL21	ASN
HANDNL2A	Handelsbanken
REVOLT21	Revolut

Create payment

curl --request POST \
 --url https://gateway.paybyrd.com/api/v2/payment \
 --header 'Accept: application/json' \
 --header 'Content-Type: application/json' \
 --header 'x-api-key: {your_api_key}' \
 --data '
{ 
 "type":"OnlineTransfer",
 "amount": "10.00",
 "currency": "EUR",
 "brand":"ideal",
 "bankIdentifierCode": "INGBNL2A"
}'

{
 "bankIdentifierCode": "INGBNL2A",
 "type": "OnlineTransfer",
 "currency": "EUR",
 "brand": "ideal",
 "action": {
   "type": "redirect",
   "url": "https://webapp-redirect-api-stg.azurewebsites.net/api/v1/Redirect/58d75973-87e3-4da7-b8f4-ab2bfb3ea9da"
 },
 "code": "BYRD207",
 "description": "Pending redirect",
 "transactionId": "58d75973-87e3-4da7-b8f4-ab2bfb3ea9da",
 "amount": "10.00"
}

See the full API reference for more details. Check the code field to know whether the transaction was accepted. A successful scenario returns the code BYRD207. You can find the list of all status codes in the Response code reference.

Accept Payments

Manage Payments

iDEAL | Wero

How it works

Create payment

​How it works

​Create payment

How it works

Create payment