# Redeem loyalty points for a reward

Allows a customer to redeem their loyalty points for a specific reward option. This deducts points from their balance and generates a discount code or applies the reward.

What happens:
1. Validates customer has enough points
2. Deducts points from customer's balance
3. Generates discount code (for discount rewards)
4. Records redemption in customer's history
5. Returns discount code or confirmation

Reward Types:
- Discount codes: Generates unique code customer can use at checkout
- Auto-apply discounts: Automatically applied to next order
- Free products: Adds free product to next order
- Free shipping: Waives shipping on next order

Important Notes:
- Points are deducted immediately and cannot be refunded
- Discount codes typically expire after 30 days
- Some rewards have minimum purchase requirements
- Rewards cannot be combined with other discounts (depends on configuration)

Use Cases:
- Customer clicks 'Redeem' button in customer portal
- Apply points at checkout
- Redeem points for subscription discount

Authentication: Customer must be logged in via Shopify customer session

Endpoint: POST /subscriptions/cp/api/loyalty-integration/redeem
Version: 0.0.1

## Query parameters:

  - `customerId` (string, required)
    Customer ID (Shopify GraphQL ID format)
    Example: "gid://shopify/Customer/6548267876558"

  - `redeemOptionId` (integer, required)
    ID of the redemption option to redeem
    Example: 1

  - `points` (integer)
    Number of points to redeem (for variable point redemptions)


## Response 200 fields