alma / sylius-2-payment

1.0.0 2026-09-01 09:20 UTC

Requires

• php: ^8.2
• alma/alma-php-client: ^3.0
• sylius/sylius: ^2.0

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

• payment
• sylius
• alma
• sylius-plugin

Published on Packagist.org on 2026-09-01 09:27 UTC

README

This plugin adds a new payment method to Sylius 2, which allows you to offer installments payments to your customers using Alma.

Requirements

• PHP ^8.2
• Sylius ^2.0
• An Alma merchant account — sign up at almapay.com, then retrieve your API keys from the Alma dashboard

Installation

composer require alma/sylius-2-payment

Register the plugin in config/bundles.php:

return [
    // ...
    Alma\Sylius\AlmaSyliusPlugin::class => ['all' => true],
];

Import the plugin routes by creating config/routes/alma_sylius.yaml:

alma_sylius:
    resource: '@AlmaSyliusPlugin/config/routes/payment.yaml'

Then clear the cache:

php bin/console cache:clear

Configuration

1. In the Sylius admin, go to Payment methods and create a new method using the Alma gateway.
2. Enter your Alma API keys (Live and Test) and select the mode to use.
3. Enable the fee plans you want to offer (e.g. pay in 3 or 4 installments).
4. Enable the payment method on the channels where you want Alma available.

Features

• Eligibility at checkout — Alma is offered only when the cart is eligible, with the available installment plans for the customer to choose from.
• Off-site payment — the customer is redirected to Alma's payment page and back to your shop after completing (or cancelling) the payment.
• Refunds — refund an order through the native Sylius admin; the refund is propagated to Alma automatically.

Support

• Documentation: docs.almapay.com
• Contact: [e-mail]

License

This plugin is released under the MIT License.