> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Points Redemption Integration

> Learn how to integrate Gameball’s redemption options to turn customer loyalty points into real rewards.

# Overview

Redemption is a pivotal Gameball feature that transforms customer loyalty points into tangible rewards.\
By integrating redemption options, businesses can boost repeat purchases and foster customer loyalty.

This guide walks you through:

* How redemption works
* The two implementation paths available
* How to choose the right one for your setup

***

## What is the Concept of Redemption?

Redemption enables customers to **convert their accumulated points into valuable rewards**, such as discounts or free shipping.

### Example Scenario

> **Adam**, a loyal customer of your food delivery business, has accumulated **1,000 points** after 10 orders.\
> You can reward Adam by allowing him to redeem his points for:
>
> * **A direct discount** applied at checkout
> * 10% off Coupon
> * Any other coupon types supported by Gameball

✨ **Business Impact:** Redemption not only delivers tangible value but also encourages repeat purchases and long-term engagement.

***

## Redemption Flow (Customer Journey Overview)

Redemption is not just a technical process; it’s a **key customer moment** in the loyalty journey.\
Here’s how it typically unfolds across your app or website:

### 1. Earn Points Through Engagement

Customers accumulate points by completing various actions on your platform:

* Placing an order
* Referring a friend
* Writing a review
* Completing a campaign challenge

> **Example:** Adam earns **1,000 points** after placing an order worth $1,000 (1 point per $1 spent).

***

### 2. Discover & Redeem Points

When Adam returns to place a new order, he finds available redemption options.

At this stage, your UI (cart page, rewards center, or profile widget) can present **two redemption paths**, depending on your configuration.

**Option A: Pay with Points**

Customers can instantly apply their available points as a **direct discount at checkout**, similar to using store credit. The system calculates the eligible discount and applies it to the cart total in real time.

<img src="https://mintcdn.com/gameball/Ifr8C8KddQYXUZxR/images/direct-redemption-4.gif?s=7eee3f009836ff69826b995a3cc743cf" alt="Direct Redemption 4 Gi" title="Direct Redemption 4 Gi" className="mx-auto" style={{ width:"57%" }} width="512" height="267" data-path="images/direct-redemption-4.gif" />

<Card title="Direct Points redemption at checkout" icon="coins" href="/tutorials/experiences/points-redemption/pay-with-points" cta="To start implementing, checkout this tutorial" />

**Option B: Convert Points into a Reward or a Coupon:**

Customers can choose to exchange their points for a **reward**, such as a coupon code or other configured benefit. The redeemed reward can then be applied manually during checkout.

<img src="https://mintcdn.com/gameball/tbHJ33JKkFfY2kVp/images/couponredemption-ezgif.com-video-to-gif-converter.gif?s=556cff6c61f9d36653fe0677f10ca40a" alt="Couponredemption Ezgif Com Video To Gif Converter Gi" title="Couponredemption Ezgif Com Video To Gif Converter Gi" className="mx-auto" style={{ width:"41%" }} width="800" height="1178" data-path="images/couponredemption-ezgif.com-video-to-gif-converter.gif" />

<Card title="Convert Points to Coupons" icon="badge-percent" href="/tutorials/experiences/points-redemption/convert-points-to-coupons" cta="Learn how through this tutorial" />

<Tip>
  You can enable either or both redemption paths based on your desired flexibility and promotional strategy.
</Tip>

***

### 3. Discount Confirmed, Order Placed

Once the discount (direct or via coupon) is applied, Adam proceeds to place his order, feeling rewarded and more likely to return.

<img src="https://mintcdn.com/gameball/tbHJ33JKkFfY2kVp/images/A_flowchart_in_the_image_illustrates_a_customer_lo.png?fit=max&auto=format&n=tbHJ33JKkFfY2kVp&q=85&s=ec8b8a9a50822905c798d1cea4cc133b" alt="A Flowchart In The Image Illustrates A Customer Lo Pn" title="A Flowchart In The Image Illustrates A Customer Lo Pn" style={{ width:"48%" }} className="mx-auto" width="1024" height="1024" data-path="images/A_flowchart_in_the_image_illustrates_a_customer_lo.png" />

***

## Summary

| Redemption Type              | Ideal For                              | User Experience   | Setup Complexity |
| ---------------------------- | -------------------------------------- | ----------------- | ---------------- |
| **Direct Points Redemption** | Seamless checkouts, instant value      | Instant discount  | Moderate         |
| **Coupon-Based Redemption**  | Promotions, campaigns, tiered programs | Coupon-based flow | Flexible         |

<Tip>
  Combine both redemption paths to offer maximum flexibility, instant gratification through points, and promotional control via coupons.
</Tip>

***

## Related Resources

<CardGroup cols={2}>
  <Card title="Pay with Points Tutorial" icon="coins" href="/tutorials/experiences/points-redemption/pay-with-points">
    Implement direct checkout redemptions
  </Card>

  <Card title="Convert Points to Coupons" icon="badge-percent" href="/tutorials/experiences/points-redemption/convert-points-to-coupons">
    Explore coupon-based reward flows
  </Card>

  <Card title="Hold Points API" icon="hand" href="/api-reference/transactions/hold-management/hold">
    Reserve points while the order is pending
  </Card>

  <Card title="Generate Coupon API" icon="ticket" href="/api-reference/coupons/generate-coupon">
    Turn points into coupons with Gameball’s engine
  </Card>
</CardGroup>