commercetools

By integrating Voucherify with your commercetools store, you can start offering personalized promo codes and other campaigns with custom redemption limits, unavailable in the standard commercetools instance. These include:

• Dynamic discounts that change value based on order total and other attributes.
• Proportional discounts.
• Multi-tiered double and single-sided referral campaigns.
• Advanced product and order-specific discounts, including free product offers and BOGO.

In the near future, we plan to extend the integration to include product variants for unit type discounts and cart promotions with customer segments to unlock the full potential of commercetools promotions.

Before continuing, you can also watch our webinar and learn how Voucherify integrates with commercetools.

Contents

1. Supported features
2. How does the integration work?
3. Install and configure the plugin
4. Use Voucherify coupon codes
5. Track performance
6. Troubleshooting

Supported features

Before you start creating promo campaigns for your commercetools audience, please read the below summary of Voucherify features that we support in the plugin and make sure your use cases are covered.

How does the integration work?

Voucherify and commercetools integration is based at checkout. commercetools fetches Voucherify API to validate and redeem the promo code.

1. Voucherify returns the result and applies the discount to the order (to the cart, items, or triggers another behavior based on the discount effect).
2. Once the order is paid, the code is redeemed, and the commercetools order and customer data are synced with Voucherify.

How to install and configure the plugin?

To start with, follow the steps outlined in the Github repository.

Use Voucherify coupons in your commercetools store

Now, your visitors can redeem Voucherify coupon codes to get a discount while shopping in your commercetools store. The workflow looks as follows:

1

A customer selects products to add to their cart.

2

In a cart summary, they can see a field for a coupon code.

 

3

The customer enters a Voucherify code, and after choosing  Apply, their order is automatically updated.

 

4

You can see redeemed coupons in your Merchant Center dashboard. Go to the Orders List section and choose which order you'd like to display.

If any coupon has been applied, you'll see it in the order items. 

Tracking your performance 

Once the plugin is configured, you will be able to use promo codes. For more tracking data, you can visit the Voucherify dashboard. In the Redemptions, Customers and Orders sections, Voucherify collects and presents detailed, up-to-date information. You can read more about tracking in this guide.

Troubleshooting

In case you encounter any issues while working with the plugin, you can debug your integration and find the issues using commercetools logs or Voucherify logs.

• commercetools logs – logs can be found in the Merchant Center. To view the logs, navigate to the Audit log > Change history. Read more here.

• Voucherify logs – if you want to know how Voucherify reacted to the request, you can find that information under the Audit Logs in Voucherify. To view the logs, navigate to the Audit log. You can learn more about Voucherify’s logs by following this tutorial.