{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-modules/opencart/opencart_module.yaml","sidebar":"sidebar-sidebar.yaml__modules_opencart_opencart_module"},"props":{"definitionId":"modules/opencart/opencart_module.yaml","dynamicMarkdocComponents":[],"baseSlug":"/modules/opencart/opencart_module","seo":{"title":"OpenCart 3 & 4 Extension Guide","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"itemId":"","disableAutoScroll":true,"metadata":{"type":"openapi","title":"OpenCart 3 & 4 Extension Guide","description":"\nPlugin version 2.5.5, 24.08.2026\n\nHere at Simplie we strive to help our partners sell more by simplifying purchases and making financing more accessible to customers. For exactly this reason we offer a number of buy-now-pay-later solutions.\n\nThe Pay Later Platform by Simplie connects partner e-shops with our e-POS solution. With e-POS, partners only need to add Simplie as a payment method and Simplie will take care of all the rest. Customers are redirected to the e-POS environment to complete the financing of the purchase. After a successful financing process we redirect the customer back to you.\n\nSimplie e-POS is supplemented with Simplie Partner Portal where merchants can see the overview of submitted credit applications, create applications for customers and conduct contract withdrawals.\n\nIf you have any questions regarding the Simplie OpenCart extension, just contact us and we will be happy to help:\n\n- Estonia - integration@inbank.ee\n- Poland - integration@inbank.pl\n- Latvia - integration@inbank.lv\n- Czech Republic - integration@inbank.cz\n- Lithuania - integration@inbank.lt\n\nThe Pay Later Platform by Simplie has been tested with the Default Store Theme (designed by the OpenCart team) and OpenCart versions 3.0.0, 3.0.3.6, 3.0.3.8, 3.0.3.9, 3.0.4.0, 4.0.2.x, 4.1.0.0.\n\nThe Pay Later Platform by Simplie includes storefront content translations for the following languages Estonian, Polish, Latvian, English, Czech, Russian and Lithuanian.\n\nThe Pay Later Platform for Opencart gives merchants access to the following Simplie products:\n\nYou can find the list of available Simplie products [here](#listofproducts).\n\n# Changelog\n\n|**Version**|**Date**|**Updates**|\n| :- | :- |:- |\n| 2.1.0 | 09.12.2024 | Added support for OpenCart 4 and Simplie Hire Purchase Lithuania payment product.|\n| 2.1.1 | 21.05.2025 | Updated LT calculation logic.|\n| 2.2.0 | 17.06.2025 | Added Simplie Moki Lithuania payment product.|\n| 2.3.1 | 06.08.2025 | Added Simplie HP Flex product for EE and LV.|\n| 2.3.2 | 18.09.2025 | Added Changes to Moki1 product.|\n| 2.4.0 | 22.09.2025 | Added Simplie HP Flex product for PL.|\n| 2.5.0 | 01.10.2025 | Removed Simplie Pay next month product.|\n| 2.5.2 | 24.10.2025 | Bugfixes.|\n| 2.5.4 | 19.06.2026 | Fix language detection on product page and logo path in admin grid view and fix tooltip.|\n| 2.5.5 | 24.08.2026 | Fix saving payment method's name to database. Fixed OpenCart 4 Latvia Split into parts using the Estonian API URL instead of the Latvian API. |\n\n# Installation Prerequisites\n\nAs a preparatory step before installing the Pay Later Platform extension, you need to install the following extensions to your OpenCart store:\n\nvQmod
\nThe extension is used for storefront customizations included in the Pay Later Platform. Make sure you install the latest release of vQmod, which is available here.\n\nvQmod installation is performed via your hosting upload capabilities (FTP, SSH, CPanel). The installation instructions can be found here. Please pay special attention when setting permissions.\n\nIf you run into some issues when installing vQmod, the following resources may be helpful in resolving them: OpenCart forum and vQmod repository discussion.\n\nInstall 'OC 3.X.X.X Installation Issue Fix' extension
\nThe extension fixes the modification upload error which may appear in OpenCart 3.\n\nYou can install the extension by uploading the file available here. After the installation, make sure to go to Extensions > Modifications menu and click Clear and Refresh.\n\nCron Jobs
\nYou need cron jobs configured for your OpenCart instance for running scheduled tasks automatically.\n\n- You can use easycron.com or cron-job.org to set up your cron jobs.\n- Alternatively, you can install 'Cron Jobs for Opencart 3.0.* and 2.3.*' by uploading the file available here. After the installation, make sure to go to Extensions > Modifications menu and click Clear and Refresh. You also need to enable the Cron Jobs extension in the Extensions > Extensions > Modules list.\n\n'OCMod Vqmod modifications fix' extension
\nThe extension fixes an issue which has been found in OpenCart 3 and affects the functionality of the Pay Later Platform.\n\nYou can install the extension by uploading the file available here. After the installation, make sure to go to Extensions > Modifications menu and click Clear and Refresh.\n\n# Installation\n\nYou can download the latest version of the extension from here:\n\n- [version 3.0.0](/payment-modules/opencart/oc3/inbank.ocmod.zip) build compatible with OpenCart 3.0.0, 3.0.3.6, 3.0.3.8, 3.0.3.9, 3.0.4.0\n- [version 4.0.0](/payment-modules/opencart/oc4/inbank.ocmod.zip) build compatible with OpenCart 4.0.2.x, 4.1.0.0\n\n\nTo install the Pay Later Platform extension you just need to follow these steps:\n\n1. In the back office of your shop, go to Extensions > Installer section.\n2. Click the Upload button in the 'Upload your extension' section of the page.\n3. Select the .zip package containing the extension in the window that appears. The extension will then be uploaded to your system.\n4. Go to the Extensions > Modifications menu and click Clear and Refresh.\n5. Go to the System > Users > User Groups > Administrator section and enable all _Access_ _permissions_ and _Modify permissions_. Click the Save icon to apply changes.\n6. Refresh cache by going to Dashboard > Gear icon and clicking the Refresh button next to each of the cache types.\n\nAnd that is it! The Pay Later Platform is now ready for configuration.\n\n\n\n# Extension Overview Page\n\nAfter successful installation of the Pay Later Platform by Simplie, you can configure Simplie products as payment methods in your back office.\n\nThe Pay Later Platform configuration is done at Extensions > Extensions > Payments > Pay Later Platform by Simplie.\n\nThe extension includes the following Simplie payment methods:\n- Simplie Hire Purchase Estonia\n- Simplie Split into parts Estonia\n- Simplie Hire Purchase Poland\n- Simplie Hire Purchase Latvia\n- Simplie Split into parts Latvia\n- Simplie Hire Purchase Czech Republic\n- Simplie Hire Purchase Lithuania\n- Simplie Moki Lithuania\n- Simplie HP Flex Estonia\n- Simplie HP Flex Latvia\n- Simplie HP Flex Poland\n\nThe extension overview page at Extensions > Extensions > Payments > Pay Later Platform by Simplie includes the list of all the Simplie payment options added.\n\n

\n\n

\n\nHere several actions regarding added payment options are available:\n\n- Click Edit next to a payment option to make changesto it's configuration.\n- Click Delete next to a payment option to delete it.\n\nOn the extension overview page you can also change the statuses used by the extension to better fit your business logic.\n\nIn the General Settings section you can customize which statuses the extension sets for:\n\n- Confirmed order state - for cases when the purchase was successfully financed by Simplie\n- Pending order state - for cases when the purchase is awaiting financing by Simplie\n\n**Note:** Simplie communicates financing status changes to the online store through callbacks, allowing the plugin to update order statuses accordingly.
\nIf order statuses are not updating as expected, verify that Simplie's callback IP addresses are whitelisted in your firewall or network security settings. See [Callback IP Whitelisting](/api/additional-api-flow/section/callback-ip-whitelisting) for the required IP addresses.\n\nBy default the data retrieved from Simplie over API is updated every 24 hours. If you would like to run the data update at a different interval, the General Settings section includes the cron job link which can be used for that. We recommend updating data once every 24 hours, from 00:00 AM to 06:00 AM.\nAdditionally, under the General Settings section you can click the Update products button for a one-time product data update at any time you'd like.\n\n# Adding New Payment Options\n\nNew payment options are added via clicking the Add Payment Option at Extensions > Extensions > Payments > Pay Later Platform by Simplie.\n\nDepending on the Simplie branch(es) you are cooperating with, you need to configure the payment products for Estonia, Poland, Czechia, Latvia or Lithuania. You can offer one of the available products or several, depending on the agreement you have with Simplie.\n\nThe following configuration parameters are predefined by Simplie:\n\n- Title\n- Maximum order amount\n- Minimum order amount\n- Period\n- Additional details\n\nNote that the predefined values will be updated if they change on the Simplie side. The exceptions are the Title and Additional details values which are customizable. The Title and Additional details are updated if set to default, but are not updated if they have been customized.\n\nFor more information on updates, refer to the [Updates](#updates) section.\n\nAdding a new Simplie payment method to the extension configuration is a simple two-step process.\n\nOn step 1 you need to set the keys and product code required for the functioning of the extension and the mode in which this payment product is to be available: live or test.\n\nSimplie representatives will provide you all the data required for this step. Make sure to fill in all the fields correctly, as they are essential to the configuration of Simplie payment products.\n\nOn step 2 you can review your configuration and set a couple additional options available in the extension.\n\n## Step 1: Settings\n\nTo start adding a new Simplie payment product, click Add Payment Option at Extensions > Extensions > Payments > Pay Later Platform by Simplie.\n\nConfiguration settings are similar for all payment products: Simplie Hire Purchase Estonia, Simplie Split into parts Estonia, Simplie HP Flex Estonia, Simplie Hire Purchase Poland, Simplie HP Flex Poland, Simplie Hire Purchase Czech Republic, Simplie Hire Purchase Latvia, Simplie Split into parts Latvia, Simplie HP Flex Latvia, Simplie Hire Purchase Lithuania and Simplie Moki Lithuania.\n\nThe product code set during configuration defines the credit conditions available to customers and also automatically sets the following parameters:\n\n- Title\n- Maximum order amount\n- Minimum order amount\n- Period\n- Additional details\n\nStep 1 includes the essential parameters needed for the payment option setup. Simplie representatives will provide you all the information needed at this step.\n\nAfter you add the necessary data, click Next to proceed to step 2 where you review the configuration and can set a number of additional parameters for the payment option.\n\n

\n\n

\n\n|**Field**|**Description**|\n| :- | :- |\n| Country | The market for which you wish to add an Simplie payment method.
Available options: Estonia, Poland, Czech Republic, Latvia, Lithuania.|\n| Product | The payment product you wish to add. The section depends on the Country:

- Estonia - Simplie Hire Purchase, Simplie HP Flex, Simplie Split into parts
- Poland - Simplie Hire Purchase, Simplie HP Flex
- Latvia - Simplie Hire Purchase, Simplie Split into parts, Simplie HP Flex
- Czech Republic - Simplie Hire Purchase
- Lithuania - Simplie Hire Purchase, Simplie Moki |\n| Enable test mode | Select whether the extension should be connected to test API for testing purposes. If this parameter is not enabled, the extension connects to the live API.

This parameter defines whether next you need to set the API key, UUID and product code for the live or test environment.

By default, test mode is disabled, but the setting can be customized.|\n| Live product code / Test product code | The product code provided by Simplie. This code defines the credit conditions offered at checkout.|\n| Live API key / Test API key | The unique key of the shop used for building API requests through which the shop communicates with Simplie.|\n| Live shop UUID / Test shop UUID | The API authentication key. The API key should be kept private.|\n| Localization ID | ID of the set of translations required for the extension. Translations are available in Estonian, Polish, English, Latvian, Czech, Russian and Lithuanian.|\n| Localization token | Token required to access the translations for storefront texts.|\n\n## Step 2: Overview and Confirmation\n\nStep 2 lets you review the payment option configuration and includes a number of additional parameters which can be configured for Simplie payment methods.\n\n

\n\n

\n\n|**Field**|**Description**|\n| :- | :- |\n| Payment enabled | Whether this Simplie product appears as a payment method at checkout.|\n| Enable test mode | Select whether the extension should be connected to test API for testing purposes. If the parameter is not enabled, the extension connects to the live API.

This parameter defines whether next you need to set the API key, UUID and product code for the live or test environment.|\n| Live product code/Test product code | The product code provided by Simplie. This code defines the credit conditions offered at checkout.

This parameter is prefilled from Step 1 , but you can change the Product Code here if needed.|\n| Live API key / Test API key | The unique key of the shop used for building API requests through which the shop communicates with Simplie.

This parameter is prefilled from Step 1 , but you can change the API key here if needed.|\n| Live shop UUID / Test shop UUID| The API authentication key. The API key should be kept private.

This parameter is prefilled from Step 1 , but you can change the UUID here if needed.|\n| Localization ID | ID of the set of translations required for the extension. Translations are available in Estonian, Polish, English, Latvian, Czech, Russian and Lithuanian.

This parameter is prefilled from Step 1 , but you can change the Localization ID here if needed.|\n| Localization token | Token required to access the translations for storefront texts.

This parameter is prefilled from Step 1 , but you can change the Localization token here if needed.|\n| Display logo | Whether the payment method logo will be displayed next to the title at checkout.

By default the logo is enabled, but the setting can be customized.|\n| Logo size | The size of the payment method logo which is displayed next to the title at checkout. The logo will be displayed only if the Use Logo parameter is set to Yes.
Available size options are Small and Medium.

The default value is Small, but the setting can be customized.|\n| Custom logo | A custom logo for the payment method which will be displayed next to the title at checkout. If the custom logo is removed, the default logo will be applied. |\n| Enable calculations | Whether calculated monthly amounts should be presented on product pages. When enabled, preliminary calculations of monthly payments will appear on the pages of products within the minimum-maximum range for this Product code.|\n| Title | The payment method title that is displayed to customers at checkout. The recommended Title length is 65 characters.

The default Title is defined by the Product code. You can customize it for Simplie Hire Purchase Estonia, Simplie HP Flex Estonia, Simplie Hire Purchase Poland, Simplie HP Flex Poland, Simplie Hire Purchase Czech Republic, Simplie Hire Purchase Latvia, Simplie HP Flex Latvia, Simplie Hire Purchase Lithuania and Simplie Moki Lithuania products, in which case the default value will be displayed under the Title field. If you set a different Product code, your custom value will be overridden with the new default one, which can then be customized.|\n| Minimum Order Amount | The minimum order amount for which the payment method is available. The value is defined by the product code.

For sums below this value, the payment method is not displayed.|\n| Maximum Order Amount | The maximum order amount for which the payment method is available. The value is defined by the product code.

For sums above this value, the payment method is not displayed.|\n| Period | The period options in months for which credit under this payment method is granted. The values are defined by the product code.|\n| Additional details | The consent message displayed under the payment method at checkout. The default Additional details are defined by the Product code. You can customize it, then the default value will be displayed under the Additional details field.|\n\n

\n\n\n\n# Setting Restrictions for Simplie Payment Products\n\nOnce you've added all needed Simplie payment products to your shop you can pick and choose which products or product categories Simplie payment products are applicable to. By default, the payment products have no restrictions set.\n\nThe restrictions configuration is available at Extensions > Extensions > Payments > Pay Later Platform by Simplie. Click the button next to the payment method you wish to set the restrictions for, the bottom of the page will then contain the needed configuration options. Once you are all set, just click Save.\n\n

\n\n

\n\nRestrictions can be set by product categories or by certain products only. In both cases you can select one or several categories/products.\n\nThe are two restriction rules available:\n\n - AND, products must be present in selected category and product restrictions. If this rule is applied, the Simplie payment method will be available only for those products which belong to the category(s) selected in the Category restrictions and at the same time listed under the Product restrictions. If there are no products listed under Product restrictions, the payment method will be applicable to all products under the category(s) listed in the Category restrictions. This rule is selected by default.\n - OR, products can be present in selected category or product restrictions. If this rule is applied, the Simplie payment method will be available for all products which belong to the category(s) selected in the Category restrictions and all products listed under the Product restrictions even if they are from different categories. If there are no products listed under Product restrictions, the payment method will be applicable to all products, regardless of their category.\n\n# Testing\n\nSimplie provides a dedicated staging environment for testing the integration with payment solutions. For testing purposes, you need to specify several parameters in the payment method settings at Extensions > Extensions > Payments. The same page can be accessed through a shortcut in the left side menu at Simplie > Settings.\n- In the API Settings sections you need to specify the _Test API key_ and the _Test UUID_. The API key is used for authentication, while the shop key is used for building API requests. Both the shop key and UUID are provided by Simplie.\n- I n the General tab of the payment product, you need to enable the _Test mode_ parameter and add the _Test product code_. The product code needs to be indicated for each financing product individually and is provided by Simplie.\n\nFor testing purposes, the system returns preconfigured decisions:\n\n- For Simplie Hire Purchase Estonia, Simplie Split into parts Estonia, Simplie HP Flex Estonia, Simplie Hire Purchase Poland, Simplie HP Flex Poland, Simplie Hire Purchase Czechia, Simplie Hire Purchase Latvia payment products, Simplie Split into parts Latvia, Simplie HP Flex Latvia, Simplie Hire Purchase Lithuania and Simplie Moki Lithuania, positive decision is given for amounts 0 - 500, 15 000 - 16 000.\n\nThe credit application process may include an OTP code exchange via SMS. The demo environments do not send out SMS messages. If you are testing Simplie Split into parts Estonia or Simplie Split into parts Latvia payment products, the SMS message is hardcoded to value 0000.\n\nTesting Simplie Payments Estonia products\n\nTo test the financing products in Estonia, you can safely use your own Estonian ID-code and ID-card, as the demo environment does not initiate real binding contracts. Alternatively, you can use our demo user, the identity code of which is 10101010005. Besides the identity code, you will also need a name and a phone number for authentication and signing.\n\nTo use an ID-card or Mobile-ID in the demo environment, you need to register them at:\n\n- ID-card - https://demo.sk.ee/upload_cert/.\n- Mobile-ID - https://demo.sk.ee/MIDCertsReg/.\n\nYou can also use Smart-ID by downloading the following apps:\n\n- Android: https://play.google.com/apps/testing/com.stagnationlab.sk.\n- iOS: https://testflight.apple.com/join/DoWddZjR.\n\nTo use Smart-ID for testing, your account level should be `Qualified`. You can check the account level at https://sid.demo.sk.ee/portal/login.\n\n\n\n# Updates\n\nThere are a couple of things which can be updated in the Pay Later Platform:\n\n- [Extension updates](#extensionupdates). The current version of the extension contains all the functionality required to offer Simplie payment methods to customers. In the future we plan on adding new payment products to the extension, as well as features to improve existing functionality. Updating the extension to the latest version will support added features and keep your store up to date with the latest enhancements from Simplie to make purchases even smoother for your customers.\n- [API data updates](#apidataupdates). The extension retrieves data from Simplie regarding the conditions of payment products offered to customers. This data can undergo changes on the Simplie side. If such changes occur, product parameters should also be updated in the extension, for the customers to successfully use Simplie payment methods.\n- [Extension settings updates](#extensionsettingsupdates). The payment product which is offered to customers depends on the product code set for the payment method. If at any point you need to change the product code or any other extension configurations, this can be easily done through the extension settings.\n\nThe following sections cover all the update procedures.\n\n\n\n## Extension Updates\n\nIf a new version of the Pay Later Platform for OpenCart comes out and you want to make use of the functionality it offers, updating the extension is quick and easy. You can download the latest version of the extension from here:\n\n- [version 3.0.0](/payment-modules/opencart/oc3/inbank.ocmod.zip) build compatible with OpenCart 3.0.0, 3.0.3.6, 3.0.3.8, 3.0.3.9, 3.0.4.0\n- [version 4.0.0](/payment-modules/opencart/oc4/inbank.ocmod.zip) build compatible with OpenCart 4.0.2.x, 4.1.0.0\n\nDo not worry about the configuration settings. While the extension is updated, all settings, including API keys, product codes, etc., are migrated into the new version of the extension.\n\nTo update OpenCart3, please follow these steps:\n\n1. In the back office of your shop, go to Extensions > Installer section.\n2. Click the Upload button in the 'Upload your extension' section of the page.\n3. Select the .zip package containing the extension in the window that appears. The extension will then be uploaded to your system.\n4. Go to the Extensions > Modifications menu and click Clear and Refresh.\n\nTo update OpenCart4, there are two options:\n 1. Uninstall the current extension and install the updated extension following the steps [here](/modules/opencart/opencart_module/#section/Installation).\n 2. Update the extension manually, for example using FTP. Files would need to be moved to the `root/extension/inbank/` directory.\n\n\n\n## API Data Updates\n\nAfter you set a product code for an Simplie payment method, the extension retrieves product related parameters via API from Simplie. Simplie can make changes to these data and these changes need to be synchronized with the settings of the extension.\n\nIf you have cron jobs configured in your OpenCart instance, the Pay Later Platform will check for updates and apply them to your store automatically.\n\nConfiguration parameters which can receive updates:\n\n- Title\n- Minimum order amount\n- Maximum order amount\n- Period\n- Marketing message\n- Additional details\n\nYou can also manually have the Simplie extension check for updates whenever you need. To do this just go to Extensions > Extensions > Payments > Pay Later Platform by Simplie and click Update products at the bottom of the page.\n\nThat is it! Now your extension has all the latest data from Simplie.\n\n\n\n## Extension Settings Updates\n\nIf at any point you need to make changes to the extension settings, you can access the configuration at Extensions > Extensions > Payments > Pay Later Platform by Simplie.\n\nTo update the settings for the Pay Later Platform, click the button next to a payment method, make the required changes to the configuration and click Save.\n\nThat is it. Your payment method settings are now updated.\n\n# Storefront Flow\n\nThis section showcases how Simplie payment methods work at checkout.\n\nNote that the following screenshots are only demonstrational. The actual way the Simplie payment methods appear in your OpenCart store depends on the storefront theme, extension settings, the Simplie branch with which you have concluded the contract and the locale of your store.\n\n1. If enabled, Simplie monthly payment calculations appear on product pages.\n\n

\n\n

\n\n2. Simplie products appear at checkout as available payment methods:\n\n

\n\n

\n\n3. Once customers choose Simplie products as their payment method, confirm the order and click Confirm order, they are redirected to the Simplie environment. Here customers go through a number of dialogs to complete the financing of the purchase.\n\n4. After completing the procedure in Simplie environment, customers are redirected back to the shop.\n\n

\n\n

\n\nIf the purchase has been financed by Simplie, the customer will be redirected to the page configured in your OpenCart instance as the payment success page. Otherwise, the customer will be redirected back to the cart.\n\nPayment transactions can be viewed in the Sales > Orders section of the back office.\n\nUntil the credit contract has been signed by the customer and approved by Simplie for financing, it remains in status Simplie: waiting for financing.\n\nOrders which have been successfully financed by Simplie receive status Simplie: purchase financed.\n\nIf the flow is configured to require merchant approval prior to concluding the credit contract, the order which has been approved by Simplie for financing receives status Simplie: credit granted. In this state the order awaits the merchant's approval or cancellation. If the merchant approves the contract, the order receives status Simplie: purchase financed. Contracts are approved and canceled through the Simplie Partner Portal.\n\n

\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.simplie.gr","port":4000,"ipAddress":"216.73.216.98"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"feature/AG-65-test-simplie-setup"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/modules/opencart/opencart_module","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}