European Union
Open Banking bank transfers in EUR
Before you start
Authorization
How to sign your requests with the API token.
Create payment
The base order request that this page extends.
This payment method is not enabled for all merchants. Check availability with your manager.
Overview
| Currency | Country code | Payment method |
|---|---|---|
EUR | ISO 3166-1 alpha-2 of the payer, e.g. DE | Open Banking (bank transfer) |
The payer is redirected to paymentLink, selects their bank and confirms the transfer in online banking.
What is different from a regular order
The order is created through the standard POST /v1/orders endpoint. The base fields (amount, currency, successUrl, failUrl, callbackUrl, etc.) are the same as for a regular order; on top of them you pass the customer object with payer details.
| Field | Type | Description |
|---|---|---|
customer | object | Payer details. The required set is listed below |
Customer fields
Two variants of Open Banking are available. They differ in the payer data they require; which one is enabled for your account is defined by your terminal settings.
Not sure which variant you have? Ask your manager. Sending the wider set of fields (name, country, email and date of birth) works for both.
| Field | Type | Required | Description |
|---|---|---|---|
firstName | string | ✅ Yes | First name |
lastName | string | ✅ Yes | Last name |
country | string | ✅ Yes | Payer country, ISO 3166-1 alpha-2 (e.g. DE) |
email | string | ❌ No | Payer email |
{
"purpose": "Payment for order #1234",
"amount": "1000.5",
"currency": "EUR",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments",
"isFeeOnUser": false,
"customer": {
"firstName": "John",
"lastName": "Doe",
"country": "DE",
"email": "john.doe@example.com"
}
}| Field | Type | Required | Description |
|---|---|---|---|
email | string | ✅ Yes | Payer email |
birthday | string | ✅ Yes | Date of birth, YYYY-MM-DD |
firstName | string | ✅ Yes | First name |
lastName | string | ✅ Yes | Last name |
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"customer": {
"email": "jane.doe@example.com",
"birthday": "1999-12-12",
"firstName": "Jane",
"lastName": "Doe"
}
}Response
The response is a standard order object. The order is created with the CREATED status; redirect the payer to paymentLink to complete the payment.
Order object fields
Other methods in Europe
Trustly
Bank transfers from European banks via Trustly.
Apple Pay / Google Pay
Wallet payments for mobile checkout.