flizpay / magento2
FlizPay payment integration for Magento Open Source and Adobe Commerce
Package info
Type:magento2-module
pkg:composer/flizpay/magento2
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.*
This package is not auto-updated.
Last update: 2026-08-21 10:11:25 UTC
README
Accept FLIZpay payments in Magento Open Source and Adobe Commerce. The extension redirects customers to the hosted FLIZpay checkout and displays available cashback directly in the Magento checkout.
Features
- Hosted FLIZpay checkout for guest and registered customers
- Customer cashback shown in checkout and 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
Run the following commands from the Magento root directory:
composer require flizpay-gmbh/magento2 bin/magento module:enable FlizPay_Payment bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush
Configuration
- Open Stores > Configuration > Sales > Payment Methods > FLIZpay.
- Enable the payment method and enter your FLIZpay API key.
- Save the configuration.
- 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 cashback title 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 issued separately 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.
Development
Run make to list all available commands. Common checks are:
make check # Validation, XML checks, linting, and unit tests make test-integration # Magento integration tests make analyse # PHPStan make phpcs # Magento coding standards
Test and quality commands require a Magento installation. Set MAGENTO_ROOT if
it is not available at the default ../magento-store path.
License
This extension is dual-licensed under the Open Software License 3.0 and the Academic Free License 3.0.