Appearance
Force bank selection
You can select a default bank and make your customer pay with this bank. You can create a button dedicated to a specific bank (ex. Revolut)

Additional parameters for force bank selection of Revolut EU
| Parameter | Required | Description |
|---|---|---|
| allow_bank_change | false | Whether the customer may still pick their own bank on the Hosted Payment Page. Defaults to true. Send false to skip bank selection entirely — bank_id and bank_country_code then become required. |
| bank_id | false | Bank identifier code (e.g. revolut_eu). Required when allow_bank_change is false. |
| bank_country_code | false | Two-letter ISO 3166-1 alpha-2 country code for the bank (e.g. DE). Required when allow_bank_change is false. |
| customer_iban | false | Customer's IBAN number (e.g. DE89370400440532013000). Minimum 16 characters. |
NOTE
Sending bank_id on its own pre-fills the bank but still lets the customer change it. To remove the bank-selection step altogether you must also send allow_bank_change: false.
Body parameter
json
{
"currency": "EUR",
"amount": 100,
"label": "AnotherTest",
"bank_country_code": "DE",
"bank_id": "revolut_eu",
"customer_iban": "DE89370400440532013000",
"success_url": "https://myshop.com/checkout/success",
"pending_bank_confirmation_url": "https://myshop.com/checkout/pending",
"decline_url": "https://myshop.com/checkout/declined",
"order_ref": "42837M",
"customer_email": "customer@example.com",
"customer_phone_number": "+1234567890",
"customer_billing_info": {
"customer_birth_date": "1990-01-01",
"customer_gender": "MALE",
"customer_country_alpha_2": "US",
"customer_region_alpha_2": "CA",
"customer_city": "Los Angeles",
"customer_street_address": "123 Main St",
"customer_postcode": "90001",
"customer_first_name": "John",
"customer_last_name": "Doe",
"customer_ip_address": "192.168.1.1"
}
}Here is a payload example to force selection of Wise Bank (bank_id=wise_live)
json
{
"currency": "EUR",
"amount": 100,
"label": "AnotherTest",
"bank_id": "wise-live",
"bank_country_code": "DE",
"customer_iban": "BE86948123457823",
"success_url": "https://myshop.com/checkout/success",
"pending_bank_confirmation_url": "https://myshop.com/checkout/pending",
"decline_url": "https://myshop.com/checkout/declined",
"order_ref": "42837M",
"customer_email": "customer@example.com",
"customer_phone_number": "+1234567890",
"customer_billing_info": {
"customer_birth_date": "1990-01-01",
"customer_gender": "MALE",
"customer_country_alpha_2": "US",
"customer_region_alpha_2": "CA",
"customer_city": "Los Angeles",
"customer_street_address": "123 Main St",
"customer_postcode": "90001",
"customer_first_name": "John",
"customer_last_name": "Doe",
"customer_ip_address": "192.168.1.1"
}
}