Payment icons customization

Topic summary

  • Goal: A Shopify payment app developer asks if payment method icons on the checkout page can be shown dynamically by customer country (e.g., only VISA and Sofort for Germany) using Checkout Payment Customizations.

  • Guidance provided: A reply states conditional customization is possible with the Shopify Payment Customization API, which can hide, reorder, or rename payment methods based on conditions like the customer’s location. Feasibility may depend on the payment gateway’s capabilities, and country-specific logic would be required.

  • Clarification: The requester specifies they do not want to add/remove payment methods, but only change which icons are displayed within the same payment method to mirror the options shown on their offsite payment page.

  • Status: Unresolved. There is no confirmation that the API supports icon-level dynamic display without altering available methods. The key open question is whether icon rendering can be customized per country independently of method availability. An image was included as an example but is not essential to understand the issue.

Summarized with AI on January 20. AI used: gpt-5.

Hi everyone, I’m developing a payment app for Shopify and I’m just wondering if we can display the payment method icons dynamically on the checkout page depending on the customer’s country, e.g. only show VISA and Sofort for German customers. Is it possible to do this using the payment customization described here https://shopify.dev/docs/apps/checkout/payment-customizations ?

Hi Skrill,

Yes, it’s possible to customize the payment options available to customers during checkout based on certain conditions, working with the tutorial you’ve linked. You can create conditions based on various factors, one of which could be the customer’s location or country.

The Shopify Payment Customization API allows you to create custom functions that can manipulate the checkout process, including hiding, reordering, or renaming available payment methods.

However, do note that being able to show/hide specific payment methods depending on the customer’s country might be dependent on the payment gateway’s capabilities and what they support.

You’ll also need to ensure that the logic in your payment customization function accounts for the country-specific conditions you want to implement.

Hope this helps!

1 Like

hi @Liam , thank you for your answer. The idea is not to dynamically add or remove payment methods but to display the icons dynamically (based on country) in the same payment method. The purpose of this is to sync the icons with the payment methods available on the offsite payment page.