LHV Wallet Plugins

Introduction

Overview of the LHV Wallet Plugin

The LHV Wallet plugins allow seamless integration of LHV payment methods into WooCommerce, OpenCart and Prestashop powered webshops.

Purpose and benefits of using the LHV Wallet plugin

The purpose of the LHV Wallet plugin is to integrate all LHV provided payment methods into a single plugin. This simplifies the process for merchants, requiring them only to add one plugin to enable all the functionalities.

LHV Wallet plugin is designed with a focus on UX and UI best practices. Aim is to provide a seamless checkout experience for webshops that distinguishes itself from others. LHV Wallet includes support for open banking bank links, card payments, instalments (BNPL), and hire-purchase options.

To get started, select your platform below to download and view the step-by-step installation guide for the LHV Wallet plugin:

For more information about setting up your store and activating LHV Wallet, contact us at makselahendused@lhv.ee.

For a general overview, please see: LHV Wallet.

LHV Wallet WooCommerce Plugin

Introduction

Overview of the LHV Wallet WooCommerce plugin

The LHV Wallet WooCommerce plugin seamlessly integrates the LHV Wallet payment method into WooCommerce-powered webshops.

Purpose and benefits of using the plugin

The purpose of the LHV Wallet plugin is to integrate various popular payment methods into a single plugin and contract. This simplifies the process for merchants, requiring them only to add an API key to the plugin to enable all functionalities.

Our plugin is designed with a focus on UX and UI best practices. We aim to provide a seamless checkout experience for webshops that distinguishes itself from other payment providers. Our solution includes support for bank links, card payments, instalments, and hire-purchase options.

By centralizing these features, we anticipate that our customers will appreciate the convenience and effectiveness of our plugin.

Target audience

The LHV Wallet plugin is tailored for small and medium-sized companies that require straightforward payment methods. While larger webshops typically have custom-made solutions and may not utilize WordPress, our plugin is designed to meet the needs of smaller businesses seeking simplicity and efficiency in payment processing.

Download

By using this plugin I confirm that I have reviewed the terms of use for LHV Wallet and agree to them.

Download plugin

Installation

System requirements

To ensure compatibility and optimal performance of the LHV Wallet plugin, please ensure your system meets the following requirements:

  • WordPress version: at least 6.5.4*
  • WooCommerce version: 9.0.2 *
  • PHP version: 8.3.9 or higher
  • CURL extension in server is required (tested with version 8.4.0, OpenSSL/1.1.1w)

These requirements are necessary for seamless integration and functionality of the LHV Wallet plugin within your WordPress environment. Compatibility with older and newer versions of WordPress and WooCommerce will be validated with each new plugin release.

  • Compatibility with older versions if Wordpress and WooCommerce may be possible; check compatibility with newer plugin releases.

Obtaining API credentials

Installation process (step-by-step guide)

Follow these steps to install the LHV Wallet plugin on your WordPress site manually:

  1. Download the Plugin:

  2. Access WordPress Admin Dashboard:

    • Log in to your WordPress admin area.
  3. Navigate to Plugins Section:

    • In the WordPress admin menu, go to Plugins > Add New.
  4. Upload Plugin:

    • Click on the Upload Plugin button at the top of the page.
  5. Choose File:

    • Click the Choose File button and select the plugin ZIP file you downloaded earlier.
  6. Upload and Install:

    • After selecting the file, click Install Now.
  7. Activate Plugin:

    • Once the plugin is installed successfully, click on Activate Plugin.
  8. Plugin Activation and Setup:

    • Navigate to WooCommerce > Settings > Payments.
    • Find LHV Wallet in the list of available payment methods and click on it.
    • Configure the plugin settings, entering your API Key and filling out any required fields.
    • Enable the plugin by checking the box next to Enable.
  9. Verification:

    • After activation, verify that the plugin is functioning correctly by navigating to Plugins > Installed Plugins and checking for the LHV Wallet plugin in the list.
    • Navigate to WooCommerce > Settings > Payments and check if Enabled toggle icon is activated after LHV Wallet
  10. Testing:

    • Perform a test transaction to ensure that payments through LHV Wallet are processed correctly on your website.

Using the Plugin

Overview of features provided by the plugin

The LHV Wallet plugin enhances checkout process with the following features:

  • The LHV Wallet plugin introduces a new payment method tailored specifically for LHV Wallet during checkout. It offers customers three distinct options:

    • Kogu summa (Total Amount): Allows customers to pay the entire sum at once.

      • Provides access to activated bank links with the option to select different countries for bank payments.
    • Osamakse (Instalment Payment): Provides customers with the option to pay in instalments.

      • Details and information information provided in plugin
    • Järelmaks (Hire-purchase): Enables customers to use LHV Finance for hire-purchase options.

      • Details and information information provided in plugin. This payment method requires a contract with LHV Finance

    This integration enhances flexibility and convenience during the checkout process, catering to various payment preferences and needs of your customers seamlessly.

  • Enhanced checkout experience: Utilizes a JavaScript solution hosted on LHV's servers to render the checkout page graphically. This approach allows for seamless integration of visual updates and new features without requiring a plugin update.

  • Dynamic payment method Display: Displays payment methods based on the current cart total amount. This ensures that customers see relevant payment options appropriate for their purchase amount.

How transactions are processed

Once the customer selects their preferred payment method and places the order, the transaction processing proceeds as follows:

  1. Order placement: The customer completes the checkout process by placing the order on website.

  2. Transaction data submission: The LHV Wallet plugin then sends transaction data to the bank via API. This data includes the checkout total sum and the order number.

  3. Redirect to payment provider: Depending on the chosen payment method, the system redirects the customer to the payment provider payment portal to complete the transaction.

  4. Data privacy: The plugin ensures privacy by transmitting only essential transaction details—checkout total sum and order number—to the bank. No personal data is transmitted or stored beyond what is necessary for transaction completion.

This streamlined process ensures secure and efficient transaction handling while maintaining customer privacy and data security.

Integration with WooCommerce

Mapping of LHV Wallet features to WooCommerce functionalities

Plugins us using WooCommere functionalities and here is what we do

  • Error Logging:

    • Utilizes WooCommerce's built-in error logging system located under WooCommerce > Status > Logs for tracking and troubleshooting purposes.
  • Inventory Management:

    • After order placement, the plugin automatically reduces stock levels and empties the customer's cart to ensure accurate inventory management.

Customization options

Currently, the LHV Wallet plugin offers the following customization option:

  • Payment methods display: Merchants can choose between list or grid mode for displaying payment methods during checkout. There is checkbox with value Display payment methods vertically

    This means

    • List Mode: Displays payment methods in a vertical list format. (fixed)
    • Grid Mode: Displays payment methods horizontally, suitable for wider webshop designs.
  • Additional Customizations: If further modifications are required, such as CSS changes for styling adjustments, merchants have the flexibility to overwrite styling rules within their themes.

    • Note: The plugin does not currently support including additional assets within its package.

These customization options provide flexibility to adapt the checkout experience to different webshop designs and allow for further customization through theme-specific styling adjustments.

Order Management

How orders are managed with LHV Wallet payments

After a customer places an order, the LHV Wallet plugin performs the following actions:

  • Adds the selected payment method to the order and sets the order status to Pending Payment, providing visibility to the merchant regarding the order's current status.

  • Updates the order status based on responses received from the payment provider regarding the payment status.

  • Front-end messages are provided to inform customers about the success, initiation, or failure of their payment.

  • If a payment is canceled or fails, customers are required to start a new order as our system API rules does not allow changing the payment method post-cancellation or failure.

  • Order Status Mapping:

    • INITIATED: Status set to Pending
    • SUCCESSFUL: Status set to Processing
    • FAILED: Status set to Failed

    Hire-purchase

    • CONTRACT_SIGNED: Status set to Processing
    • CONTRACT_REJECTED: Status set to Failed
  • Order Notes:

    • Internal comments are added to orders corresponding to each status update to provide clarity and context.
  • Saved Payment Method:

    • The selected payment method is saved to the order upon placement for redirect purposes and record-keeping.

Handling refunds and cancellations through WooCommerce

Currently, refunds and cancellations directly through WooCommerce are not supported by our API system. However, this functionality may be considered for future updates.

For refund processes, merchants are advised to contact the bank directly. The Merchant Portal provided by the bank may offer options for managing refunds and cancellations effectively.

Troubleshooting

Known Issues

  • API Error: The order reference '140' has already been successfully paid

    • This error indicates that there is a previous order with the same order reference that has already been successfully paid.

    • Possible causes include:

      • Number series reset in the webshop or a new webshop installation where order numbers start again.
      • Multiple webshops connected using the same API key.
    • To resolve this issue:

      • Ensure that order references are unique for each transaction.
      • Verify that no previous orders with the same order reference have been successfully processed.
      • If using multiple webshops with the same API key, ensure order references do not overlap across different installations.

Error messages and their meanings

At present, we do not have a predefined list of error codes. Errors encountered are stored with descriptions as they occur. In the future, we aim to provide a comprehensive list of error codes along with detailed descriptions.

For troubleshooting purposes, please refer to error messages displayed in your system or logs, which include specific descriptions of encountered issues. This approach allows for efficient resolution of errors based on their detailed descriptions.

Where to find support or additional help

Currently, we do not have a dedicated support page or FAQ available.

For support inquiries or additional assistance, please contact us via email at makselahendused@lhv.ee.

Testing

Setting up a testing environment

Currently, we do not provide a public testing environment.

If testing is required, please contact us directly at makselahendused@lhv.ee. We can provide test credentials and endpoints to facilitate your testing process.

Best practices for testing before going live

  • Create test payment:

    • Create a test product with a nominal price (e.g., 0.01 EUR) within your WooCommerce store.
    • Place an order using this test product to simulate a payment transaction.
  • Verify payment process:

    • Ensure that the checkout process functions correctly with the LHV Wallet plugin enabled.
    • Test different payment methods offered by the plugin to verify their functionality.
  • Check order status and notes:

    • Review the order status and any notes added by the plugin during the transaction process.
    • Confirm that the order status updates correctly based on the payment response received from LHV Wallet.
  • Test error handling:

    • Intentionally trigger errors (if possible) to observe how the plugin handles various scenarios.
    • Verify that error messages are clear and provide actionable information for troubleshooting.
  • Validate data transmission:

    • Ensure that only necessary transaction data, such as order total and order number, is transmitted securely to LHV Wallet.
    • Confirm that no sensitive customer information is exposed or stored beyond what is required for transaction processing.
  • Review logs and error messages:

    • Check WooCommerce logs (if applicable) or any error messages displayed during testing to identify and address any issues encountered.

For the general overview, please see: LHV Wallet

LHV Wallet Opencart Plugin

Introduction

Overview of the LHV Wallet Opencart plugin

The LHV Wallet Opencart plugin seamlessly integrates the LHV Wallet payment method into Opencart-powered webshops.

Purpose and benefits of using the plugin

The purpose of the LHV Wallet plugin is to integrate various popular payment methods into a single plugin and contract. This simplifies the process for merchants, requiring them only to add an API key to the plugin to enable all functionalities.

Our plugin is designed with a focus on UX and UI best practices. We aim to provide a seamless checkout experience for webshops that distinguishes itself from other payment providers. Our solution includes support for bank links, card payments, instalments, and hire-purchase options.

By centralizing these features, we anticipate that our customers will appreciate the convenience and effectiveness of our plugin.

Target audience

The LHV Wallet plugin is tailored for small and medium-sized companies that require straightforward payment methods. While larger webshops typically have custom-made solutions and may not utilize WordPress, our plugin is designed to meet the needs of smaller businesses seeking simplicity and efficiency in payment processing.

Download

By using this plugin I confirm that I have reviewed the terms of use for LHV Wallet and agree to them.

Download plugin

Installation

System requirements

To ensure compatibility and optimal performance of the LHV Wallet plugin, please ensure your system meets the following requirements:

  • OpenCart version: 4.0.2.3 *
  • PHP version: 8.3.9 or higher
  • CURL extension in server is required (tested with version 8.4.0, OpenSSL/1.1.1w)

These requirements are necessary for seamless integration and functionality of the LHV Wallet plugin within your Opencart environment. Compatibility with older and newer versions of Opencart (4.0.2.x) and Opencart will be validated with each new plugin release.

  • Compatibility with older versions if Opencart may be possible; check compatibility with newer plugin releases)

Obtaining API credentials

Installation process (step-by-step guide)

Follow these steps to install the LHV Wallet plugin on your Opencart site manually:

  1. Download the Extension

  2. Access OpenCart Admin Dashboard

    • Log in to your OpenCart admin area.
  3. Navigate to Extensions Section

    • In the OpenCart admin menu, go to Extensions > Installer.
  4. Upload the Extension

    • Click the Upload button at the top right of the page.
  5. Choose File

    • Click the Choose File button and select the extension ZIP file you downloaded earlier.
  6. Upload and Install

    • After selecting the file, the upload process will begin automatically. Once the upload is complete, navigate to Extensions > Extensions and select Payments from the dropdown menu.
    • Find LHV Wallet in the list and click the Install button next to it.
  7. Configure the Extension

    • After installation, click the Edit button next to the LHV Wallet extension in the Extensions > Extensions page under the Payments filter.
    • Enter your API Key and any other required fields in the configuration form.
    • Save the configuration settings.
  8. Enable the Payment Method

    • In the configuration page, ensure the Status is set to Enabled.
    • Click the Save button to apply the changes.
  9. Verification

    • After activation, verify that the extension is functioning correctly:
    • Navigate to Extensions > Extensions and ensure the LHV Wallet extension is listed and active under the Payments filter.
    • Navigate to Extensions > Payments and check if the Status toggle is set to Enabled for LHV Wallet.
  10. Testing

    • Perform a test transaction to ensure that payments through LHV Wallet are processed correctly on your website.
    • Navigate to your store's front-end, add a product to the cart, proceed to checkout, and select LHV Wallet as the payment method to complete the transaction.

Using the Plugin

Overview of features provided by the plugin

The LHV Wallet plugin enhances checkout process with the following features:

  • The LHV Wallet plugin introduces a new payment method tailored specifically for LHV Wallet during checkout. It offers customers three distinct options:

    • Kogu summa (Total Amount): Allows customers to pay the entire sum at once.

      • Provides access to activated bank links with the option to select different countries for bank payments.
    • Osamakse (Instalment Payment): Provides customers with the option to pay in instalments.

    • Details and information information provided in plugin

    • Järelmaks (Hire-purchase): Enables customers to use LHV Finance for hire-purchase options.

      • Details and information information provided in plugin. This payment method requires a contract with LHV Finance

    This integration enhances flexibility and convenience during the checkout process, catering to various payment preferences and needs of your customers seamlessly.

  • Enhanced checkout experience: Utilizes a JavaScript solution hosted on LHV's servers to render the checkout page graphically. This approach allows for seamless integration of visual updates and new features without requiring a plugin update.

  • Dynamic payment method Display: Displays payment methods based on the current cart total amount. This ensures that customers see relevant payment options appropriate for their purchase amount.

How transactions are processed

Once the customer selects their preferred payment method and places the order, the transaction processing proceeds as follows:

  1. Order placement: The customer completes the checkout process by placing the order on website.

  2. Transaction data submission: The LHV Wallet plugin then sends transaction data to the bank via API. This data includes the checkout total sum and the order number.

  3. Redirect to payment provider: Depending on the chosen payment method, the system redirects the customer to the payment provider payment portal to complete the transaction.

  4. Data privacy: The plugin ensures privacy by transmitting only essential transaction details—checkout total sum and order number—to the bank. No personal data is transmitted or stored beyond what is necessary for transaction completion.

This streamlined process ensures secure and efficient transaction handling while maintaining customer privacy and data security.

Integration with Opencart

Mapping of LHV Wallet features to Opencart functionalities

Plugins us using Opencart functionalities and here is what we do

  • Error Logging:

    • Utilizes Opencart built-in error logging system located under System>Maintenace>Error Logs for tracking and troubleshooting purposes.
  • Inventory Management:

    • After order placement, the plugin automatically reduces stock levels and empties the customer's cart to ensure accurate inventory management.

Customization options

Currently, the LHV Wallet plugin offers the following customization option:

  • Payment methods display: Merchants can choose between list or grid mode for displaying payment methods during checkout. There is checkbox with value Display payment methods vertically

    This means

    • List Mode: Displays payment methods in a vertical list format. (fixed)
    • Grid Mode: Displays payment methods horizontally, suitable for wider webshop designs.
  • Additional Customizations: If further modifications are required, such as CSS changes for styling adjustments, merchants have the flexibility to overwrite styling rules within their themes.

    • Note: The plugin does not currently support including additional assets within its package.

These customization options provide flexibility to adapt the checkout experience to different webshop designs and allow for further customization through theme-specific styling adjustments.

Order Management

How orders are managed with LHV Wallet payments

After a customer places an order, the LHV Wallet plugin performs the following actions:

  • Updates the order status based on responses received from the payment provider regarding the payment status.

  • Front-end messages are provided to inform customers about the success, initiation, or failure of their payment.

  • If a payment is canceled or fails, customers are required to start a new order as our system API rules does not allow changing the payment method post-cancellation or failure.

  • Order Status Mapping:

    • INITIATED: Status set to Processing
    • SUCCESSFUL: Status set to Processed
    • FAILED: Status set to Denied

    Hire-purchase

    • CONTRACT_SIGNED: Status set to Processed
    • CONTRACT_REJECTED: Status set to Denied

Handling refunds and cancellations through Opencart

Currently, refunds and cancellations directly through Opencart are not supported by our API system. However, this functionality may be considered for future updates.

For refund processes, merchants are advised to contact the bank directly. The Merchant Portal provided by the bank may offer options for managing refunds and cancellations effectively.

Troubleshooting

Known Issues

  • API Error: The order reference '140' has already been successfully paid

    • This error indicates that there is a previous order with the same order reference that has already been successfully paid.

    • Possible causes include:

      • Number series reset in the webshop or a new webshop installation where order numbers start again.
      • Multiple webshops connected using the same API key.
    • To resolve this issue:

      • Ensure that order references are unique for each transaction.
      • Verify that no previous orders with the same order reference have been successfully processed.
      • If using multiple webshops with the same API key, ensure order references do not overlap across different installations.

Error messages and their meanings

At present, we do not have a predefined list of error codes. Errors encountered are stored with descriptions as they occur. In the future, we aim to provide a comprehensive list of error codes along with detailed descriptions.

For troubleshooting purposes, please refer to error messages displayed in your system or logs, which include specific descriptions of encountered issues. This approach allows for efficient resolution of errors based on their detailed descriptions.

Where to find support or additional help

Currently, we do not have a dedicated support page or FAQ available.

For support inquiries or additional assistance, please contact us via email at makselahendused@lhv.ee.

Testing

Setting up a testing environment

Currently, we do not provide a public testing environment.

If testing is required, please contact us directly at makselahendused@lhv.ee. We can provide test credentials and endpoints to facilitate your testing process.

Best practices for testing before going live

  • Create test payment:

    • Create a test product with a nominal price (e.g., 0.01 EUR) within your Opencart store.
    • Place an order using this test product to simulate a payment transaction.
  • Verify payment process:

    • Ensure that the checkout process functions correctly with the LHV Wallet plugin enabled.
    • Test different payment methods offered by the plugin to verify their functionality.
  • Check order status and notes:

    • Review the order status and any notes added by the plugin during the transaction process.
    • Confirm that the order status updates correctly based on the payment response received from LHV Wallet.
  • Test error handling:

    • Intentionally trigger errors (if possible) to observe how the plugin handles various scenarios.
    • Verify that error messages are clear and provide actionable information for troubleshooting.
  • Validate data transmission:

    • Ensure that only necessary transaction data, such as order total and order number, is transmitted securely to LHV Wallet.
    • Confirm that no sensitive customer information is exposed or stored beyond what is required for transaction processing.
  • Review logs and error messages:

    • Check Opencart logs (if applicable) or any error messages displayed during testing to identify and address any issues encountered.

LHV Wallet Prestashop Plugin

Introduction

Overview of the LHV Wallet Prestashop plugin

The LHV Wallet Prestashop plugin seamlessly integrates the LHV Wallet payment method into Prestashop-powered webshops.

Purpose and benefits of using the plugin

The purpose of the LHV Wallet plugin is to integrate various popular payment methods into a single plugin and contract. This simplifies the process for merchants, requiring them only to add an API key to the plugin to enable all functionalities.

Our plugin is designed with a focus on UX and UI best practices. We aim to provide a seamless checkout experience for webshops that distinguishes itself from other payment providers. Our solution includes support for bank links, card payments, instalments, and hire-purchase options.

By centralizing these features, we anticipate that our customers will appreciate the convenience and effectiveness of our plugin.

Target audience

The LHV Wallet plugin is tailored for small and medium-sized companies that require straightforward payment methods. While larger webshops typically have custom-made solutions and may not utilize WordPress, our plugin is designed to meet the needs of smaller businesses seeking simplicity and efficiency in payment processing.

Download

By using this plugin I confirm that I have reviewed the terms of use for LHV Wallet and agree to them.

Download plugin

Installation

System requirements

To ensure compatibility and optimal performance of the LHV Wallet plugin, please ensure your system meets the following requirements:

  • Prestashop version: 8.1.6 *
  • PHP version: 8.3.9 or higher
  • CURL extension in server is required (tested with version 8.4.0, OpenSSL/1.1.1w)

These requirements are necessary for seamless integration and functionality of the LHV Wallet plugin within your Prestashop environment. Compatibility with older and newer versions of Prestashop (1.8.x) and Prestashop will be validated with each new plugin release.

  • Compatibility with older versions if Prestashop may be possible; check compatibility with newer plugin releases)

Obtaining API credentials

Installation process (step-by-step guide)

Follow these steps to install the LHV Wallet plugin on your Prestashop site manually:

  1. Download the Module

  2. Access PrestaShop Admin Dashboard

    • Log in to your PrestaShop admin area.
  3. Navigate to Modules Section

    • In the PrestaShop admin menu, go to Modules > Module Manager.
  4. Upload the Module

    • Click on the Upload a module button at the top right of the page.
  5. Choose File

    • Click the Select file button and select the module ZIP file you downloaded earlier.
  6. Upload and Install

    • After selecting the file, the upload and installation process will begin automatically. Wait for it to complete.
  7. Activate the Module

    • Once the module is installed successfully, you will see it listed in the Module Manager.
    • Click the Configure button next to the LHV Wallet module to open its configuration page.
  8. Configure the Module

    • Enter your API Key and any other required fields in the configuration form.
    • Save the configuration settings.
  9. Verification

    • After configuration, verify that the module is functioning correctly:
    • Navigate to Modules > Module Manager and check that the LHV Wallet module is listed and active.
    • Navigate to Payment > Payment Methods and ensure the Enabled toggle is activated for LHV Wallet.
  10. Testing

    • Perform a test transaction to ensure that payments through LHV Wallet are processed correctly on your website.

    • Navigate to your store's front-end, add a product to the cart, proceed to checkout, and select LHV Wallet as the payment method to complete the transaction.

Using the Plugin

Overview of features provided by the plugin

The LHV Wallet plugin enhances checkout process with the following features:

  • The LHV Wallet plugin introduces a new payment method tailored specifically for LHV Wallet during checkout. It offers customers three distinct options:

    • Kogu summa (Total Amount): Allows customers to pay the entire sum at once.

      • Provides access to activated bank links with the option to select different countries for bank payments.
    • Osamakse (Instalment Payment): Provides customers with the option to pay in instalments.

      • Details and information information provided in plugin
    • Järelmaks (Hire-purchase): Enables customers to use LHV Finance for hire-purchase options.

      • Details and information information provided in plugin. This payment method requires a contract with LHV Finance

    This integration enhances flexibility and convenience during the checkout process, catering to various payment preferences and needs of your customers seamlessly.

  • Enhanced checkout experience: Utilizes a JavaScript solution hosted on LHV's servers to render the checkout page graphically. This approach allows for seamless integration of visual updates and new features without requiring a plugin update.

  • Dynamic payment method Display: Displays payment methods based on the current cart total amount. This ensures that customers see relevant payment options appropriate for their purchase amount.

How transactions are processed

Once the customer selects their preferred payment method and places the order, the transaction processing proceeds as follows:

  1. Order placement: The customer completes the checkout process by placing the order on website.

  2. Transaction data submission: The LHV Wallet plugin then sends transaction data to the bank via API. This data includes the checkout total sum and the order number.

  3. Redirect to payment provider: Depending on the chosen payment method, the system redirects the customer to the payment provider payment portal to complete the transaction.

  4. Data privacy: The plugin ensures privacy by transmitting only essential transaction details—checkout total sum and order number—to the bank. No personal data is transmitted or stored beyond what is necessary for transaction completion.

This streamlined process ensures secure and efficient transaction handling while maintaining customer privacy and data security.

Integration with Prestashop

Mapping of LHV Wallet features to Prestashop functionalities

Plugins us using WooCommere functionalities and here is what we do

  • Error Logging:

    • Utilizes Prestashop's built-in error logging system located under Advanced parameters> Logs for tracking and troubleshooting purposes.
  • Inventory Management:

    • After order placement, the plugin automatically reduces stock levels and empties the customer's cart to ensure accurate inventory management.

Customization options

Currently, the LHV Wallet plugin offers the following customization option:

  • Payment methods display: Merchants can choose between list or grid mode for displaying payment methods during checkout. There is checkbox with value Display payment methods vertically

    This means

    • List Mode: Displays payment methods in a vertical list format. (fixed)
    • Grid Mode: Displays payment methods horizontally, suitable for wider webshop designs.
  • Additional Customizations: If further modifications are required, such as CSS changes for styling adjustments, merchants have the flexibility to overwrite styling rules within their themes.

    • Note: The plugin does not currently support including additional assets within its package.

These customization options provide flexibility to adapt the checkout experience to different webshop designs and allow for further customization through theme-specific styling adjustments.

Order Management

How orders are managed with LHV Wallet payments

After a customer places an order, the LHV Wallet plugin performs the following actions:

  • Adds the selected payment method to the order and sets the order status to Pending Payment, providing visibility to the merchant regarding the order's current status.

  • Updates the order status based on responses received from the payment provider regarding the payment status.

  • Front-end messages are provided to inform customers about the success, initiation, or failure of their payment.

  • If a payment is canceled or fails, customers are required to start a new order as our system API rules does not allow changing the payment method post-cancellation or failure.

  • Order Status Mapping:

    • INITIATED: Status set to Awaiting bank wire payment
    • SUCCESSFUL: Status set to Payment accepted
    • FAILED: Status set to Payment error

    Hire-purchase

    • CONTRACT_SIGNED: Status set to Payment accepted
    • CONTRACT_REJECTED: Status set to Payment error

Handling refunds and cancellations through Prestashop

Currently, refunds and cancellations directly through Prestashop are not supported by our API system. However, this functionality may be considered for future updates.

For refund processes, merchants are advised to contact the bank directly. The Merchant Portal provided by the bank may offer options for managing refunds and cancellations effectively.

Troubleshooting

Known Issues

  • API Error: The order reference '140' has already been successfully paid

    • This error indicates that there is a previous order with the same order reference that has already been successfully paid.

    • Possible causes include:

      • Number series reset in the webshop or a new webshop installation where order numbers start again.
      • Multiple webshops connected using the same API key.
    • To resolve this issue:

      • Ensure that order references are unique for each transaction.
      • Verify that no previous orders with the same order reference have been successfully processed.
      • If using multiple webshops with the same API key, ensure order references do not overlap across different installations.

Error messages and their meanings

At present, we do not have a predefined list of error codes. Errors encountered are stored with descriptions as they occur. In the future, we aim to provide a comprehensive list of error codes along with detailed descriptions.

For troubleshooting purposes, please refer to error messages displayed in your system or logs, which include specific descriptions of encountered issues. This approach allows for efficient resolution of errors based on their detailed descriptions.

Where to find support or additional help

Currently, we do not have a dedicated support page or FAQ available.

For support inquiries or additional assistance, please contact us via email at makselahendused@lhv.ee.

Testing

Setting up a testing environment

Currently, we do not provide a public testing environment.

If testing is required, please contact us directly at makselahendused@lhv.ee. We can provide test credentials and endpoints to facilitate your testing process.

Best practices for testing before going live

  • Create test payment:

    • Create a test product with a nominal price (e.g., 0.01 EUR) within your Prestashop store.
    • Place an order using this test product to simulate a payment transaction.
  • Verify payment process:

    • Ensure that the checkout process functions correctly with the LHV Wallet plugin enabled.
    • Test different payment methods offered by the plugin to verify their functionality.
  • Check order status and notes:

    • Review the order status and any notes added by the plugin during the transaction process.
    • Confirm that the order status updates correctly based on the payment response received from LHV Wallet.
  • Test error handling:

    • Intentionally trigger errors (if possible) to observe how the plugin handles various scenarios.
    • Verify that error messages are clear and provide actionable information for troubleshooting.
  • Validate data transmission:

    • Ensure that only necessary transaction data, such as order total and order number, is transmitted securely to LHV Wallet.
    • Confirm that no sensitive customer information is exposed or stored beyond what is required for transaction processing.
  • Review logs and error messages:

    • Check Prestashop logs (if applicable) or any error messages displayed during testing to identify and address any issues encountered.