If you’re interested in using the commercetools integration, visit Voucherify’s main Commercetools connector repository and Gift card connector repository.
- 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.
Open sourcecommercetools plugin is open source. This means that you can build custom functionalities on top of it based on your unique business needs.
The integration with CommerceTools uses** API limits **for sending code validation and redemption from Voucherify to CommerceTools and vice versa.
Supported features
Before you start creating promo campaigns for your commercetools audience, read the below summary of Voucherify features that we support in the plugin and make sure your use cases are covered.- Amount discount coupons.
- Percentage discount coupons.
- Fixed amount discount coupons.
- Unit discount coupons – add free items to orders.
- Free shipping coupons.
- Syncing products, customers, and orders.
- Validation sessions – temporarily lock the voucher’s usage until redemption is successful, which is helpful for coupons with limited use.
- Stackable validation and stackable redemption – allow customers to use up to 30 incentives at the same time.
- Partial redemption – allow customers to redeem only the applicable incentives in a stack even if it includes incentives that fail validation.
- Validation rules – coupons are valid only for select scenarios based on cart or order attributes.
- Discount effects – define how to apply the discount to the customer’s cart
- Loyalty and referral programs.
- Cart-level discounts.
- Gift cards.
- Unit discount coupons – support for product variants (SKUs).
How does the integration work?
Voucherify and commercetools integration is based at checkout. commercetools fetches Voucherify API to validate and redeem the promo code.- Voucherify returns the result and applies the discount to the order (to the cart, items, or triggers another behavior based on the discount effect).
- Once the order is paid, the code is redeemed, and the commercetools order and customer data is synced with Voucherify.
How to install and configure the plugin?
You will need credentials to use both Voucherify and commercetools.| Service | Description |
|---|---|
| Voucherify | Voucherify account and API keys – you can find your API keys in Project Settings → Application Keys. Read more here. |
| commercetools | commercetools account with API client and API keys – available when a new API Client is created. Create it in Settings → Developer Settings → Create new API client using the Admin client scope template. Read more in the commercetools documentation. |
Use Voucherify coupons in your commercetools store
Your visitors can redeem Voucherify coupon codes to get a discount while shopping in your commercetools store. The workflow is as follows:- A customer selects products to add to their cart.
- In a cart summary, they can see a field for a coupon code.
- The customer enters a Voucherify code, and after choosing Apply, their order is automatically updated. Applied discounts are also visible on a checkout page and order summary.
- 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.