37 lines
2.5 KiB
Markdown
37 lines
2.5 KiB
Markdown
# Promókódok
|
||||
|
|
|
|||
|
|
Amíg a fizetés nincs bekötve, a csomagokat promókóddal (és admin ajándékkal) lehet megkapni. Élesben a vásárlás ki van kapcsolva: a `MOCK_PAYMENTS` alapértéke a `deploy/docker-compose.yml`-ben `false`. A csomagkártyákon ilyenkor „Hamarosan” felirat áll.
|
|||
|
|
|
|||
|
|
## Admin: Admin → Promókódok
|
|||
|
|
|
|||
|
|
- **Kódkészítés:**
|
|||
|
|
- Csomag (a fő csomagok és a kiegészítők közül), darab (1–500) és egy megjegyzés: kinek szól, melyik kampány.
|
|||
|
|
- Az elkészült kódok egy listában jelennek meg, a „Mind másolása” gombbal kimásolhatók.
|
|||
|
|
- A kód formája `ABCD-EFGH-JKLM`: 12 karakter, összetéveszthető betűk és számok nélkül (nincs 0/O, 1/I/L).
|
|||
|
|
- **Lista:**
|
|||
|
|
- Szűrhető állapotra: **fel nem használt** (ez az alapértelmezés), beváltott, visszavont, mind.
|
|||
|
|
- Szűrhető csomagra, és kereshető kódrészletre, megjegyzésre vagy a beváltó e-mail-címére.
|
|||
|
|
- A beváltott kódnál látszik, ki és mikor váltotta be.
|
|||
|
|
- **Visszavonás:** fel nem használt kódot vissza lehet vonni. Utána nem váltható be.
|
|||
|
|
|
|||
|
|
## Felhasználó: beváltás
|
|||
|
|
|
|||
|
|
- **Hol lehet beváltani:**
|
|||
|
|
- a fejléc „Kód beváltása” linkje (`/bevaltas`);
|
|||
|
|
- a Csomagok oldal „Van promókódod?” doboza;
|
|||
|
|
- a részletes elemzés ajánlata és a kérdés-válasz rész is ide vezet, ha nincs felhasználható egység.
|
|||
|
|
- **Kitöltött link:** a `sorsfonalak.hu/bevaltas?kod=ABCD-EFGH-JKLM` link kitöltve nyitja meg a kódot. Aki nincs belépve, a belépés után ide tér vissza. Elég ezt a linket elküldeni a meghívottaknak.
|
|||
|
|
- **Beírás:** a kód kis- vagy nagybetűvel, kötőjellel vagy anélkül is beírható.
|
|||
|
|
- **Beváltás:** a csomag azonnal jóváíródik. Ez egy `package_orders` sor `promo` forrással, 0 Ft-tal, és mellette a szokásos `credit_ledger` sorok.
|
|||
|
|
- **Egyszer:** egy kód egyszer váltható be. A „már felhasználták”, „már nem érvényes” és „nincs ilyen kód” esetekre külön üzenet van.
|
|||
|
|
- **Találgatás ellen:** 10 sikertelen próbálkozás után a felhasználó negyed óráig nem próbálkozhat.
|
|||
|
|
|
|||
|
|
## API
|
|||
|
|
|
|||
|
|
| Végpont | Ki | Mit csinál |
|
|||
|
|
|---|---|---|
|
|||
|
|
| `POST /v1/admin/promo-codes` `{package, count, note?}` | admin | kódok készítése |
|
|||
|
|
| `GET /v1/admin/promo-codes?status=unused\|used\|revoked\|all&package=&q=&limit=&offset=` | admin | lista |
|
|||
|
|
| `POST /v1/admin/promo-codes/{id}/revoke` | admin | visszavonás |
|
|||
|
|
| `POST /v1/promo-codes/redeem` `{code}` | belépett felhasználó | beváltás; a válaszban az új egyenleg és a csomag |
|