Wero

Countries & currencies

Supported countries

• Belgium
• Germany

Supported currencies

• Euro (EUR)

Integration

Redirect your customers to the Wero app/the banking app supporting Wero via integration modes Hosted Checkout Page or Server-to-server. Find a high level overview in the "Process flows" chapter.

Add the following properties to a standard CreateHostedCheckout/CreatePayment request:

{
   "order":{
      "amountOfMoney":{
      "currencyCode":"EUR",
      "amount":100
   },
  "references": {
      "merchantReference": "Your Order ID"		
      "descriptor": "YourCompanyName"
      }
   },
   "redirectPaymentMethodSpecificInput":{
      "paymentProductId":900,
      "requiresApproval": true,
      "paymentProduct900SpecificInput": {
         "captureTrigger": "Shipping",
         }
   },
}

Process flows

Depending on your customers' device(s) used, differences apply:

• With a desktop and a mobile device
• With a mobile device

With a desktop and a mobile device

1. Your customers finalise an order on their desktop device in your shop and select Wero.
2. You send this CreateHostedCheckout/CreatePayment request to our platform.
3. You redirect your customers on the desktop device via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectURL (For CreatePayment requests) to the Wero portal. Your customers scan the displayed QR code with their mobile/tablet device.
4. The mobile/tablet device opens the Wero app/the banking app supporting Wero. Your customers confirm the payment in the app.
5. We receive the transaction result.
6. The mobile/tablet device displays the transaction result in the Wero app/the banking app supporting Wero. We redirect your customers to your returnUrl on their desktop device.
7. You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
8. If the transaction was successful, you can deliver the goods / service.

With a mobile device

1. Your customers finalise an order on their mobile device in your shop and select Wero.
2. You send this CreateHostedCheckout/CreatePayment request to our platform.
3. You redirect your customers via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectUrl (For CreatePayment requests) to the Wero portal.
4. Your customers confirm the payment in the app.
5. We receive the transaction result.
6. The mobile/tablet device displays the transaction result in the Wero app/the banking app supporting Wero.
7. You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
8. If the transaction was successful, you can deliver the goods / service.

Testing

Refer to our Test cases for test data and detailed instructions.

Additional information

Refund payments

When processing refunds, make sure to add property refundReason to your request: 

{
   "amountOfMoney":{
      "currencyCode":"EUR",
      "amount":100
   },
   "references": {
      "merchantReference": "Your-refund-reference"		
      }
   },
  "refundRedirectMethodSpecificInput":{
      "refundRedirectPaymentProduct900SpecificInput":{
      "refundReason": "ReturnedGoods"
      }
   },
}