Custom Payment App – How to Display Logo in Checkout Payment Methods List?

Extensions
1

image
image617×735 23.9 KB

Hello everyone,

We have developed a payment extension that is already live on the Shopify App Store. The integration is working correctly, and merchants can enable it without issues.

However, we are facing a limitation in the checkout experience:

  • Our payment method appears in the checkout page

  • But our logo is not displayed next to the payment option (as shown in the attached image)

:red_question_mark: Questions

  1. How are logos managed for payment methods that do appear with icons (e.g., cards, wallets, BNPL providers)?

  2. Is there a process to have our payment method/icon officially listed (similar to entries in repositories like payment_icons)?

  3. Are there any supported workarounds to show branding within the checkout (e.g., via Checkout UI Extensions)?

    Any guidance or best practices from the community would be highly appreciated.

    Thank you! :folded_hands:

2

Hi @Mahmoud_Hijazi :waving_hand: For payment apps, checkout renders icons from the payment method brand values included with the payment method data. Those brand values need to resolve to known payment icon assets in checkout. Separately, supported_payment_methods values in the payment extension config are validated against payment icon names, which is why an unknown value can fail validation before it ever gets to checkout.

The public route for adding a new icon is Shopify’s shared payment_icons library. If your payment method does not already have an approved icon there, submit it following the repo’s contribution guide.

If the icon already exists there, the next thing to check is whether the brand value in your payment extension matches the icon name Shopify expects. The repo notes that only Shopify Partners team approved icons may be reviewed or merged, so a PR is part of the process rather than a guarantee that the icon will be accepted. There can also be rollout timing after an icon is approved, merged, and released before Shopify checkout surfaces pick up the released version.

Hope this clarifies things for you!