Mollie Gateway by Blesta.Club - Product Overview

Welcome, and thank you for choosing the Mollie Gateway! We're delighted to have you as a customer and are committed to ensuring you have a seamless experience. This guide aims to walk you through the installation and configuration of your new gateway. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Gateway Capabilities

The Mollie Gateway connects Blesta to Mollie's hosted checkout (Payments API v2). Clients paying an invoice are redirected to Mollie, where they can pay with any payment method you have enabled in your Mollie dashboard (iDEAL, cards, Bancontact, and more). Mollie's webhook reports the payment back to Blesta, which records the transaction and applies it to the right invoices automatically. Staff can also issue refunds directly from Blesta's transaction management.

Things to Note

1. Security: Ensure that your Mollie account is secured with two-factor authentication to prevent unauthorized access. Your API token is stored encrypted in Blesta.
2. Payment methods: Which payment methods appear on the Mollie checkout is managed entirely in your Mollie dashboard, not in Blesta.
3. Currencies: The currencies offered to clients come from Blesta's own currency configuration (Settings > Company > Currencies) combined with the currencies you enable on the gateway. There are no separate currency settings on the gateway itself.

Setting Up the Gateway

Install the Gateway

1. Download the Gateway:

   • Obtain the Mollie Gateway from the download section of my.blesta.club.

2. Upload to Blesta:

   • Upload the Mollie Gateway to your Blesta gateways directory:

     /var/www/html/blesta/components/gateways/nonmerchant/mollie/

3. Install the Gateway:

   • Log in to your Blesta admin account and navigate to Settings > Payment Gateways.
   • Find the Mollie Gateway and click the "Install" button.

Configure the Gateway

1. Manage the Gateway:

   • Navigate to Settings > Payment Gateways (/admin/settings/company/gateways/installed/).
   • Find the "Mollie" Gateway and click on "Manage".
   • Paste your Mollie API Token and click "Update Settings". That single token is the only credential the gateway needs.

2. Test the Gateway:

   • To test against Mollie, paste a Test API Key (test_...) instead of your live key - Mollie decides live vs. test by the token itself; there is no separate mode switch in Blesta.
   • To demo the gateway without any Mollie account at all, tick Mock API in the gateway settings. The gateway then serves built-in sample responses instead of contacting Mollie. Never leave this enabled in production.

Quick Support

How to Obtain Your Mollie API Token

1. Login to Mollie:

   • Go to your Mollie Dashboard and log in with your credentials.

2. API Keys:

   • Navigate to Developers > API Keys in your Mollie Dashboard.
   • Copy the "Live API Key" (live_...) for production, or the "Test API Key" (test_...) for testing.

3. Configure the Token in Blesta:

   • Paste the key into the gateway's API Token field in Blesta and save your changes.

Troubleshooting Common Issues

• Transaction Failures:

  • Ensure your API token is correct and is the live_... key for real transactions. Check Tools > Logs > Gateway in Blesta for the request/response of each Mollie call.

• Currency Mismatch:

  • Check that the invoice currency is one Mollie supports and is enabled for the gateway in Blesta's currency settings.

Contact Us

If you encounter any issues or have suggestions for improving the gateway, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.

Mollie Gateway by Blesta.Club - Installation Guide

Welcome, and thank you for purchasing the Mollie Gateway! We're delighted to have you as a customer and are committed to ensuring you have a seamless experience. This README aims to guide you through the installation of your new gateway. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Installation Guide

For detailed instructions on how to install the Mollie Gateway, please ensure you have the extension manager installed for leased extensions and follow these steps:

1. Obtain the Gateway:

   • Download the Mollie Gateway from the download section of the client area.

2. Upload to Blesta:

   • Upload the Mollie Gateway to your Blesta gateways directory:

     /var/www/html/blesta/components/gateways/nonmerchant/mollie/

3. Install the Gateway:

   • Log in to your Blesta admin account.
   • Navigate to Settings > Payment Gateways.
   • Find the Mollie Gateway under the "Available" tab and click the "Install" button.

Setting Up the Gateway

1. Configure the Gateway:

   • Navigate to Settings > Payment Gateways (/admin/settings/company/gateways/installed/).
   • Find the "Mollie" Gateway and click on "Manage".
   • Paste your Mollie API Token (from Developers > API Keys in the Mollie dashboard) and click "Update Settings". This is the gateway's only setting besides the demo-only Mock API toggle.

2. Enable the Currencies:

   • Make sure the currencies you invoice in are enabled for the gateway (Blesta shows the currency checklist on the same manage page).

You're now done with the installation! Proceed to configure the gateway as needed by following the usage guide.

Contact Us

If you encounter any issues or have suggestions for improving the gateway, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.

Mollie Gateway by Blesta.Club - Update Guide

To ensure you’re always using the latest version of the Mollie Gateway, follow these steps to update the gateway in your Blesta installation.

Steps for Updating the Gateway

1. Download the Latest Version

• Visit the download section of the client area to obtain the latest version of the Mollie Gateway.

2. Upload the Updated Gateway

• Upload the updated files to your Blesta installation directory, replacing the existing files.
• The directory path is:

   /var/www/html/blesta/components/gateways/nonmerchant/mollie/

3. Update the Gateway in Blesta

• Log in to your Blesta admin account.
• Navigate to Settings > Payment Gateways.
• Locate the Mollie Gateway in the list and click the "Upgrade" or "Update" button, if available.

4. Check Configuration

• After the update, navigate to Settings > Payment Gateways, manage the Mollie Gateway and click Update once to re-save the settings, even if nothing has changed.

Updating to 2.0.0: re-saving the settings is required, not optional, unless you have already re-saved them since 1.1.0. The gateway stores your Mollie API Token encrypted, and a token saved by 1.0.3 or earlier is still stored as plain text. Until you re-save, Mollie rejects every call with an authentication error: clients cannot start a payment, and incoming payment notifications are discarded, so paid invoices are not marked paid.

Open the gateway's settings, paste your API Token in again and click Update. The save checks the token with Mollie before accepting it, so a clean save confirms the gateway is working. If any payments were made while the token was unusable, re-send the payment notification for them from your Mollie dashboard once the settings are saved.

Testing the Update

1. Test Mode:

   • Before going live with real transactions, use Mollie’s test mode to ensure everything is functioning as expected.

2. Transaction Testing:

   • Perform a test transaction to ensure that the gateway is processing payments successfully.

Troubleshooting Update Issues

1. Missing or Incorrect Files:

   • If issues arise, confirm that all files were uploaded correctly and that the appropriate file permissions are set.

2. API Key Issues:

   • Ensure the correct API keys are configured after updating the gateway. Use test keys for testing and live keys for production transactions.

3. Compatibility Issues:

   • Check that the updated version of the gateway is compatible with your current version of Blesta. Refer to the changelog for any compatibility notes.

Contact Us

If you encounter any issues during the update process or have suggestions for improving the gateway, please reach out to us. We are dedicated to providing continuous updates and value your feedback.

Mollie Gateway by Blesta.Club - Usage Guide

Welcome, and thank you for purchasing the Mollie Gateway! This guide aims to walk you through the proper usage of the Mollie Gateway in your Blesta installation. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Using the Gateway

Once installed and configured, the Mollie Gateway lets your clients pay through Mollie's hosted checkout with whichever payment methods you have enabled in your Mollie dashboard.

Client View

• Clients choose Mollie as a payment method at checkout and when paying invoices.
• They are redirected to Mollie's secure checkout page to complete the transaction, then returned to Blesta. Mollie's webhook records the payment in Blesta and applies it to the invoices automatically.

Admin View

1. Gateway Settings:

   • Navigate to Settings > Payment Gateways in the Blesta admin panel (/admin/settings/company/gateways/installed/) and click "Manage" on Mollie.
   • The gateway has one credential: the API Token. Which payment methods Mollie offers is managed in your Mollie dashboard; which currencies are available is managed in Blesta's currency settings and the gateway's currency checklist.

2. Refunds:

   • Staff can refund a Mollie transaction from the client's transactions in Blesta (Edit Transaction > Status > Refunded); the refund is sent to Mollie via the API. Blesta's admin only offers a full-amount refund - there is no field to enter a partial amount.
   • For a partial refund, issue it from your Mollie dashboard instead. Mollie re-notifies Blesta of the event and it syncs back automatically, but Blesta still marks the whole transaction refunded (Blesta's transaction status is a single value, not a running balance). Check the Mollie dashboard for the amount actually returned.

3. Logs:

   • Every Mollie API call (payment creation, webhook verification, refunds) is logged under Tools > Logs > Gateway. The API token is never written to the log.

Testing the Gateway

1. Test Mode:

   • Paste your Mollie Test API Key (test_...) as the API Token. Mollie decides live vs. test by the token itself; there is no separate mode switch in Blesta.

2. Demo Without a Mollie Account:

   • Tick Mock API in the gateway settings to serve built-in sample responses instead of contacting Mollie - useful for demos and trials. Never leave this enabled in production.

3. Switch to Live Mode:

   • Replace the token with your Live API Key (live_...) and untick Mock API for real transactions.

Troubleshooting Common Issues

1. Transaction Failures:
   • Check that the API token is correct (a live_... key for real payments) and review Tools > Logs > Gateway for Mollie's response to the failing call.
   • Clients see only a short "the payment could not be started, please try again" message on the checkout page; the actual cause (authentication, connection, Mollie validation) is deliberately kept to the gateway log, so always diagnose from there. Staff refunds still show Mollie's own error text in the admin area.
2. Currency Issues:
   • Ensure the invoice currency is supported by Mollie and enabled for the gateway in Blesta.

Contact Us

If you encounter any issues or have suggestions for improving the gateway, please don't hesitate to reach out. We are committed to providing continuous updates and welcome your feedback.