API Ví Voucher & Ưu đãi Thành viên

Quản lý danh sách voucher cá nhân mà hội viên sở hữu (bao gồm thông tin hạn sử dụng, trạng thái đã đổi hay chưa và chi tiết ưu đãi) trên ứng dụng zodutcan-user.

---

1. Lấy danh sách Voucher trong Ví

Lấy toàn bộ voucher thuộc sở hữu của hội viên trong bảng member_voucher kèm thông tin trạng thái sử dụng thực tế.

• Method: GET
• Endpoint: /api/{locale}/v1/member/vouchers
• Auth: auth:member_api (Bearer Token)

Query Parameters

Tham số	Kiểu	Mặc định	Mô tả
status	string	all	Lọc theo trạng thái: active (khả dụng), expired (đã hết hạn), hoặc all.
claimed_via	string	null	Lọc theo nguồn nhận: qr_scan, link, email, manual.

Response Thành công

{
  "data": [
    {
      "id": "019b8d48-voc-100k",
      "name": "Voucher Giảm 100.000đ",
      "description": "Áp dụng cho hoá đơn từ 500.000đ tại tất cả chi nhánh",
      "code": "ZDC100K-9X82Y",
      "discount_type": "fixed",
      "amount": 100000,
      "min_spend": 500000,
      "club": {
        "id": "019b8d48-club-hcm",
        "name": "Zodutcan Saigon Center"
      },
      "wallet": {
        "claimed_via": "qr_scan",
        "saved_at": "2026-05-15T10:00:00.000000Z",
        "valid_until": "2026-06-30T23:59:59.000000Z",
        "is_expired": false,
        "is_expiring_soon": false,
        "is_redeemed": false,
        "redemption_count": 0,
        "last_redeemed_at": null,
        "last_redemption_status": null
      }
    }
  ],
  "total": 1
}

---

2. Chi tiết Voucher & Mã Barcode/QR Đổi tại Quầy

Xem chi tiết 1 voucher cụ thể khi hội viên bấm vào voucher card từ ví.

• Method: GET
• Endpoint: /api/{locale}/v1/member/vouchers/{voucherId}
• Auth: auth:member_api (Bearer Token)

Response Thành công

{
  "id": "019b8d48-voc-100k",
  "name": "Voucher Giảm 100.000đ",
  "code": "ZDC100K-9X82Y",
  "qr_url": "https://api-zodutcan.datacomtech.vn/api/vi/v1/staff/vouchers/validate?code=ZDC100K-9X82Y",
  "discount_type": "fixed",
  "amount": 100000,
  "min_spend": 500000,
  "terms": "Áp dụng cho hoá đơn ăn tại chỗ. Không quy đổi tiền mặt.",
  "wallet": {
    "valid_until": "2026-06-30T23:59:59.000000Z",
    "is_redeemed": false
  }
}