Configuring coupon rewards for custom-built websites

Configuring coupon rewards for custom-built websites

Overview

For businesses running custom-built websites, Zoho Thrive supports coupon-based rewards through a configurable endpoint. Using the Coupon Configuration feature, you can set up a Request URL that allows Thrive to send coupon and redemption details to your website whenever a reward is redeemed. Your website can then process this request and generate or apply the coupon within your store.

This approach enables custom-built websites to seamlessly support rewards in Zoho Thrive while allowing the website to manage coupon creation and application.

Prerequisites

Before configuring coupon rewards, ensure the following requirements are met:

• Your custom-built website is integrated with Zoho Thrive.
• A Request URL endpoint is available to receive coupon and redemption details sent from Thrive.

Note: The Coupon Configuration tab will only appear in the Settings page after a custom-built website integration is completed.

Configuring the request URL

Open coupon configuration

1. Go to Settings in Zoho Thrive.
2. Navigate to Coupon Configuration.
3. Click Configure Now.

Add the request URL

1. In the Request URL field, enter the endpoint where your website can receive coupon and redemption details.
2. Configure the Payload fields to define the data, your endpoint should receive from Thrive when a reward is redeemed.
3. Add the required Headers to support authentication and authorization for the endpoint.
4. Click Test API to verify the configuration, or select Add Configuration to save it.

Creating custom coupon rewards

Once the request URL is configured, you can start creating Rewards.

1. Navigate to Points -> Rewards -> +Add Reward.
2. Select the required reward type.
3. Configure the reward details and click Add Reward.

These rewards can be then redeemed by customers through the loyalty widget in the online store, or you can redeem through the customer profile in Thrive.

Redeeming a coupon reward

When a customer redeems a coupon reward:

1. Thrive sends the coupon and redemption details to the configured Request URL.
2. Your custom website processes the request.
3. The website generates or applies the coupon on its end.

Response handling

Your endpoint should return a response to indicate whether the request was processed successfully.

Status Code 200 or 201

Thrive treats the request as successful and the reward redemption is completed.

Any other response

Thrive displays an error message asking the user to contact the administrator.