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

{
  "success": true,
  "message": "Coupon verified successfully",
  "data": {
    "coupon": {
      "id": 123,
      "code": "K1234567890",
      "status": "active",
      "expiry_time": "2025-01-31T23:59:59Z",
      "is_pending": false,
      "pending_shop_id": null,
      "offer": {
        "id": 456,
        "title": "Free Coffee",
        "description": "Get a free coffee with your stamp card",
        "discount_type": "game_reward",
        "reward_type": "free_product",
        "reward_details": "Free medium coffee"
      }
    },
    "user": {
      "id": 789,
      "name": "Jonas Jonaitis",
      "email": "[email protected]",
      "phone": "+37060000000",
      "default_card_id": 456,
      "points_balance": 150
    },
    "card": {
      "id": 456,
      "card_number": "123-456-789",
      "user_id": 789,
      "points_balance": 150
    },
    "points_rules": {
      "points_enabled": true,
      "points_redemption_enabled": true,
      "points_per_euro": 1,
      "euro_per_point": 0.01
    },
    "games_count": 3,
    "coupons_count": 2
  }
}

​
Verify Coupon

Verify a coupon by scanning its code or QR code. This endpoint is used by POS systems to validate coupons before redemption.
This endpoint uses Partner API authentication (X-API-Key and X-API-Secret headers).

​
Request Body

​
coupon_code
string
required
The coupon code or QR code scanned from the customer’s app
​
shop_id
integer
required
The ID of the shop where the coupon is being verified

​
Response

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

{
  "success": true,
  "message": "Coupon verified successfully",
  "data": {
    "coupon": {
      "id": 123,
      "code": "K1234567890",
      "status": "active",
      "expiry_time": "2025-01-31T23:59:59Z",
      "is_pending": false,
      "pending_shop_id": null,
      "offer": {
        "id": 456,
        "title": "Free Coffee",
        "description": "Get a free coffee with your stamp card",
        "discount_type": "game_reward",
        "reward_type": "free_product",
        "reward_details": "Free medium coffee"
      }
    },
    "user": {
      "id": 789,
      "name": "Jonas Jonaitis",
      "email": "[email protected]",
      "phone": "+37060000000",
      "default_card_id": 456,
      "points_balance": 150
    },
    "card": {
      "id": 456,
      "card_number": "123-456-789",
      "user_id": 789,
      "points_balance": 150
    },
    "points_rules": {
      "points_enabled": true,
      "points_redemption_enabled": true,
      "points_per_euro": 1,
      "euro_per_point": 0.01
    },
    "games_count": 3,
    "coupons_count": 2
  }
}

Redeem Coupon

Redeem the verified coupon

Get Card Coupons

Get all coupons for a customer