Installation Guide

User Manual: Pdf

Open the PDF directly: View PDF PDF.
Page Count: 9

DownloadInstallation Guide
Open PDF In BrowserView PDF
AltaPay & Magento 1
Installation Guide
AltaPay has made it much easier for you as merchant/developer to receive secure payments in your Magento 1
web shop. AltaPay is fully integrated with Magento via a plug-in. All you have to do is to install the plug-in,
which will only take a few minutes to complete.
We will show you how to complete the installation through a step-by-step guide. Follow this guide to start
accepting payments globally.
To make the set-up as smooth as possible for you, this installation guide is divided into following sections:

Table of Contents
PREREQUISITES

2

INSTALLATION

2

CONFIGURATION OF ALTAPAY BUNDLE

5

CUSTOMIZATION

6

SUPPORTED FUNCTIONALITIES

7

TROUBLESHOOTING

8

MISC

8

CHANGE LOG

9

1

Prerequisites
We highly recommend to gather all the information below before starting the installation.
1.
2.
3.
4.

5.

Magento 1 minimum supported version by the plugin is currently Magento CE 1.9.2.
PHP supported versions by Magento CE 1.9.2 are 5.4.x, 5.5.x and 5.6.x
PHP bc-math library
Prerequisites for the configuration of the plug-in. AltaPay provides these.
a. AltaPay credentials and gateway information
i.
Username
ii.
Password
iii.
Terminal
iv.
Gateway
Prerequisites for fraud detection
a. Agreement with external fraud partner such as ACI ReD or MaxMind. Be aware that only
etection on
the terminal.

PHP 7 is not compatible with Magento 1. See, for example:
http://magento.stackexchange.com/questions/107583/grand-total-not-updated-when-discount-code-is-applied

Installation
Manual installation
-in by extracting it into the root folder of your Magento installation.
Installation using Magento Connect
The recommended way to install the plugin is using Magento Connect. Follow the steps below.
1. First step to take is to check if you have enabled compiler. If compiler is enabled you need to disable
it. To do so, log in to Magento Admin Panel. Go to System >Tools>Compilation

2

2.

And

3.

After that go to System > Magento Connect > Magento Connect Manager.

.
4.

5.

-enter your administrator credentials again.

Navigate to
package file upload
browser window navigate to the plugin package provided by AltaPay and select it. After selecting
plugin package, click o

3

6.

Installation progress will be shown in the console screen on the same page where you can check
if installation was successful.

7.

After successful installation make sure to enable compiler again if it was disabled in the first steps
of installation.

4

Configuration of AltaPay bundle

1.
2.
3.
4.

Go to: System  Configuration  AltaPay (If you get a 404 error, please flush your cache and logout
and in again).
Define the gateway URL, username and password (URL for test environment is
https://testgateway.altapaysecure.com).
Save the config to have the plug-in to pull a list of available terminals
For each of the Gateway groups, you have the following options:

a.
b.
c.
d.
e.
f.
g.
h.

Enable = Enable the payment method in the checkout
Terminal = Here you select the appropriate terminal
Title = Define the title shown in the checkout (this will not affect the name used other places,
e.g. the e-mail send to customers)
Payment Action = Here you define if only an authorization should take place, or if the
transaction should be captured immediately
AVS = Enable Address Verification process
Enforce AVS = If payment method does not provide AVS due to some reason, transaction will
be rejected
AVS accepted codes = Here you specify AVS Codes which you would like to accept (comma
separated)*
Sort Order - Defines the order in which the payment methods are listed in checkout

Save the file and make sure the Application-xxxx.js and current.js files have been regenerated.
When you have successfully set up environment you can start processing transactions through AltaPay.

5

Customization
It is possible to customize various aspects of the plug-in. Below is a list with the most relevant files
Render the payment page
app/design/frontend/base/default/template/altapay/checkout/form.phtml
Style the payment form
app/design/frontend/base/default/template/altapay/checkout/magento_styling.css
Display a failed page to the customer
app/design/frontend/base/default/template/altapay/checkout/failed.phtml
-mail
app/design/frontend/base/default/template/altapay/payment/info/gateway.phtml
All customized files are subject of change when installing new version of the plug-in. Keep in mind to
backup and merge modified files during installation.

6

Supported Functionalities
Supported functionalities
Use of Magento shop layout on payment pages
Support for scopes
Order-ID is pre-assigned when customer is sent to the gateway
The basket is only converted to an order when the payment is successful
Pending state for various payment methods
Supported payment methods
Payment Type

Description
A payment card is issued by a financial institution (a bank) to a client that enables

Card

Invoice

ePayments

Bank-to-bank

Cash Wallet

Mobile Wallet

and make electronic funds transfer. Most common cards are debit and credit
payment cards.
Example: VISA, MasterCard, Amex, JCB, Maestro, Discover
An invoice is a billing type payment, normally with a restricted number of days to
pay in and with various interests or fees depending on the payment method.
Example: Klarna, Afterpay, Santander, ViaBill
Also known as e-commerce payments and are similar to giro transfers, but
specifically designed for online check-outs. During the online checkout process,
the merchant redirects the consum
site where they login and authorize charges.
Example: IDEAL, Trustly, Sofort, Giropay PayPal, Paysera, Przelewy24
Is known as a bank transfer, wire transfer, or credit transfer. With bank-to-bank
payments money flow from one bank account to another.
Example: Giropay, ELV
Is an online money transfer method, in form of an electronic wallet, where the
cardholder transfer money through the internet. The electronic wallet functions as
an account where cardholder can transfer money too, in order to pay with the
specific payment method.
Example: PayPal, V.Me
Payments via. mobile refer to payment services operated under financial
regulations and are performed from mobile devices. The technology behind this
type of payments are contactless, and the supported technology is NFC, QR
Codes, Bluetooth, or direct bank transfers.
Example: MobilePay, Swish

For available payment methods AltaPay supports following functionalities
Functions

Reservation

Capture
Partial Capture
Release
Refund
Partial Refund
3D Secure
Fraud Prevention
(without support
response)

Description
In an online transaction, and before the transaction gets successful or failed, there
are some technical steps. A payment request happens when cardholder places the
order. The request is then
reserves
amount on the cardholder bank account, before the transaction is either
(
) when merchant is ready to ship (or cancel) the goods to
cardholder.
Purchase is completed/amount is captured , the good have been sent and the
t.
Purchase has to be split into e.g. two deliveries, one is captured and shipped right
away and the second Is captured and delivered after a specific amount of time
due to e.g. stock supply.
Pre-auth is released and reservation is cancelled/ removed.
Money are refunded to the cardholder. Depending on the payment method this
operation may not be instant and can take a few days from the moment the
refund is done until received by the customer. The delay is solely controlled by the
payment method provider or card issuer.
Purchase has been partly refunded to cardholder. If a part of the purchase is
refunded to cardholder/ part of the total transaction has to be refunded.
3D Secure adds an authentication step for online payments. It is an XML-based
protocol designed to be an additional security layer for online card transactions.
Fraud services deters fraud, credit risks, identity fraud, involuntary chargebacks
etc.
the transaction for the merchant. If the cardholder seems suspicious the
transaction is denied.

7

MO/TO

notcard for merchant.

e

Feel free to contact our support team if you need any assistance during the installation process or have
questions regarding specific payment methods and functionalities.

Troubleshooting
1.

PHP Warning: Input variables exceeded 1000. To increase the limit change max_input_vars in php.ini.

For orders that contain too many products, this PHP warning may be issued. You will have to edit your php.ini
file and restart your server.
The variable that you must change is called max_input_vars. This is the maximum number of variables that can
be sent in a request. You can change it, for example, to 3000. The default is 1000.

2.

Description/unitPrice/quantity is required for each order line, but was not set for line: xxxx

The same problem as above. The request is being truncated because the number of variables are exceeding the
max_input_vars limit.

3.

Logs directory for troubleshooting with AltaPay Support

/var/logs/altapay{DATE}.log where {DATE} represents the date when the log is created.
For each date new log is created.

Misc
AVS Response Codes
A
B
C
D
E
F
G
I
M
N
P
Q
R
S
U

Address matches, but zip code does not
Street address matches, post code not verified due to incompatible formats
Street address and postal code not verified for international transaction due to
incompatible formats
Street address and postal codes match for international transaction
AVS not supported for this industry
Full Match - Address and Zip/Postal Code match (UK Only)
Address information is unavailable; international transaction; non-AVS participant
Address information not verified for international transaction
Street address and postal codes match for international transaction
No Match on Address (Street) or Zip
Postal codes match for international transaction. Street address not verified due to
incompatible formats
Unknown response from issuer/bank-net switch
Retry. System unable to process
AVS not supported for this industry
Address information is unavailable

8

W
X
Y
Z

Nine-digit zip code matches, but address does not
Exact. Nine-digit zip code and address match
Yes. Five-digit zip code and address match
Five-digit zip code matches, but address does not

Change Log
Version

Note

2016

Documentation created with AltaPay look and feel

2017-04-25

Troubleshooting section addition

2018-01-22

Documentation improvement

9



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : No
Page Count                      : 9
Language                        : da-DK
XMP Toolkit                     : 3.1-701
Producer                        : Microsoft® Word 2016
Creator                         : Betricia Brandt
Creator Tool                    : Microsoft® Word 2016
Create Date                     : 2018:02:06 15:03:24+01:00
Modify Date                     : 2018:02:06 15:03:24+01:00
Document ID                     : uuid:BA281B3D-10CC-4DAA-AF2A-A89D9F38D664
Instance ID                     : uuid:BA281B3D-10CC-4DAA-AF2A-A89D9F38D664
Author                          : Betricia Brandt
EXIF Metadata provided by EXIF.tools

Navigation menu