Greater control over payment method display

We have introduced a new parameter, paymentMethodOrder, giving you dynamic, precise control over which payment methods are displayed and the order in which they appear at checkout.

Previously, you could only specify a single preferred method using the paymentMethod parameter. Now, you can:

• Specify multiple methods (Allow-list): Use paymentMethodOrder in conjunction with hideOtherPaymentMethods=true to display only a selected list of payment options (e.g., ['ideal', 'paypal', 'card']). This allows for dynamic, regional payment targeting.
• Custom ordering: Define the exact display order of all eligible payment methods your customers see.
• Flexible preselection: In Inline checkout, the first visible method in your defined order list may be preselected (unless paymentMethod is also used).

This update replaces the need for complex logic to manage multiple payment method visibility, offering a simpler, more robust solution for customizing your checkout flow.

For complete details on compatibility, behavior in Stacked vs. Inline modes, and usage examples, please visit our documentation:

👉 Configure payment methods