flizpay / magento2

1.0.7 2026-11-11 20:41 UTC

Requires

• php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• magento/framework: 103.0.*
• magento/module-backend: 102.0.*
• magento/module-checkout: 100.4.*
• magento/module-config: 101.2.*
• magento/module-payment: 100.4.*
• magento/module-quote: 101.2.*
• magento/module-sales: 103.0.*
• magento/module-store: 101.1.*

OSL-3.0, AFL-3.0

• Fliz Pay GmbH

Published on Packagist.org on 2026-11-12 09:30 UTC

README

Accept FLIZpay payments in Magento Open Source and Adobe Commerce. The extension redirects customers to the hosted FLIZpay checkout and shows the current FLIZpay offer in the Magento checkout through the hosted <fliz-checkout> component.

Features

• Hosted FLIZpay checkout for guest and registered customers
• Customer discounts recorded in Magento totals and tax
• Automatic webhook registration and connection verification
• Signed webhooks as the source of truth for payment settlement
• Encrypted API credentials and a dedicated, privacy-safe log
• Idempotent transaction creation to prevent duplicate payment attempts

Requirements

• Magento Open Source or Adobe Commerce 2.4.7, 2.4.8, or 2.4.9
• PHP 8.2, 8.3, 8.4, or 8.5 where supported by the selected Magento release
• An HTTPS storefront
• EUR as the quote currency
• Magento Luma or Blank checkout
• A FLIZpay API key

Installation

FLIZpay is available from the Adobe Commerce Marketplace and from Packagist. The package name differs between the two, so use the commands for the source you install from. Run them from the Magento root directory.

Adobe Commerce Marketplace

Get the extension from the Adobe Commerce Marketplace, make sure Composer is authenticated against repo.magento.com with your Marketplace access keys, and run:

composer require flizpay-gmbh/magento2
bin/magento module:enable FlizPay_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Packagist

To install from Packagist, run:

composer require flizpay/magento2
bin/magento module:enable FlizPay_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Updating

To update to the latest version, run the following commands from the Magento root directory. Use the package name you installed under: flizpay-gmbh/magento2 for the Adobe Commerce Marketplace or flizpay/magento2 for Packagist.

composer update flizpay-gmbh/magento2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Configuration

1. Open Stores > Configuration > Sales > Payment Methods > FLIZpay.
2. Enable the payment method and enter your FLIZpay API key.
3. Save the configuration.
4. Wait for the connection status to confirm the signed webhook test.

Saving the API key registers the store's secure /flizpay/webhook endpoint with FLIZpay. The payment method becomes available after the connection is verified. Its logo, subtitle, and headline can be configured per store view.

Payment Behavior

After an order is placed, the customer is redirected to the hosted FLIZpay checkout. Magento keeps the order in pending_payment until a signed webhook is received. A completed payment creates a paid invoice and moves the order to processing; a failed or canceled payment cancels the order and restores the cart. Browser redirects never settle a payment.

The current release supports:

• One full invoice per order
• One full offline credit memo after payment completion
• No partial or multiple invoices or credit memos
• No online refunds; refunds must be returned to the customer separately, not through FLIZpay

Troubleshooting

The extension writes warnings and errors to var/log/flizpay.log. Enable debug logging in the FLIZpay payment configuration to include API and webhook processing details. Logs exclude credentials, signatures, customer data, and request or response bodies.

License

This extension is dual-licensed under the Open Software License 3.0 and the Academic Free License 3.0.