Overview
The article below describes the process of installing and configuring the Mokka module for CMS OpenCart, which greatly simplifies the process of integrating with the Mokka service for a partner.
Installation
The module can be installed through the admin panel manually by transferring the module files to the server. Download the WooComrece Mokka module before starting the instructions.
-
Login to your website admin panel.
-
In the administrative section of your site, the section “Modules / Extensions –> Install extensions” (1 in the picture) - click the “Download” button (2 in the picture). We select the archive of the module previously downloaded to the computer and load it.
After uploading, you will be able to see your module archive in the list, like this:
- Next, you need to update the modifiers to add the changes necessary for the module to work. If the modifiers are not updated, then the Mocha view will disappear on the product page. To do this, go to the "Modules / Extensions –> Modifiers" section, find "Mocha - advance payment" in the list of modifiers, check the box next to the module and click the update button in the upper right corner.
- Next, go to the "System" tab (1) => "Users" (2) => "User groups" (3)
Select the user "Administrator", click "Edit".
In the window that appears, select "Select all" (1) - "Select all" (1) and "Save" (2)
- The next step is to install the module. To do this, go to the "Modules / Extensions –> Modules / Extensions" page. In the filter, select "Payment", the list of modules will be updated.
In the list of modules we find "Mokka - payment in advance" and click "Activate" in the column "Actions" opposite the module.
- The module is installed. Next, the module must be configured correctly.
Settings
On the "Modules / Extensions –> Modules / Extensions" page. In the filter, select "Payment", the list of modules will be updated. In the list of modules we find "Mokka - payment in advance" and click "edit" in the column "Actions" opposite the module.
* marked mandatory fields
Basic tab
The values below are set based on the contract:
- the minimum price of the goods to display the payment;
- the maximum price of the goods to display the payment;
- maximum number of months of loan;
- minimum number of months of loan.
Other fields:
-
- status after placing an order - specify the status to which the order should go after successful payment Mokka;
- status at which to send the finalization of the order - specify the status of your store, to which the completed order is transferred (the product is issued to the client)
- status at which to send order cancellation - specify the status to which the order should go if you have received an order, but it cannot be completed and must be canceled before the order is issued to the client;
- return of the finalized loan - indicate the status of your store, in which the order is returned in full after being issued to the client (for example, in the event of a warranty case);
- page with orders - provide a link to the "Thank you for your purchase" page;
sort order - a numeric value indicating the serial number of the display of the Mokka payment type is indicated. Default should be 0 - status – enabling/disabling the module. Switch the value to "Disabled", which will allow the module to be activated on your site.
-
API tab
When installing the module, by default the test mode is set with store test data.
For testing and debugging, set the values of the Store ID and Secret Key fields. Test data will be sent to you by the Mokka project manager.
Before the live launch, the Mokka project manager will send you the live Store ID and Secret Key
-
Widget Tab
Here are the widget settings on the product page.
Select "Enabled" in the "Widget status on the product page" field to activate the display of the broken price on the product card.
In the "Color scheme" setting, you can choose the format for displaying the "Broken price" on the product card.
-
Errors tab
By default, it is recommended to enable error logging. In case of problems, they will help to quickly localize and fix the problem. Specify the email address where you would like to receive bug reports.
After making the settings, click "Save" to apply the settings.
After installing and activating the module, the “Breaked Price” module should appear on the product pages and the payment method “Mocha – payment in advance” should be added to the cart.
An example of a “Broken Price” in a product card.
Testing
Checkout
- Collect the basket for the minimum amount.
- Go to cart.
- In the payment methods, select "Mokka - advance payment".
- Click "Checkout".
- A data entry form will open on the screen. Fill in all fields of the form. The phone number for approval on the test environment must match the mask +7 8881xxxxxx.
- Click "Checkout" and enter the confirmation code (always 1111 on a test environment).
- Select the payment schedule you are interested in and click the "Pay in advance" button.
Completion
- Go to the "Orders" section in the OpenCart panel.
- Select a previously placed order by checking the box next to the respective order.
- In the "Actions" menu, select the status "Change status to completed".
- Click "Apply".
As a result, the order will be completed.
Cancellation
- Go to the "Orders" section in the OpenCart admin panel.
- Select a previously placed order by checking the box next to the desired order.
- In the "Actions" menu, select the "Change status to canceled" status.
- Click "Apply".
As a result, the order will be canceled.
Refund
- Go to the "Orders" section in the OpenCart admin panel.
- Open a previously placed order by clicking on its ID.
- Change the status of the order to "Refunded".
- Click "Update"
Activation
After successfully installing the module and debugging on test data, activate the module so that the Mokka team can test the functionality and activate the service. To activate, follow the instructions:
- On the "Modules / Extensions –> Modules / Extensions" page. In the filter, select "Payment", the list of modules will be updated. In the list of modules we find "Mocha - payment in advance" and click "edit" in the column "Actions" opposite the module.
Go to the “API” tab Uncheck the “Test mode” checkbox, replace the value of the combat Store ID and Secret key with those that the Mokka team will tell you. Click "Save".
As a result, the payment method "Mocha - pay in advance" will become available to your site visitors.
Contact the Mokka integration team at integration@mokka.ru or your manager. For activation, we will check all functions and hosted communication for compliance with the standards of the service.