release 1.0.1 MAGENTO PAYMENT PLUGIN MAXIMUM CONSULT Tel: (+258) 21 903 112 (+258) 84 74 37 30 8 (+258) 82 61 45 471 Email: info@maximumconsult.com Maputo. Mozambique
1 Paguei.Online is the first Mozambican online mobile payment gateway with e-wallet that allows Mozambicans to make instant and secure online payments without a credit card or bank account. Through Paguei.Online, shoppers can pay for goods and services online while sellers can receive payments for purchases made online, on Mozambican Websites. Paguei.Online is all about letting you focus on your core business while providing a secure, yet user friendly trusted platform to help you to easily integrate and automate payments from your customers using Mozambicans mobile money services such as Millennium IZI, m-pesa, Conta Móvel/Tako Móvel, m-kesh, etc.. It also accepts bank deposits and ATM Transfer as alternative method to load money in Paguei.Online account., company registered in Mozambique with the registration number 8082.. www.paguei.online
2 Table of Contents 1. Introduction... 3 2. Magento Version Support... 3 3. Installation... 3 3.1 Install Magento... 3 3.2 Install Paguei.Online payment gateway plugin to Magento... 4 4. Setup... 9 4.1 Paguei.Online payment method Settings page screenshot... 10 5. Test... 11 Paguei.Online Gateway payment Page... 13 Paguei.Online Gateway payment page with decline reason... 13 6. Verify... 14 7. Support... 14
3 1. Introduction This is an extension plugin for Magento for using Paguei.Online Gateway as a payment method. Magento Community Edition is open source ecommerce software used to power your online store and can be downloaded for free. Developers can modify the core code and add features and functionality by installing extensions from the Magento Connect marketplace. Magento is owned by ebay. This guide explains the required steps in order to successfully set up Paguei.Online Gateway as the payment provider in Magento. It assumes that you already have a working installation of Magento. 2. Magento Version Support This Payment Module supports the following Magento Community Edition Versions: Stable Releases 1.4, 1.4.1.1 1.5.0.1 1.6.0.0 1.6.1 1.6.2 1.7 1.8 1.9
4 3. Installation 3.1. Install Magento Magento is free web software you can use to create an online shopping website. The core software is built by hundreds of community volunteers with thousands of plugins and themes available to transform your site into almost anything you can imagine. Visit the Magento website for more information: http://www.magentocommerce.com/ 3.2. Install Paguei.Online payment gateway plugin to Magento Login to the Magento administration interface. Paguei.Online gateway is installed using Magento connect manager. To install Magento new payment gateway using Magento Connect manager is very simple, by Default Magento has default payment methods, you have to add your required payment method through Magento Connect manager, to install Paguei.Online payment methods using Magento Connect manager with screenshots as follow. Go to Admin->system under system ->Magento Connect >Magento Connect Manager as seen below
5 You will be required to log into the Magento Connect Manager. It is the same as your admin login Credentials.
6 Once you have logged in, upload the.tgz file using the 'Direct package file upload' form. This will automatically install the extension for you. If the installation is successful you should see a console box like this.
7 When you refresh you can confirm that the extensions have installed
8 Installing Magento extensions automatically via the Downloader is the best option. It is much easier and makes it easy to remove an installed extension. That being said, there are many problems with the Downloader that may stop it working for your site (permissions being the main problem). If you are unable to use the Downloader, you can install the extension manually. You can also add the extension to the Downloader so that if in future you fix your Downloader, the extension will be registered there and can be upgraded or uninstalled automatically. To install the extension manually, extract the files from the.tgz file. Next, ignore the package.xml (this is used by the Downloader to automatically install the extension) and merge the rest of the files with your Magento site using either FTP or SFTP. Refresh the Magento Admin and the extension will be installed. To register the extension with your Magento Downloader, copy the name of the.tgz file (not including the.tgz part) and rename package.xml as the file you just copied followed by '.xml'. Upload this file to var/package/ and the extension will be registered in your Downloader If there are no issues in the console box, select Return to admin near the top.
9 4. Setup In the System tab, click on the Configuration subheader. In the list of options on the left, click Payment Methods Paguei.Online Gateway should be present in the list. Configure it as follows
10 4.1. Paguei.Online payment method Settings page screenshot a) Enabled: This is used to enable or disable payment method. Change this to yes to enable. b) CALLBACK URL: This is the API callback URL provided by Paguei.Online when you signed up for an account. It is in the format http://exemplo.co.mz/ PagueiOnline/payment/response Replacing exemplo.co.mz with your domain name c) SHOP NAME: The Name of the Online Store. For example Quelimane Shopping d) CLIENT SECRET: This is the Client Secret provided by Paguei.Online when you signed up for a Merchant account e) MERCHANT ID: This is a merchant identifier issued by Paguei.Online when you sign up for Merchant Account f) CLIENT ID: This is the API Client ID provided by Paguei.Online when you signed up for a merchant account. Go to Settings > API Credentials g) CALLBACK URL This is a merchant identifier issued by Paguei.Online when you sign up for Merchant Account h) Title The title can be anything distinguishable, such as Paguei.Online Payment Gateway. The customer sees this during checkout.
11 i) New Order Status This is the status that is initially set when an order is placed awaiting payment confirmation. Set this to "Processing", or another status if you have created more. j) Sort Order: This is used to set the order of appearance of Paguei.Online payment method among other payment methods if configured. k) Once all the options has been configured click Save Config l) Proceed to your store frontend and follow the purchase process on the frontend 5. Test Log out of the admin area. Purchase a product from the Magento storefront, and proceed to checkout. Select Paguei.Online Gateway as preferred checkout payment method Proceed to confirm order you will be redirected to payment pages with instructions and button to initiate payment
12 Read through the payment instructions details and proceed to pay Complete the purchase, and verify you are sent to the checkout success screen.
13 If the transaction is declined you will receive Transaction response details containing decline reason and Transaction status code Paguei.Online Gateway payment page with decline reason
14 6. Verify Log back into the admin area. In the Sales tab, click on Orders, then on the row of your transaction. Verify the transaction details are correct. If payment transaction was accepted the order will be updated as complete You can also login to Paguei.Online Dashboard and confirm payment by filtering through the transactions if it was captured. 7. Support In case of any technical issue visit our forum and post your issue or create a new ticket on Docs & Support Portal.