Magento

Team ViaBill Updated by Team ViaBill

ViaBill Integration for Magento 2

If you have not yet contacted our Business Development Team to sign your service agreement, please contact merchants@viabill.com. Failure to do so will result in your account's deactivation.

Description

ViaBill provides a seamless financing solution for thousands of merchants and customers across the world featuring low transaction costs and stellar support.

With ViaBill, you can increase your average order size and conversion rate, and put your customer in focus so they can get what they want when they want it — without your customer having to pay in full and upfront.

Installation

Before you start the installation of the module, make sure you meet the requirements set by your Magento version. More specifically, you should make sure that the PHP version and the Composer version is compatible with the Magento 2 version installed on your server. Also, make sure there is enough PHP memory (2GB or more) to complete the installation without errors.

As with all Magento extensions, it is highly recommended to backup your site before installation and to install and test on a staging environment prior to production deployments.

Note that ViaBill Payment module is compatible with Magento 2.3.x and early versions of 2.4.x.

Installation via Composer

If you’re running the composer command for the first time, you may be asked for your Magento Marketplace account credentials (Public Key and Private Key). Therefore, if you haven't done it before, please go to https://magento.com/ and create an Magento Marketplace account to obtain the keys.

1. Log in to your server with SSH and go to the Magento 2 root folder.

2. Enter the command: composer require viabillhq/module-payment

3. Enter the command: php bin/magento module:enable Viabillhq_Payment

4. Enter the command: php bin/magento setup:di:compile

5. Enter the command: php bin/magento setup:upgrade

Installation via app/code folder

This method is an alternative method to the installation via Composer, in case you have not enough PHP memory to complete the installation, or if the composer tool is not available.

1. Download the module files from a public repository

2. Copy the contents of the viabillhq/module-payment folder into the newly created {magento 2 root folder}/app/code/Viabillhq/Payment folder.

3. Enter the command: php bin/magento module:enable Viabillhq_Payment

4. Enter the command: php bin/magento setup:di:compile

5. Enter the command: php bin/magento setup:upgrade

Installation via Marketplace

Please follow these instructions to install the module through the Magento Marketplace. Note that this method is not available in all Magento versions.

Configuration

From Magento Admin, navigate to Stores -> Configuration -> Sales -> Payment Methods section. On the Payments Methods page ViaBill should be listed together with other installed payment methods in the system.

New or Existing User

Before configuring the module, you need to create a new ViaBill account or sign in, if you already have an existing one.

If you are new to ViaBill, you will have to enter the required fields, accept the terms and conditions and click on the “Create new user” button.

If you have an existing account, you will need to enter your account's email and password and then click on the “Connect” button.

Module Configuration 

Once you have successfully created your ViaBill account, or login into your existing one, you will be able to configure the payment module.

Please pay attention to the following settings:

•      Enable: Set the parameter to “Yes” to enable this payment method.

•      Test Transactions Mode: If this parameter is set to “Yes”, no actual payment is made, therefore orders should not be shipped. Once you are ready to use ViaBill with real customers it's important to set this parameter to “No”.

•      Debug Mode: This parameter is useful if something is not working as expected and it can provide valuable information to the tech support team.

You can also enable an auto-capture feature in your configuration settings that will automatically capture the payment for that order. Payments need to be captured in order for ViaBill to process your payouts. If this is left on Authorized, the customer's payment will be canceled after 7 days.

To enable this, change the parameter on the Payment Action field from "Authorize Only" to "Authorize and Capture".

Tip: If you can't save the module configuration settings without getting any errors, click on the “Configure” button for the PayPal Express Checkout payment method that appears on the same page. Sometimes, the browser fills in partially, the Express Checkout form fields and you have to manually clear these fields before clicking on the “Save Config” button.

PriceTag Settings

If you enable the ViaBill Price Tag feature, then a small info box will appear below the product price and/or the cart total price to indicate the monthly installments.

Upgrade Module

If you want to upgrade the ViaBill Payment Module, there are two methods to do that, which are explained below.

Upgrade via Composer

This method is recommended if you have installed the ViaBill module using the Composer.

1. Log in to your server with SSH and go to the Magento 2 root folder.

2.  Enter the command: composer update viabillhq/module-payment

3. Enter the command: php bin/magento setup:upgrade

4. Enter the command: php bin/magento setup:di:compile

5. Enter the command: php bin/magento setup:static-content:deploy -f

6. Enter the command: php bin/magento cache:flush

7. Enter the command: php bin/magento indexer:reindex

Upgrade manually

This method is recommended only if you have not installed the module via Composer.

1. Download the module files from a public repository

2. Copy the contents of the viabillhq/module-payment folder into the existing folder, which can be one of the following: {magento 2 root folder}/app/code/Viabillhq/Payment or {magento 2 root folder}/vendor/viabillhq/module-payment

3. Log in to your server with SSH and go to the Magento 2 root folder.

4. Enter the command: php bin/magento setup:upgrade

5. Enter the command: php bin/magento setup:di:compile

6. Enter the command: php bin/magento setup:static-content:deploy -f

7. Enter the command: php bin/magento cache:flush

8.  Enter the command: php bin/magento indexer:reindex

Disable Module

If you wish disable the ViaBill module without uninstalling it, you can simply go to the module configuration page by navigating to Stores -> Configuration -> Sales -> Payment Methods and inside the ViaBill Module Configuration set the “Enable” parameter to No.

You mean need to clear the Magento 2 cache to see the changes in the front-end.

Uninstall Module

If you want to completely remove the ViaBill module you will need shell access. More specifically:

1. Log in to your server with SSH and go to the Magento 2 root folder.

2.    Enter the command: php bin/magento module:disable Viabillhq_Payment --clear-static-content

3. Enter the command: php bin/magento setup:upgrade

4. Enter the command: uninstall -r Viabillhq_Payment

Troubleshooting and Support

ViaBill Module Support

If you are experiencing any technical issues, please navigate to Stores -> Configuration -> Sales -> Payment Methods and under the ViaBill Module Configuration section set the Debug Mode parameter to “Developer”. Then try to replicate your issue by repeating the action which caused it. Finally, click on the “Contact Form” link that you will find under the ViaBill Module Info section. Fill out the form and submit it to our technical support team. This contact form is auto-populated with vital information that will help us to resolve your issue faster.

Alternatively, contact us via email at tech@viabill.com

Before you contact us make sure that the module is enabled and the #__setup_module database table is populated with the Viabillhq_Payment entry. If not, insert it manually using the following SQL statement:

INSERT INTO `#__setup_module` (`module`, `schema_version`, `data_version`) VALUES ('Viabillhq_Payment', '0.0.3', '0.0.3');

Please note that #_ is the database prefix and it should be replaced with the actual prefix, if present. If the  Viabillhq_Payment entry is missing from the setup module table, you will see an error in your log file similar to:

The following modules are outdated:

Viabillhq_Payment schema: current version - none, required version - 0.0.3 

Viabillhq_Payment data: current version - none, required version - 0.0.3 [] []

Magento Support

 

•        Magento is an open-source eCommerce solution: https://magento.com

•        Magento Inc is an Adobe company: https://magento.com/about

•        For Magento support, see Magento Help Center: https://support.magento.com/hc/en-us

How did we do?

WooCommerce

PrestaShop

Contact