Installation Guide
MAGENTO
PAYMENT PLUGIN
MAXIMUM CONSULT
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.
Paguei.Online is a service and a Brand owned by MAXIMUM CONSULT, company registered in Mozambique with the registration number 8082. .
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
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
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
Once you have logged in, upload the .tgz file using the 'Direct package file upload' form. This will automatically install the extension for you.
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
4. Setup
In the System tab, click on the Configuration subheader.
In the list of options on the left, click Payment Methods
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
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
Read through the payment instructions details and proceed to pay Complete the purchase, and verify you are sent to the checkout success
If the transaction is declined you will receive Transaction response details containing decline reason and Transaction status code
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