README

Sylius Payum Monetico gateway plugin

This plugin is designed to add a new gateway to Payum to support Monetico over Sylius plugin

See https://www.monetico-paiement.fr/ for more information.

Installation

Install using Composer :

$ composer require flux-se/sylius-payum-monetico-plugin

Enable this plugin :

<?php

# config/bundles.php

return [
    // ...
    FluxSE\SyliusPayumMoneticoPlugin\FluxSESyliusPayumMoneticoPlugin::class => ['all' => true],
    // ...
];

Enable the required route for Monetico notify :

# config/routes/flux_se_sylius_payum_monetico.yaml

flux_se_sylius_payum_monetico_notify:
  resource: "@FluxSESyliusPayumMoneticoPlugin/Resources/config/routing/notify.yaml"

Configuration

Monetico notify URL

Using the Monetico merchant portal :

https://www.monetico-services.com/fr/test/identification/authentification.html

Click on the "Paramétrage" menu item, and finally on the sub menu item named "GESTION CODES SITES", you will be able to email Monetico to add a "notify URL" ("URL du CGI2") corresponding to the Symfony route named flux_se_sylius_payum_monetico_notify example :

https://my_domain.tld/monetico/notify

Monetico credentials

Get your TPE number, your KEY and your COMPANY(labeled "Code Site") name on your Monetico merchant portal :

https://www.monetico-services.com/fr/test/identification/authentification.html

1. TPE number : can be chosen into the select menu in the right sidebar of your Monetico merchant portal
2. KEY : Click on the "Paramétrage" menu item, and finally on the sub menu item named "CLÉ DE SÉCURITÉ". You will be able to email the owner of the account to get your KEY.
3. COMPANY : Click on the "Paramétrage" menu item, and finally on the sub menu item named "GESTION CODES SITES". The COMPANY is labelled "Code Site".

Sylius configuration

Go to the admin area, log in, then click on the left menu item "CONFIGURATION > Payment methods". Create a new payment method type "Monetico" :

Then a form will be displayed, fill-in the required fields :

1. the "code" field (ex: "monetico").

2. choose which channels this payment method will be affected to.

3. the gateway configuration (need info from here) :

   

   NOTE1: the screenshot contains false test credentials.

4. give to this payment method a display name (and a description) for each language you need

Finally, click on the "Create" button to save your new payment method.