The Hygglig Checkout gateway module is a plugin that extends Opencart. It allows you as a merchant to have only one payment integration, and your customers to pay with the payment method of their choice. Hygglig Checkout is at the moment only available in Sweden.

General information

When the order is passed to Hygglig, a credit record of the customer is made. The customer will then be presented with different payment methods, depending on how the check turns out. When the customer finalize the purchase, Hygglig creates an invoice in their system and sets the order in Opencart as ‘Processed’. After you (as the merchant) complete the order in Opencart, you need to approve/send the invoice in Hygglig system as well. You can choose to do that either by logging in to Hygglig Merchant web, or by stating that the order is to be automatically approved/sent in Hygglig when a status of your choice is set in the Settings for the Hygglig Checkout module in Home / Modules / Hygglig Checkout. More on that in Configuration below.

Installation

To install Hygglig Checkout module for Opencart you need to download the latest zip from Hygglig website, unzip it and manualy upload the module via FTP to your Opencart installation.

  1. Download the latest release of the Hygglig Checkout module for Opencart.
  2. Unpack the zip file, open the folder and locate folders admin and catalog.
  3. Navigate via your FTP client to the root folder of your Opencart installation and upload the two folders admin and catalog there. The folders you copy should be merged with the ones already there. Nothing should be overwritten.
  4. Go to Opencart Modules, and in the modules list click install button on Hygglig Checkout.

Configuration

Before you start you should contact Hygglig who will send you login for Hygglig merchant web (Hygglig Handlarwebb) and the Merchant ID and Secret Key needed for Hygglig Checkout module.

The quick start instruction: Enter the keys for EID and secret, enable Test mode if it’s test keys, choose what statuses will trigger action in Hegglig Handlarwebb. Done.

The more detailed instruction:

  1. Navigate to Opencart Modules. Klicka Edit button on Hygglig Checkout module.
  2. Enter Hygglig Eid and Hygglig Secret received from Hygglig.
  3. Test Mode must be set to Enabled while testing is being done. When you later receive Eid and Secret for Hygglig production environment, Test mode must be changed to Disabled.
  4. Orders can be activated/canceled automaticaly in Hygglig Handlarwebb by changing status on the order in Opencart. On Order sent and Order cancel you can set which statuses in Opencart will trigger activation and cancelation respectively in Hygglig Handlarwebb. We suggest Shipped for activation and Canceled for cancelation.
  5. That’s it, Hygglig Checkout settings is done and you can start making test purchases.

Using CSS with Hygglig Checkout

By default Hygglig Checkout iframe is rendered with no borders, no margins, no padding, transparent background and a maximum width of 1170px. You can modify the appearance of Hygglig Checkout by adding a bit of css.

In the example below we wanted the Hygglig Checkout iframe to have a border around it, make sure it hade white background regardless of theme, be centered in the parent div and have a width of 620 pixels on desktop.

#hyggligiframe {
  border: 1px solid #eee;
  border-radius: 4px;
  background-color: #ffffff;
  /* some padding */
  padding: 20px; 
  /* max-width to be responsive */
  max-width: 620px; 
  /* center Hygglig */
  margin: 0 auto; 
}

Test the installation

Send a mail to opencart@hygglig.com and you will receive a reply containing keys and login information for the test environment.

Going live

When the installation is tested and you are ready to go live you need to contact Hygglig support. Hygglig will then verify the integration and send you the keys for the production environment.