EASYPAY MODULE - MAGENTO 2

Transcription

1 EASYPAY MODULE - MAGENTO 2 This document aims to describe the installation and configuration of the EasyPay Magento2 module. 1. INSTALLATION To assure correct functioning it s necessary to install and additional package Guzzle. It can be installed, executing the following command form the Magento root directory: composer require guzzlehttp/guzzle Then, execute the following (where <root_directory> it s the Magento root directory) 1.1. Create directory <root_directory>/app/code/toogas/easypay 1.2. Extract module files on the directory <root_directory>/app/code/toogas/easypay 1.3. Activate the module: php bin/magento module:enable --clear-static-content Toogas_Easypay 1.4. Update the data base: php bin/magento setup:upgrade 1.5. If you re working in a productive environment, compile code: php bin/magento setup:di:compile 1.6. Recreate the static files: php bin/magento setup:static-content:deploy * To disable the modules, run the following command on Magento root directory: php bin/magento module:disable --clear-static-content Toogas_Easypay

2 2. CONFIGURATION 2.1. Magento Backend The module configurations can be accessed on Magento Backend, from: Stores > Configuration > Sales > Payment Methods / other payment methods, under Easypay. Module configurations are divided like this: Customer Configuration Entity Check on Easypay s Backoffice, the field Customer Details > entity CIN Check on Easypay s Backoffice, the field Customer Details > cin Validation Code Check and configure on Easypay s Backoffice under Webservices > Code Configuration, field generated code Client Id Check on Easypay s Backoffice, the field Customer Details > Client Id Language Language used on Webservices (check with Easypay) Country Country used on Webservices (check with Easypay) Debug Activate logs record Sandbox Test mode, to be used for developing and testing

3 "Customer Details" fields on Easypay s Backoffice: Configuration of payment methods on Magento Backend All payment methods have the following parameters: Enabled Title New Order Status Payment from Applicable Countries Select Countries Sort Order Instructions Enable/disable the payment method Title for the payment method used on the site Once the order is finished it will assume this status Define if the payment method is available for all countries or just the specified. If you have selected Applicable Countries, define which. Order to list the payment methods on checkout Specify the instructions to be presented on checkout

4 2.1.3 Additional configurations for the payment methods More than the general parameters, you can also define specific parameters: Direct Debit Periodicity If the client chooses more than one payment over direct debit, during checkout, this parameter defines the payment execution periodicity. Credit card Manual capture If Yes is checked the payment is only authorized. The funds capture must be later done on Easypay s panel.

5 2.2 On Easypay s BackOffice In order to make the module functional, it s necessary to define some parameters on Easypay s BackOffice Code Configuration Under Webservices > Code Configuration, on Easypay s BackOffice, select he option Validation = Code and generate the code. This code will be used on step of this document Notification URLs You should also fill in the notification URLs table available on Easypay s BackOffice. Access via Webservices > URL Configurations to the CIN defined on step of this document. This URLs must obey to the following: (replace <your_store_url > with your site s URL includind http or https) Visa details Visa fwd Callback Recurrent Callback Boleto fwd < your_store_url >/easypay/payment/visadetails < your_store_url >/easypay/payment/visaforward < your_store_url >/easypay/payment/callback < your_store_url >/easypay/payment/recurrent_callback < your_store_url >/easypay/payment/boletoforward