> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reward vouchers

In Engage, a contact's points can be converted into a voucher which can then be used to make purchases. Here's how to integrate Engage reward vouchers into your Shopify flow.

## Prerequisites

Before integrating reward vouchers, ensure the following:

* The Voyado Engage app for Shopify is installed and connected to your Shopify store
* An API key has been generated in Engage to allow secure communication between Shopify and Engage
* The Rewards module is enabled in your Engage environment (check this with your Voyado AM)

<Warning>
  A customer's vouchers (and promotions) are only synced when they visit a page containing the **Promotions & Loyalty App Block**, or during **Shopify Checkout** when they enter their email. If the app block is placed, for example, on the **My Account** page, vouchers will only sync when the customer visits that page. To ensure proper syncing, add the app block to all necessary locations on your Shopify site where vouchers should be updated.
</Warning>

Read more about the Checkout extension here:

<Card title="Learn about the Checkout extension" href="/docs/ecom/shopify/promotions-vouchers-in-checkout" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/developer-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=36f1df27b0269657d842f3301d440083" horizontal width="128" height="128" data-path="icons/developer-link.png" />

### Enable voucher sync

1. Access App Settings:
   * Log in to your Shopify Admin panel.
   * Navigate to **Apps** and select the **Voyado Engage** app.
2. Configure Voucher Sync:
   * Within the app settings, locate and enable the **Loyalty voucher sync** option.
3. Combination options - Choose whether a voucher can be combined with:
   * Product discounts
   * Order discounts
   * Shipping discounts

<Frame>
  <img src="https://mintcdn.com/voyado-partners/VQryVDa-4xsk8asc/images/shopify/shopify-reward-vouchers-01.gif?s=210de03d3d6a8996be4f2486d24f6081" alt="shopify-reward-vouchers-01" width="1012" height="560" data-path="images/shopify/shopify-reward-vouchers-01.gif" />
</Frame>

### Create and sync vouchers in Engage

This function lets you convert points to Engage vouchers for eligible customers.

<Card title="Learn about converting points to vouchers" href="https://help.engage.voyado.com/hc/en-gb/articles/17234946364444" icon="https://mintlify.s3.us-west-1.amazonaws.com/voyado-partners/icons/developer-help-center.png" horizontal />

When the customer logs into Shopify, the voucher will be created as a Shopify discount.

The **Promotions & Loyalty App Block** will then display the IDs of available vouchers, allowing customers to use them in the discount code field during checkout.

### Redeem vouchers in Shopify

The voucher appears as a fixed amount discount in Shopify.

If a voucher is reactivated in Engage, it will re-sync the next time the customer logs in.

The voucher can be used at checkout and will be redeemed in Engage once used.

## Testing and Troubleshooting

To test reward vouchers:

* Create a test voucher in Engage
* Conduct trial purchases to verify the integration's functionality

If vouchers are not applying correctly, verify that **currency conversion** is correctly configured in Engage.

Ensure also that the **Promotions & Loyalty App Block** is placed on all necessary pages in your web shop to properly trigger the syncing.