PowerPay Checkout Magento Module User Manual Support: it-support@joinusag.ch This document explains installation procedure and configuration options for Joinus AG PowerPay checkout magento payment module.
Overview This document explains installation procedure and configuration options. Requirements Module is tested with Magento 1.6 and later. PowerPay checkout module uses MFGroup payment gateway. Therefore MFGroup must allow http(s) communication on firewall beetwen your server and payment gateway. PowerPay checkout module module works only for customers which shipping and billing address are the same and address is in Switzerland. Only allowed currency within shop is CHF. Magento cron must be setup properly. Setting Magento cron is out of scope for this document. Information how is this can be done can be found on web. Useful url: http://www.magentocommerce.com/wiki/1_-_installation_and_configuration/how_to_setup_a_cron_job Module installation Commandline installation It is possible to install module by using magento mage command line script. Make sure that mage script inside magento root folder is executable and then issue following commands:./mage mage-setup./mage install-file Mfgroup_Invoicepay-1.1.1.tgz After installation is done make sure to Flush Magento Cache and refresh all cache types. Installation by copying extension files Unpack Mfgroup_Invoicepay-1.1.1.tgz file and then copy content to magento root folder. Installing with custom Magento theme This extension installs layout file and necessary templates. Those are: app\design\frontend\base\default\layout\invoicepay.xml app\design\frontend\base\default\template\invoicepay Copy those files to your custom theme to make sure that new payment method is properly installed on your magento deployment. 2
Configuration parameters Configuration requirements Module installs additional attributes to customer address. Those are: o o o Date of birth Gender Mobile phone number In order that those attributes become visible on frontend it is required that Show Data of Birth and Show Gender fields on System -> Configuration -> Customer Configuration -> Name and Address Options are set to Required. Figure 1 Name and Address Options 3
Module Configuration Parameters Module configuration is done on System -> Configuration -> Payment Methods -> PowerPay Checkout. 4
Figure 2Module Configuration Parameters Enabled By default, this payment module is enabled. If there is a need, this module could be disabled without deinstallation. Title This configuration option defines label that is shown on frontend, for example on the onepage checkout page. It can be set on store level which is usefull when store view is used for multilanguage web shops. Gateway Url, Username and Password This configuration options are provided by MFGroup. Please check with MFGroup that firewall enables http(s) communication beetwen Magento server and Gateway Url. Merchant Id, Filiad Id and Terminal Id This configuration options are provided by MFGroup. Log transaction info This configuration directive defines whether all communication beetwen Magento and MFGroup Payment Gateway should be logged. If enabled, XML messages sent via HTTP will be loged to var/log/payment_invoicepay.log. This file is created during installation, but must be writable for web user. Please verify this is option is enabled and no content is appended to file. Sandbox Parameters Sandbox parameters are enabled by default. When enabled, Sandbox Gateway URL, Username and Password will be used. In this case test environment is used on MFGroup side. When using test environment only prededined customer data can be used. Information This contains descriptive text shown on onepage checkout payment method selection. Figure 3Information configuration directive 5
Figure 4Information text displayed during onepage checkout Confirmation messages Confirmation xml messages is sent once per day and it collects messages sent in previous day and creates conversation pairs. This must be sent, otherwise payment transactions are not processed. Configuration of this communication is done by Magento cronjob feature. Setting when this message is sent is done by changing file: app\code\local\mfgroup\invoicepay\etc\config.xml Default settings are like in linux crontab and by default set like: <cron_expr>0 1 * * *</cron_expr> which means every day at 01:00. 6