PHPackages                             alma/sylius-payment-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. alma/sylius-payment-plugin

ActiveSylius-plugin[Payment Processing](/categories/payments)

alma/sylius-payment-plugin
==========================

Payment plugin to integrate Alma installments and pay later payments with your Sylius shop

2.2.0(2mo ago)078.5k↑231%7[5 issues](https://github.com/alma/AlmaSyliusPaymentPlugin/issues)[10 PRs](https://github.com/alma/AlmaSyliusPaymentPlugin/pulls)MITPHPPHP ~7.4 || ~8.0 || ~8.1 || ~8.2 || ~8.3CI passing

Since Feb 4Pushed 1w ago2 watchersCompare

[ Source](https://github.com/alma/AlmaSyliusPaymentPlugin)[ Packagist](https://packagist.org/packages/alma/sylius-payment-plugin)[ RSS](/packages/alma-sylius-payment-plugin/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (9)Dependencies (59)Versions (27)Used By (0)

 [![logo alma](src/Resources/public/img/alma-logo.svg)](src/Resources/public/img/alma-logo.svg) [![logo sylius](src/Resources/public/img/sylius-logo.png)](src/Resources/public/img/sylius-logo.png)

Sylius Alma Payment Plugin
==========================

[](#sylius-alma-payment-plugin)

Integrate Alma installments and pay later payments with your Sylius shop

Requirements
------------

[](#requirements)

### Compatibility

[](#compatibility)

- **Sylius**: Compatible with versions `1.9.x` to `1.12.x`
- **PHP**: Compatible with versions `7.3` to `8.0`

Alma currently accepts Euros only; make sure you activate your payment method on channels that use that currency, else you won't see it at checkout.

Your Alma payment methods will only show for eligible carts. Eligibility is mainly based on the purchased amount, which by default should be between 100€ and 2000€; if you want those limits changed, you can talk to your sales representative at Alma, or contact .

Documentation
-------------

[](#documentation)

### Account Setup (Required)

[](#account-setup-required)

Before configuring the module, you need to create your merchant account on [dashboard.getalma.eu](https://dashboard.getalma.eu).

1. Go to [registration page](https://dashboard.getalma.eu/register) and create an account.
2. Retrieve your API key from the dashboard.
3. Use these credentials in the module configuration.

### Installation

[](#installation)

1. Use Composer to install the plugin:

```
$ composer require alma/sylius-payment-plugin

```

2. Import routes:

```
# config/routes/sylius_shop.yaml

sylius_alma:
    resource: "@AlmaSyliusPaymentPlugin/Resources/config/shop_routing.yaml"
    prefix: /{_locale}
    requirements:
        _locale: ^[A-Za-z]{2,4}(_([A-Za-z]{4}|[0-9]{3}))?(_([A-Za-z]{2}|[0-9]{3}))?$

```

3. Override Sylius' templates:

```
cp -R vendor/alma/sylius-payment-plugin/src/Resources/views/bundles/* templates/bundles/

```

4. Export assets:

```
bin/console sylius:install:asset

```

5. Update your shop's translation catalogs:

```
$ php bin/console translation:update --dump-messages fr AlmaSyliusPaymentPlugin
$ php bin/console translation:update --dump-messages en AlmaSyliusPaymentPlugin

```

6. Finally, clear your cache:

```
$ php bin/console cache:clear

```

### Usage

[](#usage)

1. Go to the Payment Methods admin page and choose to create a new "Alma Payments" method
2. Grab your API keys [from your dashboard](https://dashboard.getalma.eu/api) and paste them into the appropriate fields
3. Choose the installments count to apply for this payment method. If you want to offer multiple installments counts to your customers, you can create one Alma payment method per installments count.
4. Set the API mode to Test if you want to first test the integration with a fake credit card, on your preproduction servers for instance.
    When you're ready for production, set the API mode to Live.
5. Choose a name for your method in the languages relevant to your shop.
6. You're done! Save the payment method to start accepting instalments payments on your shop!

Support
-------

[](#support)

If you encounter any issues or have questions, feel free to contact us at [support@getalma.eu](mailto:support@getalma.eu.).

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance93

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~238 days

Recently: every ~459 days

Total

9

Last Release

67d ago

Major Versions

v1.3.0 → v2.0.02023-09-21

PHP version history (4 changes)v1.0.0PHP ^7.1

v1.3.0PHP &gt;=7.1

v2.0.0PHP ~7.3 || ~7.4 || ~8.0 || ~8.1 || ~8.2

2.2.0PHP ~7.4 || ~8.0 || ~8.1 || ~8.2 || ~8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/d9536070edb2e5206ca489e7cce6f6a8cdecf2da9a4f64d9be3d82c6204565d8?d=identicon)[alma\_integrations](/maintainers/alma_integrations)

---

Top Contributors

[![olance](https://avatars.githubusercontent.com/u/314079?v=4)](https://github.com/olance "olance (51 commits)")[![Benjamin-Freoua-Alma](https://avatars.githubusercontent.com/u/89775252?v=4)](https://github.com/Benjamin-Freoua-Alma "Benjamin-Freoua-Alma (36 commits)")[![ClaireAlma](https://avatars.githubusercontent.com/u/110386752?v=4)](https://github.com/ClaireAlma "ClaireAlma (21 commits)")[![Francois-Gomis](https://avatars.githubusercontent.com/u/97046219?v=4)](https://github.com/Francois-Gomis "Francois-Gomis (6 commits)")[![remic-alma](https://avatars.githubusercontent.com/u/121117838?v=4)](https://github.com/remic-alma "remic-alma (3 commits)")[![thomas-e-alma](https://avatars.githubusercontent.com/u/111861043?v=4)](https://github.com/thomas-e-alma "thomas-e-alma (2 commits)")[![webaaz](https://avatars.githubusercontent.com/u/489498?v=4)](https://github.com/webaaz "webaaz (1 commits)")[![arnaudrolland](https://avatars.githubusercontent.com/u/3249959?v=4)](https://github.com/arnaudrolland "arnaudrolland (1 commits)")

---

Tags

syliuspaymentsylius-pluginalmabuy now pay laterinstallmentsbnpl

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/alma-sylius-payment-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/alma-sylius-payment-plugin/health.svg)](https://phpackages.com/packages/alma-sylius-payment-plugin)
```

###  Alternatives

[sylius/invoicing-plugin

Invoicing plugin for Sylius.

891.1M2](/packages/sylius-invoicing-plugin)[sylius/paypal-plugin

PayPal plugin for Sylius.

461.5M7](/packages/sylius-paypal-plugin)[flux-se/sylius-payum-stripe-plugin

Payum Stripe gateways plugin for Sylius.

61353.4k](/packages/flux-se-sylius-payum-stripe-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
