Download the PHP package owebstudio/merx-mollie without Composer
On this page you can find all versions of the php package owebstudio/merx-mollie. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download owebstudio/merx-mollie
More information about owebstudio/merx-mollie
Files in owebstudio/merx-mollie
Package merx-mollie
Short Description Mollie payment gateway for Kirby Merx plugin.
License proprietary
Homepage https://owebstudio.com
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package merx-mollie
Mollie Payment Gateway for Merx
This plugin is Mollie payment gateway for Kirby Merx plugin.
Requirements
- Kirby 4 or 5
- Merx 1.10
- PHP 8.1 or newer
- A license key for live sites, see License
Installation
- Download the latest release
- Unzip downloaded file
- Copy/paste unzipped folder in your
/site/pluginsfolder
Setup from Panel
Step 1: Get API key
Get API key from Mollie dashboard.
Step 2: Set API key from config
Set apiKey option from config.php like following usage:
/site/config/config.php
Step 3: Enable payment methods
You need to enable at least one payment method from Mollie Dashboard.
Step 4: Add payment method
Enter the Kirby panel with Merx installed. Go to the payment methods section from the settings tab and add a new one. Make sure you type mollie in the value field.
Step 5: Test
:tada: Done! Now you're ready for first order!
Manual checkout
Initialize payment
Complete payment
Payment statuses
When the buyer comes back from Mollie, the plugin checks the payment status:
| Status | Result |
|---|---|
paid |
The order is created with paymentComplete: true and paidDate. |
pending, or open for bank transfers |
The order is created with paymentComplete: false. The webhook completes it once Mollie reports the payment as paid. |
open (buyer left the payment page), canceled |
No order, the buyer gets the merx.paymentCanceled error. The cart is kept, so the buyer can try again. |
failed, expired, authorized |
No order, the buyer gets the merx.completePayment error. |
Webhooks
Mollie calls /shop-api/mollie-webhook on your site whenever the status of a payment changes. The plugin then fetches the payment from Mollie and:
- completes pending orders once the payment is paid;
- answers with an error when the order doesn't exist yet or the Mollie API can't be reached, so Mollie tries again later;
- logs failed, expired and canceled payments of pending orders, refunds and chargebacks with
error_log().
Webhooks are enabled by default. Mollie doesn't accept webhook URLs it can't reach, so the plugin doesn't send one on localhost, *.localhost, *.local, *.test and private IP addresses. In production, make sure Mollie can reach the URL (no basic auth or maintenance page in front of it).
To turn webhooks off:
Without webhooks, pending orders stay at paymentComplete: false, and you have to check them in the Mollie dashboard.
Options
| Option | Type | Default | Description |
|---|---|---|---|
| apiKey | string | null | API key for Mollie (required) |
| webhooks | boolean | true | Activates Mollie webhooks to process real-time status updates, see Webhooks |
| method | string | array | [] | Choose a specific payment method and your customer will skip the selection screen and is sent directly to the chosen payment method. |
| testmode | boolean | false | Set to true to make payments a test payment. Only read from the config, never from checkout data. |
| initializePayment | Closure | null | Sets custom initialize payment before payment. Be careful! This is advanced configuration. |
| completePayment | Closure | null | Sets the custom complete method after payment. It replaces the status check above. Be careful! This is advanced configuration. |
All the values can be updated in the config.php file and prefixed with owebstudio.merx-mollie..
Possible method option values
Possible values: applepay, bancontact, banktransfer, belfius, creditcard, directdebit, eps, giftcard, giropay, ideal, kbc, mybank, paypal, paysafecard, przelewy24, sofort
Sample options
A custom completePayment replaces the plugin's own status check, so make sure it only completes paid payments. Change the order with Oweb\MollieGateway::updateOrderPage(), because Kirby 5 doesn't keep changes made with content()->update().
License
Mollie for Merx is a commercial plugin. It is free to use on your local computer and on staging sites. A live site needs a license key: buy it for €19.99 and activate it in the Panel's System view (Kirby 5) by clicking the license status of the plugin. Kirby 4 has no license status in the System view, so the key can't be activated there.
The license check never blocks your checkout. Without a license key, the System view shows that the plugin is not activated, and payments keep working.
https://github.com/owebstudio/.github/blob/main/LICENSE.md.
All versions of merx-mollie with dependencies
getkirby/composer-installer Version ^1.2
mollie/mollie-api-php Version ^2.0