Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Associate Mollie payments with Eloquent models

Latest Version on Packagist Software License Build Status Code Quality Total Downloads

Implementing Mollie payments in your Laravel 5.4 app does not have to be difficult. This package helps you by creating payment records and keeping the status in sync with Mollie. It is built on top of the very solid official Mollie PHP client. It supports one-off payments only; recurring payments are not (yet) supported.




Via Composer

$ composer require sander-van-hooft/laravel-payable-redirect-mollie

Next, you must install the service provider:

// config/app.php
'providers' => [

And add the Mollie API key to the .env file in your project root. This is also where you can override the webhook route which Mollie calls when a payment status is updated:

# /.env:
# MOLLIE_WEBHOOK_URL=your_url_relative/to_your_app_url

You can publish the migration with:

$ php artisan vendor:publish --provider="SanderVanHooft\PayableRedirect\PayableRedirectServiceProvider" --tag="migrations"

After the migration has been published you can create the payments-table by running the migrations:

$ php artisan migrate

Laravel automatically loads the routes from this package.

If you prefer this over configuring using the .env file (not required!) you can also publish the payable.php config file with:

$ php artisan vendor:publish --provider="SanderVanHooft\PayableRedirect\PayableRedirectServiceProvider" --tag="config"

In the config file, you can set the MOLLIE api key and override the default mollie payment webhook route. This is what the default config file looks like:

return [
    'mollie' => [
        'key' => env('MOLLIE_KEY', 'test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'),
        'webhook_url' => env('MOLLIE_WEBHOOK_URL', '/webhooks/payments/mollie'),


Basic usage

In your code, create a Payment record using the MolliePaymentGateway:

// Using some App\Order model (provided by you)

$order = new App\Order(['amount' => 12345]);

$paymentGateway = new SanderVanHooft\PayableRedirect\MolliePaymentGateway;

$payment = $paymentGateway->chargeAmountForPayable(
    $order->amount, // AMOUNT IN CENTS!!
    'Some description',
    [ 'return_url' => '' ]

The payment amount is in eurocents!

The payment status will be kept in sync with Mollie: Mollie will call the webhook whenever the payment status changes. This will trigger your app to fetch the latest payment status from Mollie. Mollie has designed this process in this way for security reasons.


For convenience you can use the isPayableTrait on your payable Eloquent model (the App\Order model in the example above). This enables you to call $order->payments.

use Illuminate\Database\Eloquent\Model;
use SanderVanHooft\PayableRedirect\Payment;
use SanderVanHooft\PayableRedirect\IsPayable\IsPayableTrait;

class Order extends Model
    use IsPayableTrait;


PaymentEvents are dispatched for easy integration with your own custom listeners (see Laravel events and listeners). The following events are available:

  • PaymentUpdated: this event is dispatched when Mollie calls the webhook. It checks whether the payment status really has changed. Depending on the new status, it dispatches one of the Mollie based events below.
  • PaymentCancelled
  • PaymentChargedBack
  • PaymentExpired
  • PaymentFailed
  • PaymentOpened
  • PaymentPaid
  • PaymentPaidOut
  • PaymentPending
  • PaymentRefunded

Change log

Please see CHANGELOG for more information on what has changed recently.


Please mind that for testing the payment status synchronisation your app needs to be reachable on a public url by Mollie. Therefore, under normal circumstances, you cannot fully test this functionality on a local Laravel installation.

Make sure to configure the Mollie API key (MOLLIE_KEY) as an environment variable. This can for example be done in the phpunit.xml file.

$ composer test


Please see CONTRIBUTING and CONDUCT for details.


If you discover any security related issues, please email instead of using the issue tracker.



The MIT License (MIT). Please see License File for more information.