PLUGIN DOWNLOAD

Download the latest version of the plugin from the website: https://github.com/comfino/PrestaShop/releases

INSTALLATION

On-line version of the documentation: https://comfino.pl/plugins/PrestaShop/en

PrestaShop 1.6

To install the module, please go to "Modules -> Modules and services" tab and then click "Add new module" button, then panel with "Module file" input should appear. In this input choose module's file and click "Send module button". If the module was uploaded, then it should be visible on modules list. Then you should just choose the module and click "Install" button.

PrestaShop 1.7, PrestaShop 8

To install the module, please go to "Modules -> Modules Manager" tab, and then click "Upload module" button. To the field that appears, put module's file. Module will be installed automatically.

CONFIGURATION

The configuration parameters of the module are grouped by categories corresponding to the tabs of the configuration panel: "PAYMENT SETTINGS", "SALE SETTINGS", "WIDGET SETTINGS", "DEVELOPER SETTINGS". The last tab "PLUGIN DIAGNOSTICS" does not contain any parameters to be set and has an information-diagnostic function. Among other things, it contains a local error log.

Before using Comfino payments, the module must be configured. You can do this by clicking "Configure" in the module info panel.

The most important field that must be filled in is the "Production Environment API Key" field from the "PAYMENT SETTINGS" tab. In the "DEVELOPER SETTINGS" tab, there is a second key field - "Test environment API key".

Configuration parameter fields:

PAYMENT SETTINGS

• Production environment API key — a unique access key that allows the module to communicate with the Comfino API (you will receive it from a Comfino representative)
• Payment presentation — the way Comfino is presented on the list of payment methods [Only icon, Only text, Icon and text]
• Payment text — text displayed on the list of payment methods (default "(Raty | Kup Teraz, Zapłać Póżniej | Finansowanie dla Firm)")
• Minimal amount in cart — the value of the cart from which Comfino payment is available (default: 30 PLN)

SALE SETTINGS

The tab contains settings related to sales management.

Financial product availability rules (product category filters) enable Comfino payments to be assigned to specific product categories. Category filters are divided into sections corresponding to available methods of financing purchases under the contract concluded with Comfino. Moreover, managing the availability of Comfino payments is only possible for the following types of financial products: "Zero percent installments", "Pay later". If the concluded contract does not include one or all of these items, the tab will contain a list of trees limited to this one financing method or it will contain a list of trees for other types of products from the contract, if the contract does not include the "Zero percent installments" and "Pay later" products.

By default, Comfino payments are available unconditionally for all product types. To disable Comfino for selected product types, uncheck the appropriate categories in the category tree for each type of financial offer and click "Save".

WIDGET SETTINGS

Basic Settings

• Widget is active? — promotional widget activation/deactivation switch on the product page
• Widget type — way of presenting the widget [Textual widget, Graphical widget with banner, Graphical widget with installments calculator , Graphical widget with extended installments calculator]
• Offer type — type of financing offer promoted [Zero percent installments, Convenient installments, Pay later, Deferred payments for companies]

The availability of offer types on the list depends on the individual contract and may differ from that described in the documentation.

Advanced settings

• Widget price element selector — HTML document element containing the price of the product
• Widget anchor element selector — widget container element (widget is embedded in it)
• Price change detection — container selector — HTML document element containing a price element directly or indirectly used to track price changes and recalculate offers
• Price change detection — container hierarchy level — DOM hierarchy level used to track price changes and recalculate offers
• Embedding method — how the widget is oriented relative to the container element [INSERT_INTO_FIRST, INSERT_INTO_LAST, INSERT_BEFORE, INSERT_AFTER]
• Widget initialization code — JavaScript script to initialize the widget on the product page (making changes not recommended for non-advanced users without JavaScript knowledge)

Detailed information on the operation of the widget and its configuration options can be found in a separate Comfino widget documentation.

DEVELOPER SETTINGS

• Use test environment — developer mode activation/deactivation switch
• Test environment API key — a unique access key enabling the module to communicate with the Comfino test API

Note

Before launching payments on the production store, disable developer mode to block the use of the Comfino payment test environment.

PLUGIN DIAGNOSTICS

The tab contains technical information about the plugin and the environment (plugin version, store version, PHP and web server version, etc.).
It also contains a list of recent errors with a preview of the local error log.

Information about developer mode activity is displayed in the tabs "PAYMENT SETTINGS" and "PLUGIN DIAGNOSTICS". In this mode, the plugin uses the key from the "DEVELOPER SETTINGS" tab to communicate with the Comfino test API. You will also receive a test environment key from a Comfino representative.

REMARKS

• The Comfino payment module requires you to set the customer's phone number as required in the process of entering the customer's contact details. The phone number is used to send codes and inform the customer about the status of the transaction, at a later stage of Comfino payment processing. In case of absence of a telephone number, the Comfino payment transaction will end with an error displayed on the store's website.
• The module notification system requires the availability of the HTTP "PUT" method. The module receives information about changes in the status of Comfino transactions and changes the internal order status in PrestaShop accordingly. In case of problems with notifications, check the web server settings in your hosting panel.
• Customer and order data required by the Comfino module:
  • Customer:
    • first name - 2-63 characters
    • last name - 2-63 characters
    • email address - valid e-mail address
    • valid Polish mobile phone number (expected format: xxxxxxxxx, xxx xxx xxx, +48 xxxxxxxxx).
  • Cart:
    • total amount
    • list of products
      • name
      • quantity
      • price
  • Address:
    • street
    • building number
    • apartment number
    • postal code
    • city
    • country code

SAMPLE CART VIEW WITH A LIST OF PAYMENT METHODS

COMFINO PROCESS FLOW