Promo & Voucher

Dokumentasi API untuk mencari promo yang tersedia, validasi kode voucher, dan kalkulasi diskon dalam transaksi.

Endpoint Overview

1. List Active Promos

Mendapatkan daftar promo yang saat ini sedang berlangsung dengan filter platform.

• URL: /promos
• Method: GET
• Headers:
  • Authorization: Bearer {{token}}
  • X-Platform: web atau mobile-app (Required).
• Query Parameters:
  • status: active, upcoming, atau expired.
  • promo_source: atourin atau partner.
• Response (200 OK): Mengembalikan array promo dengan detail discount_type (Fixed/Percentage) dan daily_quota.

2. Check Promo Validity (Fase 4)

Memastikan apakah suatu promo dapat digunakan oleh pengguna. Backend melakukan validasi mendalam terhadap sisa kuota harian dan kuota personal user.

• URL: /promos/check
• Method: POST
• Body (JSON):

{
  "code": "HEMATBARENG"
}

• Response (200 OK):

{
  "id": "uuid-01",
  "code": "HEMATBARENG",
  "discount_value": 10000.0,
  "discount_per_item": true,
  "daily_quota": 50,
  "status": "active"
}

Aturan Kalkulasi:

• Multiplier: Jika discount_per_item bernilai true, maka total diskon adalah discount_value * total_quantity_tiket.
• Quota: Perhatikan daily_quota. Promo mungkin gagal jika batas harian sudah tercapai meskipun kuota global masih tersedia.

🔥 Uji Coba API (Simulator)

Gunakan simulator di bawah ini untuk mencoba seluruh endpoint di atas secara langsung. Anda dapat mengubah URL, Method, Headers, dan Body sesuai kebutuhan.