Skip to main content
Produkt nie musi wykonywać komend na serwerze gry. W każdym sklepie — także typu ogólnego (general, np. licencje, boty Discord, zasoby FiveM, kursy) — możesz sprzedawać treść cyfrową, którą ItemShop wydaje sam, zaraz po opłaceniu zamówienia. Plugin nie jest do tego potrzebny, a zamówienia z treścią cyfrową nie trafiają do jego kolejki.

Cztery rodzaje dostawy

W formularzu produktu wybierasz rodzaj dostawy: Notatka do kluczy lub pliku jest dołączana do wydanej treści — dobre miejsce na instrukcję aktywacji. Treść wiadomości i notatki jest zapisywana zaszyfrowana.
Klucze, plik i wiadomość dodajesz po pierwszym zapisaniu produktu. Komendy realizacji są dla rodzajów cyfrowych opcjonalne.

Klucze licencyjne

Pula kluczy należy do produktu — albo do wariantu, jeśli sprzedajesz warianty (wariant bez własnej puli korzysta ze wspólnej). Klucze dodajesz:
  • wklejając listę — jedna linia = jeden klucz,
  • ładując plik CSV — kolumna key, klucz lub code (a gdy jej nie ma, pierwsza kolumna).
Duplikaty są pomijane. Lista kluczy w panelu jest zamaskowana i pokazuje liczniki puli: dostępne, wydane. Klucze, które jeszcze nie zostały wydane, możesz usunąć pojedynczo albo zbiorczo; wydanych nie da się usunąć. Pełną pulę wyeksportujesz do CSV (wymaga uprawnienia do zarządzania produktami, eksport jest zapisywany w dzienniku). Jedno zamówienie może zawierać do 100 kluczy.

Gdy klucze się skończą

Jeśli kupujący zapłaci, a pula jest pusta, zamówienie dostaje stan oczekuje na dostawę (awaiting_stock). Ty dostajesz jedno powiadomienie. Gdy dodasz klucze, brakujące sztuki są dosyłane automatycznie w kolejności zamówień (FIFO), a kupujący dostaje je na stronie zamówienia i e-mailem. Próg niskiego stanu ostrzega Cię, zanim pula się wyczerpie.

Plik do pobrania

Plik trafia do prywatnego magazynu — nigdy do publicznego CDN. Kupujący dostaje podpisany link, który:
  • wygasa po ustawionym czasie,
  • ma limit pobrań — każde otwarcie linku zużywa jedno pobranie,
  • odpowiada z kodem 410, gdy wygasł lub limit został wyczerpany.
Plik wgrywasz z panelu (do 25 MB). Przy dłuższych materiałach wystaw w pliku odnośnik do własnego hostingu i użyj rodzaju Wiadomość.

Co widzi kupujący

  1. W kasie podaje e-mail — dla produktów cyfrowych jest wymagany (także w sklepie typu game).
  2. Po opłaceniu zamówienie od razu przechodzi w zrealizowane, a strona zamówienia pokazuje klucze, link do pobrania albo wiadomość. Odbiór wymaga numeru zamówienia i klucza statusu z adresu strony zamówienia — nie wystarczy sam numer.
  3. Osobny e-mail z treścią (niezależny od potwierdzenia zamówienia) trafia na podany adres. Treść jest renderowana dopiero przy wysyłce.
Zamówienie z kilku pozycji (cyfrowych i zwykłych) zachowuje się jak zawsze: każda pozycja jest realizowana osobno — zobacz Zamówienia.

Zwroty, spory i anulowanie

Zwrot, spór (chargeback) albo anulowanie unieważniają wydane klucze (nie wracają do puli) i link do pobrania. Kupujący przy próbie odbioru dostaje informację, że dostawa została cofnięta.

Akcje na zamówieniu

W szczegółach zamówienia z treścią cyfrową (uprawnienie do zarządzania zamówieniami) widzisz wydaną treść oraz stan e-maila i pobrań — każde takie wyświetlenie jest zapisywane w dzienniku. Możesz też:
  • wysłać treść ponownie (do 5 razy na godzinę dla zamówienia),
  • wysłać ją z nowym linkiem do pobrania — poprzedni link przestaje działać.

Dla deweloperów

Strona sklepu pobiera dane o dostawie ze Storefront API: produkt ma pole deliveryKind, status zamówienia zawiera delivery, a treść odbiera się z endpointu dostawy. Treść „wiadomości” renderuj jako zwykły tekst, nie HTML. Panel i integracje serwerowe zarządzają pulą kluczy i plikiem przez API sklepu (sekcja Digital delivery w referencji).

Produkty

Ceny, warianty i komendy realizacji.

Zamówienia

Statusy, grupy płatności i ręczne akcje.