Who should use this guideThis guide is intended for merchants who:
- Use Payrails as a payment orchestrator
- Use Deutsche Bank through DB Gateway Europa for cards or Wero
- Have access to the DB Gateway Europa dashboard
Create a Deutsche Bank integration in Payrails
- Log in to the Payrails portal.
- Go to Settings → Integrations.
- Select New integration.
Step 1: Choose the provider
- Search for Deutsche Bank and select it.
- Select Next step.
Step 2: Enter basic information
In Payrails- Integration type: keep Payment selected.
- Integration name: enter a clear, consistent name, for example
merchant_deutschebank. Routing uses this name, so include the region or environment when you run more than one Deutsche Bank integration. - Workspaces: select the workspaces where this integration should be available.
- Select Next step.
About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.
Step 3: Enter account information
Credentials
In Payrails
Payrails sends requests to the DB Gateway Europa test environment in test mode and to the live environment in live mode, so use the keys for the matching environment.
In Deutsche Bank
- Log in to the DB Gateway Europa dashboard.
- Go to My Company.
- Copy the API key, the outgoing key and the webhook key.
Payment methods
In Payrails- Select the payment methods to enable for this integration: Card, Wero or both.
- Ask Deutsche Bank to turn on server-to-server card processing on your account before you select Card.
- Ask Deutsche Bank to activate Wero on your account before you select Wero.
Webhooks or notifications
Payrails uses provider webhooks or notifications to receive asynchronous
payment status updates.
Additional data
In Payrails- Optional. Select Add field to add key-value pairs that Payrails includes in the authorization webhook notification. Payrails doesn’t use them to process Deutsche Bank payments.
Request fields for Deutsche Bank
Send these fields in the authorize request for card payments, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to Deutsche Bank when you include them. For more about meta fields, refer to Meta fields.How Deutsche Bank handles cards
- Deutsche Bank authenticates card payments with 3D Secure. The response includes the redirect to the card issuer’s challenge page, and Payrails reads the final result when the customer returns.
- When the authorize request carries an external 3DS result, Payrails sends it to Deutsche Bank, and Deutsche Bank skips its own challenge. The result needs the authentication value, the directory server transaction ID, and a transaction status of
YorA. - Deutsche Bank supports instant and manual capture. With manual capture, you can capture the full amount or a lower amount once.
- You can cancel an authorized payment in full, and refund a captured payment in full or in part, as many times as you need up to the captured amount.
- Card refunds complete in the refund response.
- To verify a card without charging it, authorize an amount of
0.00.
Enable the integration
In Payrails- Select Enable integration.
- Confirm the integration shows as Enabled.
Next steps
- Run a test payment in the DB Gateway Europa test environment.
- Verify that:
- The payment appears in the DB Gateway Europa dashboard.
- The payment status updates correctly in Payrails.
- Once verified in test mode, repeat the setup in live mode.