Skip to main content
POST
/
{locale}
/
shop
/
coupons
/
redeem
curl -X POST "https://staging-api.loyalty.lt/en/shop/coupons/redeem" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "coupon_id": 123,
    "shop_id": 1,
    "selected_product_id": 456
  }'

{
  "success": true,
  "message": "Coupon redeemed successfully",
  "data": {
    "coupon_id": 123,
    "redeemed_at": "2025-01-15T14:30:00Z",
    "shop_id": 1
  }
}

​
Redeem Coupon

Redeem a verified coupon to apply its benefits. This permanently marks the coupon as used.
This endpoint uses Partner API authentication (X-API-Key and X-API-Secret headers). The coupon must be verified first using the verify endpoint.

​
Request Body

​
coupon_id
integer
required
The ID of the coupon to redeem (obtained from verify endpoint)
​
shop_id
integer
required
The ID of the shop where the coupon is being redeemed
​
selected_product_id
integer
Product ID if the coupon requires product selection
​
notes
string
Optional notes about the redemption (max 255 characters)

​
Response

​
success
boolean
Indicates if the coupon was successfully redeemed
​
data
object
curl -X POST "https://staging-api.loyalty.lt/en/shop/coupons/redeem" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "coupon_id": 123,
    "shop_id": 1,
    "selected_product_id": 456
  }'

{
  "success": true,
  "message": "Coupon redeemed successfully",
  "data": {
    "coupon_id": 123,
    "redeemed_at": "2025-01-15T14:30:00Z",
    "shop_id": 1
  }
}

Verify Coupon

Verify coupon before redemption

Set Pending

Reserve a coupon before redeeming