Setup | How to use Voucherify with Magento

Note: The Voucherify Magento extension only works with Magento 2.

Installing the Voucherify extension

  1. Go to the Magento Marketplace to install the Voucherify extension.
  2. Pick the edition (open source) and store version then add the app to the cart. Click on the cart on the top right-hand side of the page and click "Proceed to checkout".
  3. Fill in the required information and place the order. (There should be no cost and no requirement to enter billing details.)
  4. Click the "Install" button.
  5. Select the option to create a new access key.
  6. In the message box that pops up, enter a name for this access key (e.g. Voucherify).
  7. You will then see that Magento has created a public and a private key under the name that you have provided.
  8. Install the plugin. We recommend performing the installation using the command line (CLI). The CLI is considered the appropriate way to expertly manage installations. During the installation, follow these steps:
    su-exec nginx composer require voucherify/integration:1.0.0
    su-exec nginx composer update voucherify/integration
    su-exec nginx ./bin/magento module:status
    su-exec nginx ./bin/magento module:enable Voucherify_Integration --clear-static-content
    su-exec nginx ./bin/magento setup:upgrade
    su-exec nginx ./bin/magento setup:di:compile
    su-exec nginx ./bin/magento module:status
    su-exec nginx ./bin/magento cache:clean

Configuring the Voucherify extension

Once the plugin has been successfully installed, go to your Magento account, then go to Stores > Configuration and expand the Voucherify option from the left menu.


  1. The extension configuration consists of:
    1. General configuration
    2. API configuration 

General configuration

  • Apply voucher on: here you need to define what price components will be discounted:
    • Only subtotal
    • Subtotal including shipping
    • Subtotal including taxes
    • Subtotal including shipping and taxes.
  • Prevent Order Creating: This setting controls what happens if a customer uses an invalid voucher.
    • Yes: an order won't be created
    • No: an order will be created, but without a discount.

API configuration

  1. Application API settings
  2. Client Side API settings

These fields should be completed with the application IDs and secret keys from the Voucherify dashboard found in your Voucherify account, under Project settings > Application keys and Project settings > Client-side keys.


You can now save your configuration changes.

Your Magento store should now have the Voucherify coupon box displayed in the “Review & Payments” section of the order, beneath the payment options.

There, the customer can enter their discount code, promotion code or gift card code and apply the discount.

If the customer decides they do not want to use it at this point, they can still cancel it and keep the voucher unused.

How it works

Now that your Voucherify and Magento accounts are connected, data is synced in real time, so every time an order that contains a promotional code appears in Magento, it is subsequently created in Voucherify.

Along with the order, the associated customer and products will also be created in Voucherify if they don't already exist. 

Your customers can now enter Voucherify coupon codes and gift cards when purchasing in your Magento store. 

The customer does not need to have the gift card associated with their record - so any gift card can be used by anyone.

The customer cannot opt to only use part of their gift card or voucher code, e.g. spend $20 out of $50 balance, but if the order value is less than the gift card’s balance, the gift card balance is adjusted accordingly.

The customer cannot use multiple gift cards to pay for their purchase.

The same principles apply to coupon codes (e.g. $15 off, 10% off entire purchase).

Coupon codes that include conditions (e.g. buy a minimum of two to get 20%, spend $100 to get $10 off) cannot be used in integrated eCommerce channels.

Have more questions? Submit a request