Monext Sylius Plugin

---

Table of Content

• Overview
• Features
• Installation
  • Requirements
  • Installation process
• Configuration
• Additional resources for developers
• License
• Contact and support

Overview

This plugin allows you to use the Monext payment system with a Sylius ecommerce application.

Features

This plugin integrate with native Sylius orders' workflow and provides the following features: It allows you to:

• Do offsite payment on a payment page hosted by Monext.
• Choose between immediate capture or only triggered by a specific order state (like capture at shipping).
• Cancel payments (not partials).
• Refund payments (not partials).

This plugin does not use features from Sylius Plus.

Supported payment methods

This plugin supports the following payment methods:

• CB
• Visa
• Mastercard
• American Express
• ApplePay
• GooglePay
• Paypal
• Bancontact
• iDEAL
• Klarna
• Multibanco
• MB Way

You can also check our documentation for more information about other supported payment methods.

Installation

Requirements

Package	Version
PHP	^8.3
ext-json:	*
sylius/resource-bundle	^1.10
sylius/sylius	^1.12.0
symfony/messenger	^5.4 or ^6.4

Installation process

1. Simply add the plugin to your project:

composer require monext/payline-sylius

2. Add plugin dependencies to your config/bundles.php file by adding this line to the end of the array (if it does not already exist) :

    MonextSyliusPlugin\MonextSyliusPlugin::class => ['all' => true]

3. Then add this line to your config/routes.yaml:

monext_sylius_plugin:
    resource: "@MonextSyliusPlugin/Resources/config/routing.yaml"

4. Finally, in config/packages/_sylius.yaml add this to the imports section:

    - { resource: "@MonextSyliusPlugin/Resources/config/config.yaml" }

5. Clear cache and run migrations:

bin/console cache:clear
bin/console doctrine:migration:migrate

6. Log into the Sylius admin area, then click on the left menu item "CONFIGURATION > Payment methods". There you can add a new payment method of type "Monext".

Configuration

Here are the main configuration fields for the payment method:

• API KEY:
  • Base64-encoded credentials.
• Point of sale:
  • Recommended to use one per Sylius channel, it's Monext's point of sale linked to the payments processed by this method.
• Environment:
  • Homologation for debug and test purpose.
  • Production for real payment.
  • You need to carry out 'pilot' transactions to validate that they are working properly in production.
• Contract numbers:
  • Comma-separated list of your enabled Monext payment contracts that should be used.
• Capture type:
  • Automatic: Authorization + Capture are immediately done.
  • Manual: Only Authorization is immediate, Capture should be either done manually or will be triggered by a specific transition in shipping states.
• Transition for manual capture:
  • Comma-separated list of transitions in the Winzou state manager used for triggering a manual capture.

---

Additional resources for developers

To learn more about how the API used by the plugin and how to modify or use Sylius with it to fit your needs:

• Sylius Plugin Monext documentation
• Monext API documentation
• Sylius Documentation
• Sylius Online Course

License

This plugin's source code is completely free and released under the terms of the MIT license.

Contact and support

If you want to contact us, the best way is through this page on our website and send us your question(s).

We guarantee that we answer as soon as we can!

If you need support you can also directly check our FAQ section and contact us on the support page.