POST
/
{locale}
/
shop
/
coupons
/
{id}
/
redeem
curl -X POST "https://staging-api.loyalty.lt/en/shop/coupons/501/redeem" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "purchase_amount": 25.99,
    "items": [
      {
        "product_id": "COFFEE_LARGE",
        "quantity": 2,
        "price": 4.50
      },
      {
        "product_id": "PASTRY_CROISSANT",
        "quantity": 1,
        "price": 2.99
      }
    ]
  }'

{
  "success": true,
  "message": "Coupon redeemed successfully",
  "data": {
    "redemption": {
      "coupon_id": 501,
      "discount_applied": 5.20,
      "final_amount": 20.79,
      "redemption_code": "REDEEM-ABC123-2024",
      "redeemed_at": "2024-01-15T16:45:00Z"
    }
  }
}

​
Redeem Coupon

Redeem a previously claimed coupon to apply its benefits during a purchase. This endpoint validates the coupon and applies the discount or benefit.
Coupons can only be redeemed once and must be used before their expiration date. Some coupons have minimum purchase requirements.

​
Path Parameters

​
locale
string
required
Language code for localized content (e.g., “en”, “lt”)
​
id
integer
required
Unique identifier of the coupon to redeem

​
Request Body

​
purchase_amount
number
required
Total purchase amount in euros
​
items
array
Items being purchased (for validation)

​
Response

​
success
boolean
Indicates if the coupon was successfully redeemed
​
data
object
curl -X POST "https://staging-api.loyalty.lt/en/shop/coupons/501/redeem" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "purchase_amount": 25.99,
    "items": [
      {
        "product_id": "COFFEE_LARGE",
        "quantity": 2,
        "price": 4.50
      },
      {
        "product_id": "PASTRY_CROISSANT",
        "quantity": 1,
        "price": 2.99
      }
    ]
  }'

{
  "success": true,
  "message": "Coupon redeemed successfully",
  "data": {
    "redemption": {
      "coupon_id": 501,
      "discount_applied": 5.20,
      "final_amount": 20.79,
      "redemption_code": "REDEEM-ABC123-2024",
      "redeemed_at": "2024-01-15T16:45:00Z"
    }
  }
}

​
Redemption Process

1

Validation

System validates coupon status, expiration, and purchase requirements
2

Discount Calculation

Discount amount is calculated based on coupon type and purchase
3

Application

Discount is applied and final amount is calculated
4

Confirmation

Redemption is recorded and confirmation code is generated

List Coupons

View available coupons

Claim Offer

Claim offers to get coupons