Integration Manual
Valitor PrestaShopModule
Integrating with Valitor could not be easier. Choose between Hosted, HTTP POST or XML integration options, or alternatively browse our selection of client libraries and e-commerce platform modules. Imagine having full creative control over payment flow, checkout design, and A/B testing without any card data risk.
1
Table of Contents
Installation ................................................................................................................................................................................................................................................................................................................................................................................................ 2
Configuration ........................................................................................................................................................................................................................................................................................................................................................................................ 3
Important ................................................................................................................................................................................................................................................................................................................................................................................................... 6
FAQ ...................................................................................................................................................................................................................................................................................................................................................................................................................... 7
Changelog .................................................................................................................................................................................................................................................................................................................................................................................................. 7
2
Prerequisites Please note: AltaPay only supports PrestaShop version 1.6.x
Installation
To install the AltaPay module go to ‘Modules and Services’ à ‘Modules And Services’ and click on “Add a new module” from the top-right corner.
Now click on “Choose a file” from the “Add a new module” tab and find the Altapay.zip file. When you chose the file, click on “Upload the module”.
The module is now successfully imported. To finalize the installation, find the AltaPay module in the modules list and click on “Install” to the right of
the module.
3
A window will open - click on “Proceed with the installation”. When it’s done a green bar will be visible and state that the module has been
successfully installed.
Configuration
To configure the module, you would need your AltaPay gateway credentials:
- API username: This is an e-mail-address
- API password: Have been provided to you by the AltaPay Customer Care team.
- API url: This url will also have been provided to you. For testing please use “https://testgateway.altapaysecure.com”
Go to ‘Modules and Services’ -> ‘Modules and Services’ and find the AltaPay module. This can be done by searching for ‘AltaPay’ or go to ‘Payment
and Gateways’ and find the AltaPay module.
4
Click on ‘Configure’ for the AltaPay module.
Now you can enter the credentials for the API user and URL. The default value for the ‘Callback IP address’ doesn’t need to be changed.
You shall now set up the terminals. At the AltaPay module configuration page, at the bottom you find a list of “Terminals”. There is a plus sign which
you would need to click, to add a new terminal.
5
When setting up a terminal you have to select the icon and name that is going to be shown in the check flow. The currency must correspond with
the currency on the terminal at AltaPay. The payment type indicates if the money would be captured on reservation (‘Authorize and capture’) or the
merchant would have to capture, when delivering the goods.
When you have set up your terminals you are ready to process transactions through AltaPay.
6
Important
In your Prestashop system, the ‘Transaction ID’ is the ID which matches the ‘Order ID’ within the AltaPay backend, and therefore please do not use the
Prestashop Order ID as reference ID, when talking to AltaPay support.
This is a beta, and bugs can occur. Should you therefore encounter errors or other issues, please contact our support at [email protected].
7
FAQ
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. Parameters: description/unitPrice/quantity are required for each orderline, 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.
Changelog
Version Note
2017 First release.
2018-01-24 Document/format updated
2018-12-14 Documentation rebranded to Valitor
