Weave Code
Laravel Mollie Laravel Package
mollie/laravel-mollie
Laravel-Mollie integrates the Mollie API and Mollie Connect into your Laravel project, so you can accept iDEAL, Apple Pay, credit card, PayPal, SEPA, Bancontact and more payments, and easily refund transactions. No fixed monthly costs, and test mode works right away.
Mollie for Laravel integrates the Mollie API and Mollie Connect directly into your Laravel project, letting you accept online payments without fixed monthly costs or complicated registration. It supports a wide range of payment methods—including iDEAL, Apple Pay, Bancontact, credit card, SEPA transfers, PayPal, and more—so you can start receiving payments on your website quickly, even in test mode.
Built for Laravel developers, it offers a clean, idiomatic API for creating payments, handling webhooks, and issuing refunds.
- Supports iDEAL, Apple Pay, credit card, PayPal, SEPA, and many more
- Simple payment creation and refund handling
- Webhook support for status updates
- Works seamlessly with Test mode
- Includes Mollie Connect integration
Frequently asked questions about Laravel Mollie
- How do I install mollie/laravel-mollie in Laravel?
- Install it with Composer using composer require mollie/laravel-mollie. Laravel package auto-discovery registers the service provider and facade, but you should publish the configuration file if you need to customize it. Add your Mollie API key to your environment file and confirm the package works in Mollie test mode before going live.
- What Laravel and PHP versions does mollie/laravel-mollie support?
- The package is actively maintained and tracks recent Laravel releases, but you should always verify the exact Laravel and PHP constraints in its composer.json or Packagist page. Check the changelog before upgrading major Laravel or PHP versions. If you are on an older Laravel version, confirm compatibility before adding the package.
- How do I set the Mollie API key in Laravel?
- Publish the package configuration and set your Mollie key in the environment file, typically as MOLLIE_KEY. Use a test API key during development and a live API key in production. The package reads the key through Laravel configuration and resolves the Mollie client from the service container.
- Can I create payments and refunds with laravel-mollie?
- Yes, the package wraps the Mollie API client so you can create payments, retrieve payment status, and issue refunds through a Laravel-friendly interface. You can resolve the client from the container or use the provided facade. For business-specific refund or reconciliation rules, build that logic in your own services around the package.
- How do I handle Mollie webhooks in Laravel?
- When creating a payment, provide a webhook URL that points to a Laravel route or controller. Mollie will send a POST request to that URL, and you should use the package to fetch the payment by its ID and update your local records. For reliability, queue heavier processing and make your webhook handler safe against duplicate deliveries.
- Does laravel-mollie support subscriptions?
- The package exposes Mollie subscription operations through the API client, so you can create and manage subscriptions from Laravel. If you need a complete recurring billing layer with invoices, trials, and subscription lifecycle helpers, consider Laravel Cashier for Mollie instead. The package itself is best for direct control over Mollie API calls.
- How do I use Mollie Connect with Laravel Socialite?
- The package includes a Mollie Connect provider for Laravel Socialite, which helps with OAuth-based merchant onboarding. Configure your Mollie client ID, secret, and redirect URL, then use Socialite to redirect merchants and handle the callback. Store the returned tokens securely and use them for the connected merchant's API operations.
- How do I test Mollie payments in Laravel?
- Use a Mollie test API key while developing and exercising payment flows. In automated tests, mock the Mollie client or fake HTTP responses so your test suite does not call the real API. Also write tests for failed payments, webhook handling, and any custom order or subscription logic around the package.
- What should I watch out for in production with Mollie webhooks?
- Mollie webhooks can be delivered more than once, so make your handler idempotent and always re-fetch the payment status from Mollie before making irreversible changes. Process webhooks asynchronously with Laravel queues when possible, and plan for retries and rate limits. Log webhook payloads and failures so you can reconcile payments safely.
- Should I use laravel-mollie or Laravel Cashier for Mollie?
- Use laravel-mollie when you want direct, idiomatic Laravel access to the Mollie API for payments, refunds, subscriptions, and Connect onboarding. Use Laravel Cashier for Mollie if you want a higher-level recurring billing solution with subscription management built in. Many teams start with laravel-mollie and add custom billing logic only where needed.
Weaver
How can I help you explore Laravel packages today?