Skip to content

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)

an image

Additional parameters for force bank selection of Revolut EU

ParameterRequiredDescription
allow_bank_changefalseWhether 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_idfalseBank identifier code (e.g. revolut_eu).
Required when allow_bank_change is false.
bank_country_codefalseTwo-letter ISO 3166-1 alpha-2 country code for the bank (e.g. DE).
Required when allow_bank_change is false.
customer_ibanfalseCustomer'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"
  }
}