Alma — Buy Now, Pay Later for Dolibarr

⚠️ **This module requires an active Alma merchant account.** Registration is free at https://dashboard.getalma.eu/new-register — eligibility conditions apply depending on your business.

The Alma module integrates the Alma Buy Now, Pay Later (BNPL) payment solution into Dolibarr. Generate a payment link in 2, 3, 4, 10 or 12 interest-free installments directly from an order, invoice or proposal card. The customer pays online via a secure Alma page, and Dolibarr automatically creates the invoice, records the payment and links it to the configured bank account — all without any manual action.

**Features:**

- Payment links in 2x, 3x, 4x, 10x or 12x interest-free installments

- Automatic invoice creation on proposal or order payment (configurable)

- Automatic payment recording to the configured bank account

- Send payment links by SMS or Email to the customer

- Refund via Alma API directly from a customer credit note

- Real-time webhook notification processing (no manual action required)

- Admin configuration page with tabs (Configuration / Features)

- User rights management (read, write, send link, refund)

- Compatible with Dolibarr 15.0 to 22.0

- Available in French, English and Spanish

**Requirements:**

- Dolibarr 15.0 or higher

- PHP 7.1 or higher

- An active Alma merchant account

- Alma API keys (Live and/or Test)

- PHP cURL extension enabled

**Installation:**

1. Download the `.zip` package from the Dolistore

2. Extract and copy the `alma/` folder to `htdocs/custom/` on your Dolibarr server

3. Log in as administrator and go to **Setup > Modules**

4. Search for "Alma" and click **Activate**

5. Go to **Setup > Modules > Alma > Settings** and configure your API keys

**Webhook configuration:**

Copy the IPN URL displayed on the configuration page and paste it in your Alma dashboard under **Settings > Notifications**.

Format: `https://your-dolibarr.com/custom/alma/notification.php`

**Support:** https://github.com/Thibault-mns