hutko

Scale smarter: automate payments and expand without limits

Unlock the full potential of your business with a powerful payment service! Maximise conversions, drive more sales, and seamlessly accept payments from customers worldwide. Automate your business processes and take control of your payments directly from your OpenCart admin panel. Watch your business thrive in real-time as you scale locally and expand globally. Connect your online store with hutko in just minutes and experience the difference!

☑️ Expand globally with payments in 150+ currencies across 200+ countries
☑️ Sell smarter with a checkout that adapts to you and your customers' preferences
☑️ Accept cards, Apple Pay, Google Pay, and installments with ease
☑️ Simplify repeat purchases with one-click payments powered by advanced tokenization
☑️ Customize your checkout – add logo, change colors, and configure fields
☑️ Save and reuse payment links – convenient for repeat payment attempts
☑️ Make instant refunds with zero stress – all from your OpenCart admin panel
☑️ Access end-to-end payment analytics – get a clear view of your business


Requirements

☑️ OpenCart version 3.0.0.0 or later
☑️ PHP version 7.3 or later
☑️ PHP cURL extension enabled on your server

Important: You must have activated merchant account at hutko.org to use this extension

Installation

Before installation, make sure the PHP cURL extension is enabled on your server.
 

Creating and activating hutko merchant

1. Complete registration and activate merchant account at hutko.org

Download the module

1. Get the latest version of the module from the official module repository (search on hutko.org).

Installation in OpenCart

1. Log in to the OpenCart admin panel.

2. Go to Extensions → Installer.

3. Click the Upload button.

4. Select the downloaded .ocmod.zip module file and upload it.

5. Wait for the upload and installation process to complete.

6. Go to Extensions → Modifications.

7. Click the blue Refresh button (top right) to apply the changes.

8. Go to Extensions → Extensions.

9. From the “Choose the extension type” dropdown, select Payments.

10. Find hutko.

11. Click the green Install button (plus icon) next to the module.

Configuration

After installation, you need to configure the module using your hutko account credentials.

Accessing module settings

1. In the OpenCart admin panel, go to Extensions → Extensions.

2. From the “Choose the extension type” dropdown, select Payments.

3. Find hutko in the list and click the blue Edit button (pencil icon).

⚠️ Due to the Cookie SameSite security policy, when returning to your website from the hutko payment page, the customer will be logged out.
To avoid customer inconvenience, change the redirect method from POST to GET in the Hutko portal:
Settings → Payment settings → Result page redirect method.

Enter account credentials

• Merchant ID — your unique identifier provided by hutko (required).

• Secret key — the key used to secure transaction signatures (required).

Order statuses

Select the appropriate OpenCart order statuses that the module should set for:

• Successful payment status (e.g. Processing, Completed).

• New order status (e.g. Pending).

• Failed payment status (e.g. Failed, Canceled).

• Expired payment status (e.g. Expired, Canceled).

Additional settings

• Set the Geo Zone for which this payment method will be available.

• Set the Total — the minimum order total required for this payment method to appear.

• Set the Sort Order to control its position among other payment methods.

• Enable or disable the module using the Status option.

• For fiscalization compatibility, you may disable sending fixed discounts to hutko servers.

Save settings

• Click the Save button (top right).

⚠️ The module will not work properly without valid hutko service credentials.

Usage

After configuration, the module will automatically add hutko as a payment option on the checkout page.

1. The customer selects “Pay with hutko”.

2. The customer is redirected to the secure hutko payment page.

3. After successful payment, the customer is automatically redirected back to your OpenCart store and the order status is updated accordingly.

4. If the payment fails or is declined, the customer is redirected back with an appropriate error message and the order status reflects the failure.

5. The module automatically receives payment status updates from the hutko server. If the status changes to “declined” or “expired”, the module assigns the corresponding configured order status in OpenCart (e.g. Failed Payment or Payment Error).

6. The order is created before payment, so you do not lose customer contact details and can bring them back to complete the purchase faster.

7. Payment statuses store a payment link that you can easily resend to the customer.