alt
Unzer

Install the plugin

Learn how to install and configure the plugin.

Before you begin

Before installing the plugin, make sure that your shop meets the technical requirements as specified by OXID eShop 7 documentation.

icon
Third-party plugins
Note that third-party plugins and templates can affect the functionality of the Unzer plugin. We recommend that before using or updating them, and after each update, you check for any changes on your test system.

Step 1: Generate your API keys

Request test and live API key pairs for your Unzer merchant account.

Step 2: Install the plugin

  1. Install the plugin from GitHub using Composer.

  2. Run the following command from the shop root directory.

       composer require unzerdev/oxid7
    
  3. Provide write access to /var/ directory during execution.

Step 3: Activate the plugin

  1. Go to Extensions > Modules.

    OXIX 7 plugins

  2. Select Unzer Payment > Overview > Activate.

    OXIX 7 plugins

    Alternatively, you can also activate the plugin in command line/shell.

       vendor/bin/oe-console oe:module:activate unzer_payment
    

    To learn more, see OXID documentation.

Step 4: Configure the plugin

  1. In the shop backend, go to Extensions > Modules and select Unzer Payment.

    OXID 7 plugin settings

  2. Navigate to Settings > Main Settings.
  3. Select the Mode for the plugin.
  4. Specify the key pairs.
  5. Select the Log Level for your plugin.
  6. In the Extended Settings section, specify the booking mode for the payment methods that support both authorize and charge.
    icon
    You can only test the authorize booking mode in the sandbox environment. The charge booking mode is available in the production environment.
  7. (Optional) Select the checkbox for activating Click to Pay for card payments.
  8. Select Save.
  9. In the Webhooks section, select Register webhook.

The webhooks are now available in the list as shown here:

OXID 7 booking mode

Next steps

See also