worldline Direct
Sign up


Our platform allows you to configure the display order of card brands' logos during the payment process. This feature is particularly useful in cobranded card scenarios, where multiple brand logos may appear. This allows you to guide the selection process in a way matching with your business strategies or agreements with specific card brands.

This feature of brand ordering is available for both Hosted Checkout Page and Hosted Tokenization Page. However, for Hosted Checkout Page, it requires that groupCards is set to true.

Configuring Brand Order

Configure the order on the Hosted Checkout Page/Hosted Tokenization Page by addingcreditCardSpecificInput.paymentProductPreferredOrder to your CreateHostedCheckout/CreateHostedTokenization request. It accepts an array of paymentproductIds, corresponding to the card brands, sorted by decreasing order of preference.

paymentProductIds can be found in our payment methods overview.

Dynamic BIN Detection Interaction

The specified order interacts with our platform's dynamic BIN (Bank Identification Number) detection mechanism. When your customers enter their card number, our platform identifies possible matching card brands. Brands matching the BIN will be displayed on the Hosted Checkout Page/Hosted Tokenization Page. You define the order in which they are displayed in your request. The first card brand in the list is preselected, but customers can choose another brand from the list if they prefer.

Find detailed information about co-badging cards and BIN detection in our dedicated guide.

Default Behavior

Without paymentProductPreferredOrder, the default ordering ensures a logical arrangement based on the scope of card brands:

  • Private brands
  • Domestic brands
  • International brands

Regulatory Compliance

This feature meets the requirements of the European Regulation 2015/751. It allows businesses to set up automatic systems that prioritise certain payment brands or applications during the checkout. However, the regulation also ensures that customers can always override these automatic choices: Customers ultimately decide which payment brand or application they want to use, promoting a fair and customer-friendly payment process.

Was this page helpful?

Do you have any comments?

Thank you for your response.