Program lojalnościowy
w Medusie
Punkty za każde zamówienie tam, gdzie prowadzisz sklep: jeden punkt za jednostkę wartości zamówienia, drabinka nagród, z której klient odbiera, historia realizacji i ręczne korekty w panelu, a stan punktów klienta w sklepie. Hurtownia trzyma klientów blisko: każde zamówienie zbiera, każda nagroda przywołuje z powrotem.
Co dokładnie
robi ta integracja
-
Punkty za zamówienie
Złożone zamówienie daje wartość razy punkty za złotówkę, ze skalą mnożnika tieru klienta. Idempotentnie per zamówienie; importy z marketplace'ów są pomijane.
-
Drabinka nagród
Nagrody z opcji, od najtańszej. Panel i sklep pokazują, którą nagrodę klient może odebrać jako następną, więc do celu widać z góry.
-
Realizacja punktów
Klient wymienia punkty na nagrodę albo rabat po kursie wymiany; realizacja zapisuje się w księdze i w historii konta, raz.
-
Ręczne korekty
Bonusy i korekty z panelu, zawsze z powodem i z wyszukiwarką klienta. Księga zostaje kompletna, nawet gdy punktów przybywa ręcznie.
-
Punkty klienta w sklepie
Saldo, suma zebranych, zaoszczędzona kwota, odebrane nagrody i ostatnie transakcje przez API sklepu – klient widzi swoje konto bez logowania do panelu.
-
Stare tabele nienaruszone
Tabele loyalty_account i loyalty_transaction trzymają nazwy i kształt oryginalnego modułu, więc sklepy, które go miały, przenoszą wiersze; migracja dodaje tylko flagę demo.
Jak pilnuje
Twoich danych
-
Punkty dokładnie raz
Naliczanie idempotentne per zamówienie: powtórzone zdarzenie nie doda punktów drugi raz.
-
Księga zamknięta
Każda transakcja ma powód: zamówienie, realizacja albo korekta z opisem. Saldo zawsze da się odtworzyć z księgi.
-
Demo oddzielone
Konta i transakcje przykładowe oznaczone flagą demo, więc dane pokazowe nigdy nie mieszają się z prawdziwymi punktami klientów.
Instalacja
w trzech krokach
Pełna lista opcji, zdarzeń i tras API jest w README paczki na GitHubie.
Wklej do Claude Code, Cursora albo innego asystenta AI w swoim projekcie Medusy: zainstaluje i skonfiguruje integrację, z zapisami wyłączonymi.
- 1 Zainstaluj paczkę z npm.
npm install @koda-plus/medusa-plugin-loyalty - 2 Dopisz wtyczkę do medusa-config.ts.
plugins: [ { resolve: "@koda-plus/medusa-plugin-loyalty", options: { // Everything is optional. pointsPerPln: 1, redeemRate: 0.05, rewards: [ { at: 1500, name: { en: "50 off", pl: "Rabat 50 zł" } }, { at: 3000, name: { en: "Free 18V drill", pl: "Wkrętarka 18V gratis" } }, ], // demo: process.env.LOYALTY_DEMO === "true", }, }, ] - 3 Uruchom migracje i otwórz integrację w panelu Medusy.
npx medusa db:migrate
Pracuje u naszych klientów
Zobacz realizacje
Pozostałe
integracje
- Allegro Oferty, zamówienia, stany i przesyłki
- BaseLinker Karty, stany, ceny i zamówienia w obie strony
- Subiekt nexo Zamówienia jako ZK, WZ i faktury z KSeF
- Fakturownia Faktury, korekty i KSeF dokładnie raz
- InPost Paczkomaty, kurier i pobranie na API ShipX
- OLX Ogłoszenia zgodne ze stanem sklepu
- Stripe Obrót, opłaty, spory i zdrowie konta
- Negocjacje Cena docelowa, kontroferta, akceptacja
- Kredyt kupiecki Limity, terminy i salda klientów
- Opakowania Sztuka, karton, paleta, minimum i krok
- Zgodność UE GPSR, RODO i Omnibus w jednym panelu
- Biała lista VAT NIP, VIES i REGON w jednym panelu
- E-maile Gotowe szablony po polsku i angielsku
- Zadania Zadania przy zamówieniach, produktach i klientach
Opowiedz nam o swoim projekcie,
resztę dopasujemy pod Ciebie
15 minut rozmowy wystarczy, abyśmy wiedzieli, czy pasujemy do Twojego projektu.
Zaczynamy od Twoich potrzeb, nie od gotowego rozwiązania.