Documentation
Installation instructions
If downloaded package has .ocmod.zip extension, you can install it using Extension Installer. If you see "The directory is not allowed to be written to" error message, download Extension Installer Fix from this page and install it. Then install the main extension.
In any other case or if you want to install it manually, unpack and upload all folders to the root of your store. If there's install.xml file in the package, rename it to extension_name.ocmod.xml, replacing "extension_name" with extension's name, and upload it to "system" folder.
When upgrading from previous version rewrite all existing files. Refresh modifications cache from Extensions -> Modifications page.
Note for OpenCart 2.0.X users
Sometimes OCMod inserts modification in multiple files, which are separated by "|" character in XML-file. On earlier OpenCart 2 versions a comma was used instead. To quickly fix this, open XML file and replace all occurrences of "|" character with "," for "path" attribute in every applicable <file> element. Search for "<file path=" to quickly find and highlight all elements.
Note for OpenCart 2.3 users
On OpenCart 2.3 compatibility code is broken, which may lead to Permission Denied issue, when you access extension settings. To fix this you need to install OpenCart 2.3 Compatibility Fixes extension.
The right sequence of actions is the following:
- Download our purchased (or free) extension, but do not install it yet (uninstall, if already installed).
- Install OpenCart 2.3 Compatibility Fixes extension.
- Refresh modifications cache from Extensions -> Modifications page.
- Go to System -> User Groups and select all access/modify permissions for your group.
- Install our purchased (or free) extension.
If you did everything right, everything will start working properly.
Note for OpenCart 3 users
NOTE: Instructions below are required only if "admin" or "catalog" folders are present in the package!
To install and use extension on OpenCart 3 you need to install OpenCart 3 Compatibility Fixes. It adds backward compatibility with old extension structure plus adds back support for .tpl files and enables automatic template engine detection.
The right sequence of actions is the following:
- Download our purchased (or free) extension, but do not install it yet (uninstall, if already installed).
- Install OpenCart 3 Compatibility Fixes extension.
- Go to Extensions -> Modules section, install and enable Template Switcher.
- Refresh modifications cache from Extensions -> Modifications page.
- Go to System -> User Groups and select all access/modify permissions for your group.
- Install our purchased (or free) extension.
If you did everything right, everything will start working properly.
Permissions
In some cases it is required to manually set permissions for installed extension. To do this go to System -> User Groups, find your group and select access/modify permissions for desired extension. You can find extension in permissions list by folder/filename pair (for example, marketing/acoupon).
Extension Setup
Go to Extensions -> Payment, find Visa QIWI Wallet, click Install and then setup accordingly.
Registration
First of all, you need to register in QIWI twice: as web-shop (to receive payments) and as a wallet (to withdraw money). When registration is approved, go to your account, "Settings" -> "REST-protocol" and copy Shop ID into corresponding field in extension's settings. On the same page near "API ID" click "Generate new ID" button and copy ID and password from popup window the same way. Don't loose the password, for it's displayed only once!
Turn on Pull protocol and notifications below. In "Notify URL" field insert URL from extension's settings and check "Sign" option. Click "Change password" button to the right and copy password from popup window to corresponding field in extension's settings. Save the settings.
Go to "Settings" -> "HTTP-protocol" page and just enable the protocol. Don't miss this part or extension won't work!
NOTE: If you set everything right, but order statuses don't change automatically upon payment or cancellation, contact QIWI support.
Extension's options
In general, all options are pretty easy to understand, but some of them require explanation:
- Notify URL — Insert this URL in corresponding field on REST-protocol page in your QIWi account.
- Shop ID — Shop (agreement) ID, which can be taken from REST-protocol page in your QIWI account.
- API ID — API ID, which can be taken from REST-protocol page in your QIWI account.
- API Password — Also can be found on protocol page, but displayed only once, when you create new API ID. If you lost API password, you must create another API ID.
- Notification Password — Can be found on protocol settings page and absolutely necessary to automatically change order statuses.
- Wallet Number — Your QIWI wallet (phone) number. Required only if you enable Add to History option.
- Order Minimum — Order subtotal minimum value to display this payment method.
- Currency — Main store currency for payment and invoices.
- Invoice Lifetime — For how long invoice will be available for payment in customer's QIWI account. When limit is reached, invoice will be cancelled.
- Add to History — Your QIWI wallet number will be added to order history, when new order is created.