Admins make promo codes for a package (Admin → Promókódok: batch, note, copy all), list them filtered (unused by default, used, revoked; by package; by code, note or redeemer) and withdraw unused ones. A logged-in user redeems a code once (header link, /bevaltas?kod=... prefilled, packages page, and the analysis and question offers point there) and gets the package as an order with source 'promo'. Failed redemptions are rate limited. Production purchases are off: MOCK_PAYMENTS now defaults to false in the deploy compose, so package cards say 'Hamarosan'. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2.5 KiB
2.5 KiB
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.
- a fejléc „Kód beváltása” linkje (
- Kitöltött link: a
sorsfonalak.hu/bevaltas?kod=ABCD-EFGH-JKLMlink 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_orderssorpromoforrással, 0 Ft-tal, és mellette a szokásoscredit_ledgersorok. - 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 |