# Workflows

## New Loyalty Sign-Ups

When a new customer signs up, their info is taken from Apparel21 and either put into Shopify or added directly to the loyalty platform. This makes sure that no matter where they shop, their data is saved. It means customers can earn and use their loyalty points whether they're in the store or online.

<figure><img src="/files/uaxULxsso2X3QWWM8oZw" alt=""><figcaption><p><em>Diagram shows the <strong>Yotpo</strong> flow for new customer signup and loyalty enrolment. <strong>Clearer.io</strong> merchants follow the same overall shape - the loyalty platform endpoints differ, and the <strong>Clearer.io</strong> setup is confirmed at onboarding. Contact the DotApparel team for details.</em></p></figcaption></figure>

## Loyalty Tiers

When it comes to syncing loyalty tiers, DotApparel is consistently working behind the scenes, constantly "listening" for changes in a customer's loyalty status. Additionally, the app assists in updating the customer with vital information, such as their current tier status and tier expiry date.

<figure><img src="/files/nojzSAl87KSo3BRHI5Ax" alt="" width="375"><figcaption><p><em>Diagram shows the <strong>Yotpo</strong> flow for syncing in-store purchase points between Apparel21 and the loyalty platform. <strong>Clearer.io</strong> merchants follow the same overall shape - the loyalty platform endpoints and webhook topics differ. Contact the DotApparel team for the <strong>Clearer.io</strong> setup.</em></p></figcaption></figure>

## Rewards Redemption

DotApparel Loyalty provides customers a way to redeem their accumulated loyalty points through Apparel21 Vouchers which can be used both in-store and online.

#### **Apparel21 Gift Vouchers ($ Off)**

Customers with accumulated loyalty points can choose to redeem them for Apparel21 Vouchers. The process involves retail staff assistance, customer sign-in/sign-up on the loyalty program website, voucher generation through the DotApparel Loyalty app, and voucher redemption at POS. This option allows customers to receive unique vouchers with specific discounts or benefits, which can be applied in-store or online.

{% hint style="info" %}
To enable rewards redemption through **Apparel21 Gift Vouchers**, merchants need to set up E-vouchers within Apparel21. This allows the DotApparel Loyalty app to generate vouchers for customers when they choose to redeem their points for vouchers.
{% endhint %}

<figure><img src="/files/dtbqWF3uFRKWyd4IcxuH" alt="" width="375"><figcaption><p><em>Diagram shows the <strong>Yotpo</strong> flow for redeeming loyalty points, including the <strong>Yotpo Javascript SDK</strong> and <strong>Custom Reward</strong> webhook event. <strong>Clearer.io</strong> merchants follow the same overall shape - the redemption rule type and integration mechanism are confirmed at onboarding. Contact the DotApparel team for details.</em></p></figcaption></figure>

## **Setting up rewards on your loyalty platform**

Reward setup differs slightly between platforms. The DotApparel team will guide you through the right configuration during onboarding.

**For Yotpo merchants:** when setting up Direct Rewards in your Yotpo account, select the coupon type **Custom Reward**. DotApparel Loyalty only supports the "Custom Reward" coupon type on Yotpo, because redeeming these custom rewards will not generate Shopify discount codes - preventing customers from accidentally redeeming rewards and receiving benefits twice.

<figure><img src="/files/jQcYeX5zxpZ1P3UEqXY3" alt=""><figcaption><p><em>The picture shows the <strong>Yotpo</strong> configuration</em></p></figcaption></figure>

DotApparel Loyalty only supports the "Custom Reward" coupon type. This is because redeeming these custom rewards will not generate Shopify discount codes, preventing customers from accidentally redeeming rewards and receiving benefits twice.

<figure><img src="/files/pcpMSB47BRRy5nOP9nLY" alt=""><figcaption><p><em>The picture shows the <strong>Yotpo</strong> configuration</em></p></figcaption></figure>

**For Clearer.io merchants:** the equivalent rule type and configuration is confirmed at onboarding. Contact the DotApparel team for the recommended setup.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dotapparel.com.au/loyalty/data-sync/workflows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
