{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-modules/woocommerce/woocommerce_module.yaml","sidebar":"sidebar-sidebar.yaml__modules_woocommerce_woocommerce_module"},"props":{"definitionId":"modules/woocommerce/woocommerce_module.yaml","dynamicMarkdocComponents":[],"baseSlug":"/modules/woocommerce/woocommerce_module","seo":{"title":"Simplie plugin for WooCommerce","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"itemId":"","disableAutoScroll":true,"metadata":{"type":"openapi","title":"Simplie plugin for WooCommerce","description":"\n<b>Plugin version 2.8.0, 23.09.2026</b>\n\nThe Simplie for WooCommerce plugin makes Simplie financing products available as WooCommerce payment options. After installing and configuring the plugin, eligible Simplie payment options are displayed to customers on your product pages and at checkout. When a customer chooses an Simplie payment option at checkout, customers are redirected to the secure Simplie e-POS environment to complete the financing process and then redirected back to your store.\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/woocommerce-payment-flow-2.8.0.png\" class=\"frame\" alt=\"Customer journey from viewing Simplie financing on a product page through checkout, the Simplie application, and order confirmation\"/>\n</p>\n\n# Before you start\n\nBefore installing the plugin, go to <b>WooCommerce</b> → <b>Status</b> in your WordPress admin panel and confirm that your site meets these requirements:\n\n- <b>PHP:</b> 7.4 or later\n- <b>WordPress:</b> 6.2 or later (tested up to 7.1)\n- <b>WooCommerce:</b> 8.0 or later (tested up to 11.0.0)\n\nHave your <b>Shop UUID</b> and <b>Shop API key</b> ready. You can find them in the Simplie Partner Portal under <b>Onboarding</b>.\n\n<b>Not an Simplie partner yet?</b> Sign up in [Estonia](https://inbank.ee/kaupmehele), [Latvia](https://inbank.lv/biznesam), [Lithuania](https://inbank.lt/prekybininkui), [Poland](https://inbank.pl/dla-partnerow), or [Czechia](https://inbank.cz/pro-obchodni-partnery).\n\n<b>Need assistance?</b> See [Get help](#get-help).\n\n# Quick start\n\n1. [Install Simplie for WooCommerce](#installation) on your WordPress site.\n2. [Copy your Shop UUID and Shop API key](#configuration) to connect the plugin to Simplie.\n3. <b>You're all set!</b> 🎉\n\n<span id=\"installation\"></span>\n\n## Installation\n\nFollow these steps to install and activate Simplie for WooCommerce:\n\n1. [**Download Simplie for WooCommerce (ZIP file)**](https://docs.inbank.eu/payment-modules/wordpress/woocommerce-inbank.zip).\n2. In WordPress, go to <b>Plugins</b> → <b>Add Plugin</b> → <b>Upload Plugin</b>, select the ZIP file, and click <b>Install Now</b>.\n3. Click <b>Activate Plugin</b>. Activation alone does not add Simplie payment options to your storefront; the plugin must be configured first.\n\n  <p align=\"left\">\n    <img src=\"/static/modules/woocommerce/wordpress-install-admin.png\" alt=\"Upload the Simplie plugin ZIP and install it in WordPress\"/>\n  </p>\n\n<span id=\"configuration\"></span>\n\n## Configuration\n\n{% admonition type=\"info\" name=\"Credentials\" %}\nYou can find your credentials in the Simplie Partner Portal under <b>Onboarding</b>.\n\nCredentials for the demo environment are set up on request.\n{% /admonition %}\n\nAfter activating the plugin, initialize it with the credentials for your Simplie shop:\n\n1. Go to <b>Settings</b> → <b>Simplie</b> in your WordPress admin panel.\n2. Select <b>Live</b> for your live shop or <b>Demo</b> for the test environment.\n3. Enter the <b>Shop UUID</b> and <b>Shop API key</b> provided by Simplie.\n4. Click <b>Set up the plugin</b>.\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/plugin-initialization-2.8.0.png\" class=\"frame\" alt=\"Plugin initialization screen with Shop UUID and Shop API key fields\"/>\n</p>\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/payment-options-overview-2.8.0.png\" class=\"frame\" alt=\"Payment options automatically added to the WooCommerce plugin\"/>\n</p>\n\n# What customers see\n\nSee how Simplie financing appears to customers, from the product page to checkout.\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/woocommerce-payment-flow-2.8.0.png\" class=\"frame\" alt=\"Customer journey from viewing Simplie financing on a product page through checkout, the Simplie application, and order confirmation\"/>\n</p>\n\n{% admonition type=\"info\" name=\"Payment option appearance and availability\" %}\nExact payment option appearance varies by store theme, plugin settings, Simplie agreement, and locale.\n\nSimplie payment options on product pages and at checkout appear only when the product price/cart total is within the applicable amount limits.\n{% /admonition %}\n\nCustomers can open the financing details by clicking the estimated monthly payment on a product page or, at checkout, expanding an Simplie payment option and clicking its payment details; they can then adjust the financing terms and review applicable fees and APR for the product price or cart total.\n\n<details>\n<summary><b>Examples of the financing details customers can open</b></summary>\n\nProduct page pop-up for Simplie Hire Purchase and Simplie Split into parts\n\n<p align=\"left\">\n<img src=\"/static/modules/woocommerce/modal-hp.png\" class=\"frame\" border=\"1px\"/>\n</p>\n\nProduct page pop-up for Simplie Moki and Simplie HP Flex\n\n<p align=\"left\">\n<img src=\"/static/modules/woocommerce/modal-moki.jpg\" class=\"frame\" border=\"1px\" title=\"value\"/>\n</p>\n\n</details>\n\nAfter selecting an Simplie payment option and clicking <b>Place order</b>, customers are redirected to Simplie e-POS to complete the financing process.\n\nCustomers then return to the store: successful financing leads to the configured payment success page; otherwise, they return to the cart to choose another payment option. Orders paid with Simplie can be reviewed under <b>WooCommerce</b> → <b>Orders</b>.\n\n{% admonition type=\"info\" name=\"Order cancellations and refunds\" %}\nCancelling or refunding an order in WooCommerce does not automatically cancel the associated Simplie credit agreement. Contract withdrawals and cancellations must be managed separately in the Simplie Partner Portal.\n{% /admonition %}\n\n# Additional settings\n\n<span id=\"general-settings\"></span>\n\n### General settings\n\n<details>\n<summary><b>View available settings and default values</b></summary>\n\nGo to <b>Settings</b> → <b>Simplie</b> → <b>General settings</b> to configure WooCommerce order-status mappings and the storefront color mode.\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/general-settings-2.8.0.png\" class=\"frame\" alt=\"General settings for WooCommerce order statuses and color mode\"/>\n</p>\n\nThe following settings are available:\n| **Setting** | **Description** | **Default value** |\n| :- | :- | :- |\n| Confirmed order state | Used when the purchase has been successfully financed by Simplie. | Processing |\n| Granted order state | Used when financing has been granted by Simplie and contract activation is awaiting partner approval. Approve or cancel granted contracts in the Simplie Partner Portal. | On hold |\n| Pending order state | Used while the purchase is awaiting financing by Simplie. | Pending payment |\n| Canceled order state | Used when the order has been canceled. | Cancelled |\n| Declined order state | Used when financing has been declined. | Cancelled |\n| Color mode | Controls the light or dark appearance of Simplie storefront components. | Dark |\n\n{% admonition type=\"info\" name=\"IP Addresses to be whitelisted for Callbacks\" %}\nSimplie communicates financing status changes to the online store through callbacks, allowing the plugin to update order statuses accordingly.\n\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{% /admonition %}\n\n</details>\n\n<span id=\"change-environment-or-credentials\"></span>\n\n### Change environment and/or credentials\n\n<details>\n<summary><b>See how to switch environments or update credentials</b></summary>\n\nTo switch environments or change credentials, open <b>Settings</b> → <b>Simplie</b> → <b>Store reconfiguration</b>, select the environment, enter its matching credentials, and apply the changes.\n\n{% admonition type=\"warning\" name=\"Settings are reset\" %}\nChanging the environment or credentials reloads the configured payment options. Any active/inactive selections and product or category restrictions are reset.\n{% /admonition %}\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/store-reconfiguration-2.8.0.png\" class=\"frame\" alt=\"Store reconfiguration screen for changing the environment and shop credentials\"/>\n</p>\n\n</details>\n\n<span id=\"restrictions\"></span>\n\n### Set up restrictions\n\n<details>\n<summary><b>See how to set up restrictions for Simplie payment options</b></summary>\n\nRestrictions control which products can use a specific Simplie payment option using category, individual product, or manufacturer filters. Restrictions are configured separately for each payment option. By default, a payment option is available for all products.\n\nUnder <b>Settings</b> → <b>Simplie</b>, select <b>Apply restrictions</b> for a payment option. Select one or more categories, products, or manufacturers; choose a match mode; and apply the changes.\n\nThe <b>Manufacturers</b> filter is displayed only if a manufacturer attribute is configured in the store.\n\n- <b>Match all filters:</b> A payment option is available only when a product matches at least one selected value in every filter you configured.\n- <b>Match any filter:</b> A payment option is available when a product matches at least one selected value in any filter you configured.\n- Leave all filters blank to make the payment option available to all products.\n\n<p align=\"left\">\n  <img src=\"/static/modules/woocommerce/payment-option-restrictions-2.8.0.png\" class=\"frame\" alt=\"Restriction settings with category, product, manufacturer, and match mode filters for an Simplie payment option\"/>\n</p>\n\n</details>\n\n# Testing\n\n{% admonition type=\"info\" name=\"Testing credentials\" %}\nCredentials for the demo environment are set up on request.\n{% /admonition %}\n\nSimplie provides a dedicated demo environment for testing the integration with payment solutions. To connect the plugin to this environment, select <b>Demo</b> during plugin initialization and enter the demo <b>Shop UUID</b> and <b>Shop API key</b> provided by Simplie. The plugin adds the financing products associated with the demo shop as WooCommerce payment options.\n\nFor testing purposes, the system returns preconfigured decisions:\n- Positive decisions are 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. When prompted for an SMS verification code, enter 0000.\n\n<b>Verify your setup:</b> Place a demo order to confirm that the customer returns to the store and the WooCommerce order status is updated as expected.\n\n<details>\n<summary><b>Test Estonian financing products</b></summary>\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 unique 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- ID-card - <a href=\"https://demo.sk.ee/upload_cert/\" target=\"_blank\">https://demo.sk.ee/upload_cert/</a>\n\nYou can also use Smart-ID by downloading the following apps:\n\n- Android: <a href=\"https://play.google.com/apps/testing/com.stagnationlab.sk\" target=\"_blank\">https://play.google.com/apps/testing/com.stagnationlab.sk</a>\n- iOS: <a href=\"https://testflight.apple.com/join/DoWddZjR\" target=\"_blank\">https://testflight.apple.com/join/DoWddZjR</a>\n\nTo use Smart-ID for testing, your account level should be 'Qualified'. You can check the account level at <a href=\"https://sid.demo.sk.ee/portal/login\" target=\"_blank\">https://sid.demo.sk.ee/portal/login</a>.\n\n</details>\n\n<span id=\"updates\"></span>\n<span id=\"pluginUpdates\"></span>\n\n# Updates\n\nFollow the steps below to update Simplie for WooCommerce. Your existing plugin configuration is retained during the update.\n\n1. Back up the store and test the update on staging when possible.\n2. [**Download the latest version of Simplie for WooCommerce (ZIP file)**](https://docs.inbank.eu/payment-modules/wordpress/woocommerce-inbank.zip).\n3. Upload the new plugin through <b>Plugins</b> → <b>Add Plugin</b> → <b>Upload Plugin</b>, select the file, and click <b>Install Now</b>.\n4. Click <b>Replace current with uploaded</b> and activate the plugin if prompted.\n\nIf WordPress does not offer the replacement option, deactivate and delete the current version under <b>Plugins</b> → <b>Installed plugins</b>, then upload and install the new package again.\n\n<span id=\"get-help\"></span>\n\n# Get help\n\nFor questions about the plugin or help troubleshooting an issue, contact the Simplie integration team for your market:\n\n- <b>Estonia:</b> <a href=\"mailto:integration@inbank.ee\">integration@inbank.ee</a>\n- <b>Poland:</b> <a href=\"mailto:integration@inbank.pl\">integration@inbank.pl</a>\n- <b>Latvia:</b> <a href=\"mailto:integration@inbank.lv\">integration@inbank.lv</a>\n- <b>Czechia:</b> <a href=\"mailto:integration@inbank.cz\">integration@inbank.cz</a>\n- <b>Lithuania:</b> <a href=\"mailto:integration@inbank.lt\">integration@inbank.lt</a>\n\nWhen contacting support, provide the plugin, WordPress, WooCommerce, and PHP versions; state whether you are using the <b>Demo</b> or <b>Live</b> environment; and include any relevant error text or screenshots.\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/woocommerce/woocommerce_module","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}