README

This Magento 2 module is the Hyvä adapter for the payment-icon library. The SVG marks and the framework-agnostic renderer now live in siteation/magento2-icons-payment (which works on Luma, Hyvä, Nebula or any theme); this package adds the Hyvä-only conveniences on top:

Hyvä-CMS icon picker + {{icon "payment/…"}} template tag (the payment prefix mapping), and
the Siteation\HyvaIconsPayment\ViewModel\PaymentIcons / …Flat / …Mono view models (Hyvä SvgIcons-based), kept for backwards compatibility.

You only need this package for Hyvä-CMS icon authoring. For plain rendering — in a Luma/Nebula theme, or a framework-agnostic surface like the Siteation standalone checkout — require siteation/magento2-icons-payment directly instead.

Installation

Install the package via;

composer require siteation/magento2-hyva-icons-payment
bin/magento setup:upgrade

Warning This Module requires Magento 2.4 or higher and requires Hyva! For more requirements see the composer.json.

How to use

By default this module loads nothing.

To use this icon pack instead of the default Hyva icons, add the following to your phtml file;

<?php
use Hyva\Theme\Model\ViewModelRegistry;
use Siteation\HyvaIconsPayment\ViewModel\PaymentIcons;

/** @var ViewModelRegistry $viewModels */

/** @var PaymentIcons $paymentIcons */
$paymentIcons = $viewModels->require(PaymentIcons::class);

and use the PaymentIcons just as the HeroIcons in Hyva;

<?= $paymentIcons->idealHtml('p-1', 64, 48, ["aria-label" => "Pay with iDeal"]) ?>

Preview of each style

We offer this icon pack in 3 styles:

Default

Flat

Mono

Using SVG icons in CMS content

You can now also use the SVG icons in your CMS content.

Bringing svg icon support to you CMS pages, Blocks and Widgets.

{{icon "payment/default/ideal" classes="inline-block" width=64 height=48}}
{{icon "payment/flat/ideal" classes="inline-block" width=64 height=48}}
{{icon "payment/mono/ideal" classes="inline-block" width=64 height=48}}

For more information on how and what see the Hyva Docs

This feature is supported since Hyva v1.1.12

Prefix Mapping Behavior

This module registers the payment SVG prefix for Hyva SvgIcons.

That means:

payment/default/*, payment/flat/*, and payment/mono/* are resolved by this package.
If another module also registers the same payment prefix, the effective mapping depends on Magento module merge order.

If you use multiple icon modules, verify prefix ownership and rendering in both frontend and adminhtml scope.

Payment options offered in this Icon Pack

ABN B2B Afterpay • Alipay • Amazon Pay • Amex • Apple Pay • Bancontact • Banktransfer • Belfius • Biller • Billink • Creditcard • Direct Debit • EPS • Giftcard • Giropay • Google Pay • iDeal • iDeal Wero • Wero • in3 • kbc • Klarna • Maestro • Mastercard • MultiBanco • MyBank • payconiq • PayPal • paysafecard • Przelewy24 • Riverty • Sepa • Sofort • Stripe • Trustly • Visa • vPay • WeChatpay

Missing or Outdated Payment Icons?

We strive to keep this list of payment options and their logos accurate and up-to-date.

If you notice a missing icon or an outdated logo, please help us improve the list by opening an issue or, even better, submitting a pull request.

Enhance Your Store with Automatic Payment Icons

This icon pack seamlessly integrates with our StoreInfo Payments module to automatically display payment icons based on your configured Magento 2 payment options.

Interested, then checkout the StoreInfo Payments to display your Payment options Automatically!

Other Icon packs for Hyva

For Icons packs see https://github.com/topics/hyva-icons

If you are looking for a Luma based option checkout this icon pack instead.

Icon License

The payment icons used in this module were created by Siteation under a MIT License

Disclaimer

All used trademarks, brands and/or names are the property of their respective owners.

The use of these trademarks, brands and/or names does not indicate endorsement of the property holder by us, nor vice versa.

siteation / magento2-hyva-icons-payment

Package info

Security

Statistics