Skip to main content

Installation guide

Install the withdrawal button on OpenCart

For OpenCart 4 there is a Clawzia extension with a settings page; for OpenCart 3, an OCMOD modification. Ask us for the package that fits your store.

Before you start

  1. Create your shop in Clawzia

    Sign up with your email address, create the shop, choose its country and default language and enter the email address that receives withdrawal notifications.

  2. Allow your shop’s domains

    Add every domain your shop runs on to the allowed domains, for example with and without www and the platform address of your shop. On other domains the widget only shows a link to the hosted form, with the EU directive’s wording in English.

  3. Copy your code

    Copy the code from the Install page of your dashboard (for the plugins, only the public key, which starts with pk_). The public key is not a secret.

OpenCart 4: the Clawzia extensionRecommended

Do not rename the package clawzia.ocmod.zip: OpenCart 4 uses the file name as the extension code, so a renamed file (for example after a second download) does not work.
  1. Upload the extension

    Upload the package, then click the green Install button of “Clawzia Withdrawal Button” in the list below.

    Where: Extensions → Installer → Upload → clawzia.ocmod.zip

    Screenshot follows: Extensions → Installer with the uploaded package.

  2. Install the module

    Choose the type Modules and install “Clawzia Withdrawal Button” with the green + button.

    Where: Extensions → Extensions → type Modules

    Screenshot follows: The Modules list with the Clawzia entry.

  3. Enter your public key

    Open the module settings with the blue pencil button, paste your public key, switch Status on and save.

    Screenshot follows: The Clawzia settings page.

  4. Verify the installation

    Click Verify installation. The status card shows your shop, its country, the text of the link and whether the wording is verified, and checks that the widget file can be downloaded.

  5. If nothing appears

    Check that the event clawzia_footer is enabled, then refresh the theme cache.

    Where: Extensions → Events; theme cache: Dashboard → gear icon (Developer Settings) → Theme → Refresh

OpenCart 3: the OCMOD modificationAlternative

OpenCart 3 has no settings page for Clawzia: you put your public key into the file before installing it.
  1. Put your public key into the file

    Unzip clawzia-opencart3.ocmod.zip, open install.xml in a plain text editor and replace CLAWZIA_PUBLIC_KEY with your public key (keep the quotes). Zip install.xml again, at the top level of the ZIP, with a name ending in .ocmod.zip.

    Screenshot follows: The edited line in install.xml.

  2. Upload the modification

    Upload the ZIP file.

    Where: Extensions → Installer → Upload

  3. Refresh the modifications

    Refresh the modifications and, if the theme cache is on, the theme cache.

    Where: Extensions → Modifications → Refresh

    Screenshot follows: Extensions → Modifications → Refresh.

Good to know

  • Themes whose footer template has no closing body tag are skipped: add {{ clawzia_snippet }} before </body> in that template by hand.
  • Install the modification only once, and not together with a copy in the system folder: with two copies, the code is printed twice.

Check the installation

  1. Open your shop in a private window

    The withdrawal link appears at the end of your footer, or as a floating button, depending on the position you chose in the dashboard.

  2. Try it with the keyboard

    Press Tab until the link is focused, then Enter: the two-step withdrawal form opens. Close it with Esc.

  3. Check that the code is there once

    View the page source and search for data-shop="pk_. The script tag should appear exactly once per page.

  4. Send a test withdrawal

    Send a withdrawal with your own email address and the order reference TEST. Check the confirmation email and its receipt link, then close the request in your dashboard.

  5. If the link does not appear

    If your site sends a Content Security Policy, allow https://clawzia.com in script-src and connect-src. Exclude widget.js from script combining, minifying and “delay JavaScript” features of optimisation plugins and CDNs.

Ready to install?

Create your shop to get your public key, then follow the steps above.