Download the PHP package monei/sylius-monei-plugin without Composer
On this page you can find all versions of the php package monei/sylius-monei-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download monei/sylius-monei-plugin
More information about monei/sylius-monei-plugin
Files in monei/sylius-monei-plugin
Package sylius-monei-plugin
Short Description MONEI payment gateway for Sylius — Cards, Bizum, Apple Pay, Google Pay via hosted page or embedded component.
License MIT
Informations about the package sylius-monei-plugin
MONEI Payment Plugin for Sylius
Accept payments with MONEI in your Sylius store — Cards, Bizum, Apple Pay, Google Pay.
MONEI is a licensed Payment Institution (Banco de España #6911).
Features
- Two integration modes — Hosted Payment Page (redirect) or Embedded MONEI Component (JS widget), configurable per gateway in the Sylius admin
- All MONEI payment methods — Cards (Visa, Mastercard, Amex), Bizum, Apple Pay, Google Pay
- Full lifecycle support — Capture, Refund (full & partial), Cancel, and Status sync
- Webhook-driven — Asynchronous payment status updates via signed MONEI webhooks
- PSD2 / SCA ready — 3D Secure handled automatically by MONEI
- Official SDK — Built on the
monei/monei-php-sdkfor reliable API communication and signature verification - Multi-language — Admin translations in English, Spanish, Catalan, and French
Requirements
| Dependency | Version |
|---|---|
| PHP | 8.2+ |
| Sylius | 2.1+ |
| Symfony | 6.4 or 7.x |
Installation
1. Install via Composer
2. Register the bundle
If your Sylius project doesn't use Symfony Flex, add the bundle manually:
3. Import the plugin routes (optional)
Payum handles the webhook notify route automatically — no additional route config is needed for basic operation.
4. Configure MONEI in the Sylius Admin
- Go to Configuration → Payment methods
- Click Create and choose MONEI as the gateway
- Fill in your API Key and Account ID (find these at dashboard.monei.com)
- Select your preferred Integration Type: Redirect or Embedded Component
- Toggle Sandbox mode for testing
- Assign the payment method to your desired channels
That's it — your store is now accepting payments via MONEI.
Configuration Reference
| Field | Description |
|---|---|
api_key |
Your MONEI API key (pk_test_... for sandbox, pk_live_... for production) |
account_id |
Your MONEI account identifier |
integration_type |
redirect (hosted page) or component (embedded MONEI.js widget) |
sandbox |
Enable test mode — no real charges are processed |
How It Works
Redirect Flow (Hosted Payment Page)
- Customer clicks "Pay" → Sylius creates a MONEI payment via the API
- Customer is redirected to MONEI's PCI-compliant hosted page
- Customer completes payment (card, Bizum, Apple Pay, Google Pay)
- MONEI redirects back to your store's completion URL
- MONEI sends a webhook to confirm the final status asynchronously
Component Flow (Embedded MONEI.js)
- Customer clicks "Pay" → Sylius creates a MONEI payment via the API
- An in-page payment form is rendered using MONEI.js with card input, Bizum, Apple Pay, and Google Pay buttons
- Customer completes payment without leaving the page
- On success, the customer is redirected to the order confirmation page
- MONEI sends a webhook to confirm the final status asynchronously
Webhooks
MONEI uses webhooks to notify your store of payment status changes. The plugin automatically:
- Verifies the
MONEI-Signatureheader using the official SDK's signature verification (timestamp-based HMAC-SHA256) - Re-fetches the payment from MONEI's API to prevent spoofing
- Updates the Sylius payment status accordingly
Ensure your server is accessible from the internet so MONEI can reach the callback URL.
Testing
Use MONEI sandbox credentials (pk_test_...) and MONEI test cards to test the full flow without real charges.
Architecture
Contributing
Please see CONTRIBUTING.md for details.
License
This plugin is open-sourced software licensed under the MIT license.
Links
All versions of sylius-monei-plugin with dependencies
monei/monei-php-sdk Version ^2.10
payum/core Version ^1.7
sylius/sylius Version ^2.1