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.1.0(1y ago)075.9k↑35.7%5[5 issues](https://github.com/alma/AlmaSyliusPaymentPlugin/issues)[6 PRs](https://github.com/alma/AlmaSyliusPaymentPlugin/pulls)MITPHPPHP ~7.3 || ~7.4 || ~8.0 || ~8.1 || ~8.2

Since Feb 4Pushed 1mo 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 1mo ago

READMEChangelog (8)Dependencies (30)Versions (19)Used By (0)

 [![logo alma](src/Resources/public/img/alma-logo.svg)](src/Resources/public/img/alma-logo.svg) [![](https://camo.githubusercontent.com/1567208cc7c8ec53cf6e2af4f54449a9bb3ab0dee7916998de4e3ce9b7f79015/68747470733a2f2f64656d6f2e73796c6975732e636f6d2f6173736574732f73686f702f696d672f6c6f676f2e706e67)](https://camo.githubusercontent.com/1567208cc7c8ec53cf6e2af4f54449a9bb3ab0dee7916998de4e3ce9b7f79015/68747470733a2f2f64656d6f2e73796c6975732e636f6d2f6173736574732f73686f702f696d672f6c6f676f2e706e67)

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

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

Integrate Alma installments and pay later payments with your Sylius shop

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

[](#documentation)

### 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

```

### Requirements

[](#requirements)

- PHP version &gt;= 7.3
- Sylius version &gt;= 1.9.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 .

### 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!

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance68

Regular maintenance activity

Popularity32

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity74

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 ~201 days

Recently: every ~339 days

Total

8

Last Release

521d ago

Major Versions

v1.3.0 → v2.0.02023-09-21

PHP version history (3 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

### 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 (27 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)")[![thomas-e-alma](https://avatars.githubusercontent.com/u/111861043?v=4)](https://github.com/thomas-e-alma "thomas-e-alma (2 commits)")[![remic-alma](https://avatars.githubusercontent.com/u/121117838?v=4)](https://github.com/remic-alma "remic-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.

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

PayPal plugin for Sylius.

451.4M4](/packages/sylius-paypal-plugin)[flux-se/sylius-payum-stripe-plugin

Payum Stripe gateways plugin for Sylius.

61342.2k](/packages/flux-se-sylius-payum-stripe-plugin)[bitbag/sylius-adyen-plugin

BitBag Adyen plug-in for Sylius.

1249.9k](/packages/bitbag-sylius-adyen-plugin)

PHPackages © 2026

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