Presentation

Monext offers you a plugin to add the payment module to your Sylius e-commerce platform.  

This allows rapid implementation of the Monext Online solution.

The available functions are:

• Widget mode with a display of the payment page hosted by Monext with buyer redirection.
• Cash payment.
• Payment upon order and upon shipment.
• Full refund.
• Payment methods:
  • CB, Visa, Mastercard, American Express, ApplePay, GooglePay, PayPal​.
  • with the acquirer Monext: Bancontact, iDEAL, Multibanco, MB Way​.
• Devise Euro.

The payment process 

Order management

Payment Information

In the order details of your console, Sylius allows you to directly access the details of the transaction(s): a box allows you to carry out validation and reimbursement actions.

Validation

Depending on your payment method configuration, you will need to validate your order in the Sylius console. 

In the Sylius console: 

• Cash on shipment is indicated as Allowed.
• A payment on order is indicated as Paid.

The order information is sent to Monext as soon as the order is validated: 

• Point of sale.
• Payment method contract number: paymentMethodIDs (Contract Number).
• Buyer information.
• Buyer's billing and shipping address.
• Selected delivery method.
• Cart contents.
• Order total, details and currency.

Cancelation

You can cancel an order only from the Sylius console before it is validated.

Refund

You can refund an order only from the Sylius console after it is validated.

Download the plugin

You must follow the procedure indicated on Github: https://github.com/Monext/monext-sylius

After installing the Monext payment module, you must configure the payment methods by selecting the  Monext module type.

Install the plugin

1. Simply add the plugin to your project:

composer require monext/monext-sylius

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

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

3. Then add this line to : templates/bundles/SyliusShopBundle/Checkout/SelectPayment/_choice.html.twig

@@ -14,5 +14,8 @@
        {% if method.gatewayConfig.factoryName == 'sylius.pay_pal' %}
            {{ render(controller('Sylius\\PayPalPlugin\\Controller\\PayPalButtonsController::renderPaymentPageButtonsAction', {'orderId': order.id})) }}
        {% endif %}
+        {% if method.gatewayConfig.factoryName == 'monext' %}
+            {{ render(controller('MonextSyliusPlugin\\Controller\\Shop\\MonextController::renderPaymentMethodAction', {'orderId': order.id})) }}
+        {% endif %}
    </div>
</div>

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

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

5. Clear cache and run migrations:

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

6. Log in to the Sylius administrator area, then click on the left menu item “CONFIGURATION > Payment methods”. You can add a new payment method of the “Monext” type there.

Payment method setup

This section allows you to configure and select from the active payment methods at your point of sale those which will be used in the store.

You can configure different payment tunnel in this section.

  You can also sort in the display order by setting the location number.
The first one in the list will be presented first in the checkout form. 

The payment methods offered on the redirection page are configured on the administration center with the smartdisplay function .

Menu : Configuration > Payment methods 

Pages related