Plugin: alma-gateway-for-woocommerce (Used by 451 domains)

Alma is a service to provide merchants with an easy and safe monthly payments solution.
Let your customers pay for their purchases at their own pace! You’ll receive the funds instantly, and your customer will pay later over a few monthly instalments.

This plugin integrates Alma into WooCommerce by adding a new payment method that you can activate to offer monthly payments to your customers.

Documentation

You can find more documentation on our website

v6.0.7 – 2026-04-01

Changes

🐛 Bug Fixes

• Clean alma_soc_ongoing option in DB (#574)
• fix: Remove picture url from CartItemDto constructor (#571)
• Fix admin & gateway settings detection with pretty permalinks (#570)
• fix: Update unique cart ID generation to prevent TypeError in PHP 8.0+ (#568)

Contributors

@Benjamin-Freoua-Alma, @Francois-Gomis, @alma-renovate-bot[bot], @joyet-simon, @remi-zuffinetti, alma-create-pr-with-team-review[bot] and alma-renovate-bot[bot]

v6.0.6 – 2026-03-25

Changes

🐛 Bug Fixes

• fix: build.sh for svn release (#553)
• fix: Add language support to In-Page for classic checkout (#556)
• fix: Return early if cart_id is empty in onOrderConfirmed method (#554)
• Fix: woocommerce merchant cms p24x activation impossible (#552)
• fix: gateway ordering for Alma gateways to ensure unique incremental … (#551)

Contributors

@Francois-Gomis and @joyet-simon

v6.0.5 – 2026-03-17

Changes

🐛 Bug Fixes

• feat: Add .wordpress.org folder to fix the sync SVN (#543)
• Fix: fee plan migration error (#547)
• Fix: ordering gateways on checkout page (#546)
• Fix: rename css class (#548)
• fix: force type float for price_to_cents call (#545)
• Fix: remove unused css class (#544)

Contributors

@Benjamin-Freoua-Alma, @joyet-simon and alma-create-pr-with-team-review[bot]

v6.0.4 – 2026-03-11

Changes

🐛 Bug Fixes

• fix: Widget Eligibility get sandbox on live mode (#540)
• fix: Change asset name for changing asset (#538)
• fix: Price in page block without cent error (#537)
• fix: Price regex in classic inpage checkout nor support Thousands sep… (#536)

Contributors

@Benjamin-Freoua-Alma, @joyet-simon and alma-create-pr-with-team-review[bot]

v6.0.3 – 2026-03-10

Changes

🐛 Bug Fixes

• fix: get first element of order total (#533)

Contributors

@joyet-simon

v6.0.2 – 2026-03-10

Changes

• Feature/ecom 3898 wrong error message (#530)
• Feature/ecom 3858 classic checkout in page bug when cdn is too long to load (#526)

🚀 New Features

• fix: fix namespaces (#529)
• feat: add cache on Fee Plan Repository (#524)
• fix: installments display (#527)
• Feature/6.0 (#516)

Contributors

@Benjamin-Freoua-Alma, @alma-create-pr-with-team-review[bot], @alma-renovate-bot[bot], @joyet-simon, @remi-zuffinetti, @webaaz, alma-create-pr-with-team-review[bot] and alma-renovate-bot[bot]

v6.0.0 – 2026-02-18

Changes

• API refactoring
• Native Blocks Management
• Remove technical fields
• Full alignment with WooCommerce guidelines

Contributors

@Benjamin-Freoua-Alma, @alma-renovate-bot[bot], @joyet-simon, @remi-zuffinetti, alma-create-pr-with-team-review[bot] and alma-renovate-bot[bot]

v5.11.0 – 2025-02-18

Changes

🚀 New Features

• Add payment method position to the gather cms data (#326)

🐛 Bug Fixes

• Fix typeError for display in page in gather cms data (#326)

Contributors

@joyet-simon and alma-create-pr-with-team-review[bot]

v5.10.0 – 2025-02-11

Changes

🚀 New Features

• Use cdn for alma widget and update to version 4.x.x (#322)

Contributors

@joyet-simon and alma-create-pr-with-team-review[bot]

v5.9.0 – 2025-02-06

🚀 New Features

• Fix compatibility with Woocommerce Blocks (#310)
• Add auto_update in specific_features for gather cms data (#312)
• Fix error when no file to add or remove on release (#305)
• Cancel order before delete (#308)
• Change check nonce log lvl (#307)
• Fix has pay now method (#306)

Contributors

@Benjamin-Freoua-Alma, @Francois-Gomis, @carine-bonnafous, @joyet-simon, @webaaz and alma-create-pr-with-team-review[bot]

v5.8.1 – 2024-12-16

🐛 Bug Fixes

Hotfix: compatibility for Woocommerce version under 6.1.0

v5.8.0 – 2024-12-12

Changes

• Feature/ecom 2261 translations loaded to early in woocommerce plugin (#298)
• Add editor config and sonarcloud config (#292)

🚀 New Features

• Implement add order status to order change (#299)
• Add gather cms data (#297)
• Feature/ecom 2212 sonarcloud configuration (#296)
• Update widget version to 3.4.0 (#295)
• Add getter for product variable config (#290)
• fix: Change wording for In-Page configuration (#288)

🐛 Bug Fixes

• fix: in page unmount (#289)
• fix: avoid blocking in-page if a notice is returned (#287)

Contributors

@Benjamin-Freoua-Alma, @CamilleFljt, @Francois-Gomis, @alma-create-pr-with-team-review, @gdraynz, @joyet-simon, @webaaz and Martin Supiot

v5.7.0 – 2024-10-07

Changes

🚀 New Features

• Integrate credit on in page (#282)
• Add hmac verification on ipn (#281)

Contributors

@Francois-Gomis, @alma-create-pr-with-team-review and @joyet-simon

v5.6.0 – 2024-09-16

Changes

🚀 New Features

• feat: compatibility woocommerce 9.2.3 wordpress 6.6.1 (#278)

🐛 Bug Fixes

• fix: force picture_url to string (#277)

Contributors

@Benjamin-Freoua-Alma, @Francois-Gomis, @alma-create-pr-with-team-review and @joyet-simon

v5.5.0 – 2024-07-29

Changes

🚀 New Features

• feature: Compatibility woocommerce 9.0.2 wordpress 6.5.5 (#269)
• feature: Gather cart data from pnx and deferred payments (#265)
• feature: Compatibility woocommerce 8.9.2 (#260)
• feature: Compatibility woocommerce 8.8.2 wordpress 6.5 (#248)

Contributors

@Benjamin-Freoua-Alma, @ClaireAlma, @FranceBe, @carine-bonnafous, @gdraynz, @joyet-simon and @remic-alma

v5.4.0

• feature: Compatibility Woocommerce Blocks
• feature: compatibility Woocommerce 8.7.0
• feature: Compatibility WordPress 6.4.2

v5.3.0

• feature: In page with Deferred payments is available
• feature: compatibility Woocommerce 8.2.2
• feature: Compatibility WordPress 6.4.1
• feature: add psr4
• fix: deactivate rendering of Alma payment methods on order pay checkout page
• fix: delete abandoned orders created by In Page
• fix: default plan selection
• fix: add flag security for SOC

5.2.1

• fix: shortcode widget for XSS injection

5.2.0

• feat: Update translations
• fix: widget XSS
• feature : HPOS compatibility

5.1.4

• feat: Compatibility Woocommerce 8.2.1
• feat: change fee wording in the BO
• fix: In page installment plans

5.1.3

• fix: update issues from version 1.* and 2.*
• feat: Compatibility WordPress 6.3.2
• feat: Compatibility Woocommerce 8.2.0
• feat: Update Widget version 3.3.8

5.1.2

• fix: svn marketplace activation issue

5.1.1

• fix: css incompatibility with plugin Yith Woocommerce Checkout Manager

5.1.0

• feature : In Page checkout for all merchants
• feat: Update Widget version 3.3.6

5.0.6

• hotfix: Show form errors on checkout in-page when some information are missing for the form
• hotfix: Add method payment description for In Page methods

5.0.5

• hotfix: fix compatibility betwen In-Page mode and some plugins(colissimo, …)

5.0.4

• feat: compatibility Woocommerce 8.1.1
• change : PHP client version 1.11.2
• fix: compatibility with WC_Checkout::process_checkout()

5.0.3

• fix : Incompatibility with Woocommerce Paypal Plugin

5.0.2

• fix : In-Page creation order
• feat: Compatibility WordPress 6.3.1

5.0.1

• fix: missing client information when In Page is activated
• fix: missing shipping information when In Page is activated
• fix: loading of the translation files
• feat: Compatibility Woocommerce 8.0.3

5.0.0

• feat: In Page checkout
• feat: Separate the gateways in the checkout page
• feat: Compatibility Woocommerce 8.0.1
• feat: Compatibility Woocommerce 8.0.2
• feat: Compatibility WordPress 6.3
• feat: Update Widget version 3.3.5

4.3.4

• fix: wrong variable in mismatch

4.3.3

• fix: prevent to call Eligibility api with an amount to 0
• fix: wrong variable name
• fix: Change the return code (500 to 200)on Ipn callback when it’s a mismatch or potential fraud
• feat: upgrade PHP client to 1.11.1
• feat: Compatibility woocommerce 7.9.0

4.3.2

• fix: SEPA deprecated test
• fix: Restore HTML description in gateway
• fix: Improve auto-update
• feat: Add merchant infos in BO
• feat: Add previous version info in BO
• feat: Prevent issues with Germanized for WooCommerce
• feat: Compatibility woocommerce 7.8.2
• feat: New widget v3.3.4

4.3.1

• fix: Warning: Cannot modify header information – headers already sent

4.3.0

• feat: Implement Pay Now
• feat: Compatibility woocommerce 7.8.0
• feat: Update Widget to 3.3.3

4.2.5

• fix: fix the accordion css on checkout
• feat: Update widget to 3.3.2

4.2.4

• feat: Allow to customize the gateway title

4.2.3

• hotfix: don’t do the basic gateway checks during update process

4.2.2

• hotfix: Prevent to send multi update thread

4.2.1

• hotfix: Plugin update when the gateway is disabled

4.2.0

• feat: Share of checkout feature
• feat: Encryption Key feature in database
• feat: Gather the gateway in checkout (design)
• fix: Reduce extended-call data
• feat: Send basket order details for credit
• feat: Implement a template system

4.1.2

• fix: nonce error log issue
• feat: Update widget
• feat: compatibility with woocommerce 7.6

4.1.1

• fix: PHP 8.0 and 8.1 compatibility

4.1.0

• feat: compatibility WordPress 6.2
• feat: add logger to the php client
• feat: compatibility woocommerce 7.5
• feat: add namespaces
• fix: save alma version in db on fresh install
• fix: translations
• fix: unique nonce fields
• fix: compatibility with other plugins
• fix: reduce api calls
• fix: migration between versions of alma module
• fix: implement best practices Woocommerce and WordPress

3.2.2

• feat: update widget to 3.1.0

3.2.1

• feat: update widget to 3.0.4
• fix: nonce double check issue

3.2.0

• feat: rebranding 2022

3.1.2

• fix: widget translations
• fix: php8 compatibility

3.1.1

• fix: correct bad button text for refund
• fix: correcting issue of multiple times the same order note
• fix: correcting wording issue in case of order not have a transaction_id

3.1.0

• feat: implement B2B fields (INT-714 #65)
• refact: widget injection (INT-589 #57)
• fix: use sales price to update widget instead regular price (INT-290 / INT-570 #52)
• feat: refund from woocommerce back-office (INT-510 #69)
• fix: alma should be hidden on checkout when test key is selected & user is not admin (INT-586 #71)

3.0.0

• feat: add nonce to secure checkout form
• feat: add script to retrieve widget files
• fix: data sanitizing
• fix: upd payment fields validation notice messages

2.6.0

• feat: add BO dynamic check variation
• feat: add BO technical fields section
• feat: add payment upon shipping
• fix: names inversion between shipping & billing addresses

2.5.2

• feat: ignore & remove composer.lock
• fix: allow widget to be injected in builder

2.5.1

• fix: admin test on unavailable var for other admin pages
• fix: check cart eligibility without customer

2.5.0

• feat: back-office i18n custom fields

2.4.1

• fix: issue on payment method order on checkout page

2.4.0

• feat: split payments
• fix: model get_cart on null in wysiwyg builder
• refactor: Remove the unnecessary boolean literal
• refactor: payment gateway description fix code duplication
• refactor: reduce cognitive complexity

2.3.0

• feat(widget): upgrade CDN from 1.x to 2.x
• feat(widget): alma API mode
• feat(widget): deferred_days & deferred_months
• feat(widget): locale
• fix: filter eligible feeplans in checkout

2.2.1

• fix: send user_locale in Alma checkout

2.2.0

• ci: add shell script bumper
• feat: add IT & DE languages
• fix: call eligibility without country if null
• fix: dynamic update on checkout for anonymous user
• fix: update translations without space on go_to_log
• fix: widget handler replace excluding by including tax

2.1.1

• fix: remove upgrade process
• fix: usage of woo deprecated get price func
• refactor: remove redundant properties initializations
• refactor: add Settings magic properties
• refactor: remove unnecessary brackets into strings
• word(typo): fix all doc block typo

2.1.0

• [i18n] allow plugin to works with all locales
• [i18n] add locale & advanced address fields on payment creation
• [i18n] add customer addresses information to check payment plans on checkout
• [i18n] add nl & es translations
• minor refactorings
• enhance docker env

2.0.0

• Add inline Pay Later (Eligibility V2)
• Add dedicated DB migrations processor
• Load & update fee-plans dynamically from ALMA dashboard config
• Add autoloader
• Minor refactorisations
• Root tree refactorisation
• Re-design back-office fee plans configuration

1.3.1

• Avoid Fatal error on (not found) product badge injection
• Increase debug log on non displayed bages

1.3.0

• Remove PHP warnings & do not display widget on out-stock or un-priced product
• Minor refactoring
• Enhance dev docker env (display php warnings / errors + prioritize custom-php-ini file)
• Fix widget display price without tax depending on WooCommerce tax rule configuration
• Add fallback locale on checkout payment ALMA API call
• Add filter to override locale on checkout payment ALMA API call
• Add widget shortcodes

1.2.3

• Use unpkg.com instead of unpkg.io

1.2.2

• Do not display a radio button at checkout, when there’s only one payment plan available

1.2.1

• Fixes default min/max amount values being converted to cents multiple times in a row
• Improves xdebug configuration

1.2.0

• Allows merchant to activate 2-, 3- a 4-installment plans, with min and max allowed amounts per plan
• Displays an Alma widget on product pages and cart page to inform customers of eligible payment plans
• Displays a full payment plan for each plan option on the checkout page
• Enables Alma by default for all fr_* locales
• Adds a alma_wc_enable_for_locale that can be used to enable Alma for additional locales
• Any of the module’s settings can be overridden via a filter: alma_wc_settings_[setting_name]
• Fixes compatibility issues with WooCommerce 2.6.14
• Fixes many bugs
• Dependencies update

1.17

• Do not require Live key in Test mode and vice versa
• Include cancel url, order reference & order URLs in payment data
• Don’t show the eligibility message in case of API error
• Stop checking in vendor dependencies – they’ll be included in each release’s ZIP file

1.1.6

• Dependencies update

1.1.5

• Fixes display on cart option that was always on
• Tested against latest versions of WordPress/WooCommerce

1.1.4

• Fixes various warnings when WooCommerce isn’t activated
• Updates dependencies
• Fixes errors when Alma’s API is not available
• Attempt to fix problem triggered when calling the WordPress API

1.1.3

• Fixes warning when excluded_products_list is not set

1.1.2

• Adds hidden option to be able to choose installments count to use for created payments

1.1.1

• Fixes bug occurring in wp-admin/nav-menus.php

1.1.0

• Fixes case of “alma” in includes path
• Adds possibility to exclude product categories from installment payments, to help enforce contractual restrictions
  (i.e. Alma cannot be used to sell/buy virtual/downloadable products such as gift cards, subscriptions, …)

1.0.1

• Switches logo file to SVG
• Uses latest Eligibility check behaviour to remove one extra call to the API
• Adds User-Agent string containing the module’s version, WordPress version, WooCommerce, PHP client and PHP versions, to all requests going to Alma’s …