Wero via Deutsche Bank

Accept Wero payments with Deutsche Bank as the payment service provider (PSP). Payrails redirects the customer to the Wero page, where they scan a QR code and approve the payment in the Wero app or their banking app.

Supported workflows

Workflow	Supported
Payrails SDK	✔
Payrails API	✔
Delayed / Manual Capture	✖
Instant Capture	✔
Cancel / Void	✖
Refund / Reverse	✔
Save Instruments	✖
Merchant Initiated Transaction (MIT)	✖

Before you begin

Complete these steps before you send your first Wero payment through Deutsche Bank:

Set up a Deutsche Bank integration in your workspace. Follow the Deutsche Bank integration setup guide if you don’t have one yet.
Ask Deutsche Bank to activate Wero on your DB Gateway Europa account.
In the Payrails Portal, go to Settings → Integrations, open your Deutsche Bank integration, select Wero under Payment methods, and save.
Add Wero as a payment option in your workflow.

Request fields for Deutsche Bank

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.

Field	Status	Description
`merchantReference`	Required	Set when you create the execution. Sent to Deutsche Bank as the reference on the customer’s bank statement. Use up to 35 characters from letters, digits, spaces and `/ - ? : ( ) . , ' +`.
`amount.currency`	Required	Use `EUR`.
`meta.customer.email`	Required	Sent to Deutsche Bank as the customer email. You can send `meta.customer.phone.number` instead.
`meta.order.billingAddress.city`	Required	Sent to Deutsche Bank as the billing city.
`meta.order.billingAddress.postalCode`	Required	Sent to Deutsche Bank as the billing postal code.
`meta.order.billingAddress.country.code`	Required	Sent to Deutsche Bank as the billing country, for example `DE`.
`meta.customer.phone.countryCode`, `meta.customer.phone.number`	Optional	Sent to Deutsche Bank as the customer phone number, with the dialing code in front.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent to Deutsche Bank as the customer name.
`meta.order.billingAddress.street`, `meta.order.billingAddress.doorNumber`	Optional	Sent to Deutsche Bank as the billing street address.
`meta.clientContext.ipAddress`	Optional	Sent to Deutsche Bank as the customer IP.

Authorize a Wero payment

Create the execution with a merchantReference that fits the Wero format, for example order-4821. Then call authorize a payment with wero as the paymentMethodCode. The response includes the redirect to the Wero page.

Authorize request

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "wero",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Max",
      "lastName": "Mustermann",
      "email": "max.mustermann@example.com"
    },
    "order": {
      "billingAddress": {
        "street": "Teststr.",
        "doorNumber": "1",
        "city": "Berlin",
        "postalCode": "10115",
        "country": {
          "code": "DE"
        }
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

The customer scans the QR code and approves the payment in the Wero app or their banking app. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Deutsche Bank handles Wero

Payrails checks the merchant reference, the customer contact and the billing address before it calls Deutsche Bank.
Deutsche Bank captures Wero payments as soon as the customer approves them, so the payment completes in one step.
Wero sends the customer back to your site after they approve or decline the payment. Payrails then reads the final result from Deutsche Bank, and Deutsche Bank also sends it as a notification.
When the customer declines the payment in the app, Payrails marks it as canceled by the customer. When the customer leaves the Wero page without approving, Deutsche Bank closes the payment after about 10 minutes, and Payrails marks it as abandoned by the customer.
You can refund a Wero payment in full or in part, as many times as you need up to the paid amount. A refund stays pending until Deutsche Bank sends its result as a notification, usually within seconds.
Each Wero payment is a new customer-initiated payment.

Getting Started

Payment Orchestration

Fraud Management

Chargebacks

Analytics & Reporting

Supported workflows

Before you begin

Request fields for Deutsche Bank

Authorize a Wero payment

How Deutsche Bank handles Wero

​Supported workflows

​Before you begin

​Request fields for Deutsche Bank

​Authorize a Wero payment

​How Deutsche Bank handles Wero

Supported workflows

Before you begin

Request fields for Deutsche Bank

Authorize a Wero payment

How Deutsche Bank handles Wero