Dokumentacja EpicPay

1. Pierwsze kroki

EpicPay to sklep dla serwerów Minecraft: strona sklepu dla graczy, płatności przez Twoje bramki i automatyczne wydawanie zakupów przez plugin na serwerze. Pierwszy sklep uruchomisz w kilka minut:

1. Załóż konto w panelu EpicPay albo zaloguj się kontem EpicHost.
2. Utwórz sklep: podaj nazwę i wybierz darmowy adres w domenie ep-is.eu.
3. Dodaj tryby gry i produkty z komendami, które ma wykonać serwer.
4. Podłącz co najmniej jedną bramkę płatności.
5. Wgraj plugin EpicPay na serwer i wpisz w config.yml dane sklepu.
6. Wyślij graczom link do sklepu.

Zakładka Przegląd sklepu pokazuje, czego jeszcze brakuje do startu: produktów, bramki albo połączenia pluginu.

2. Konto i logowanie

Do EpicPay logujesz się na jeden z dwóch sposobów:

• Kontem EpicHost - to samo konto działa w EpicHost, EpicNetwork i EpicPay. Hasło, weryfikację dwuetapową i adres e-mail zmieniasz w koncie EpicHost.
• Osobnym kontem EpicPay - e-mail i hasło EpicPay; możesz też logować się przez Google, Discord albo GitHub i włączyć weryfikację dwuetapową w profilu.

Jeśli masz osobne konto EpicPay i zalogujesz się kontem EpicHost z tym samym adresem e-mail, konta połączą się. Sklepy, pakiet i portfel zostają, a od tej chwili logujesz się już tylko kontem EpicHost.

W Profilu zmienisz dane rozliczeniowe, język panelu i powiadomienia, a także zobaczysz aktywne sesje i historię aktywności.

3. Sklep: adres i ustawienia

Każdy sklep dostaje darmowy adres, np. twojserwer.ep-is.eu, wybierany przy zakładaniu sklepu. Od pakietu Pro podepniesz też własną domenę: w ustawieniach sklepu wpisz domenę i dodaj u swojego dostawcy DNS rekord CNAME wskazany w panelu (rekordy A nie są obsługiwane).

W Ustawieniach sklepu ustawisz nazwę, logo, IP serwera, linki do Discorda i innych serwisów, regulamin i politykę prywatności sklepu, a także klucze do pluginu i API.

Sklep możesz wyłączyć w ustawieniach. Wyłączony albo zablokowany przez obsługę sklep nie przyjmuje zakupów.

4. Tryby gry i produkty

Tryby gry (np. Survival, SkyBlock) grupują produkty w sklepie. Każdy produkt ma nazwę, cenę, opis, ikonę i listę komend.

Komendy wpisujesz po jednej w wierszu. Plugin wykona je po opłaceniu zamówienia, podstawiając:

lp user {player} parent addtemp vip 30d
broadcast {player} kupił rangę VIP!

Od pakietu Start ustawisz harmonogram, czyli czas, w którym produkt jest widoczny (np. promocja na weekend). Limity liczby trybów gry i produktów zależą od pakietu.

5. Bramki płatności

Pieniądze z zakupów trafiają prosto na Twoje konto u operatora płatności. EpicPay nie pośredniczy w rozliczeniach, dlatego potrzebujesz własnej umowy z operatorem.

Bramkę podłączasz w zakładce Bramki płatności sklepu: wpisz klucze z panelu operatora, sprawdź połączenie przyciskiem testu i włącz bramkę. Przy każdej bramce panel pokazuje instrukcję i adres powiadomień (webhook), który trzeba wpisać u operatora. W jednym sklepie może działać kilka bramek naraz.

Każda płatność trafia do zakładki Transakcje razem z graczem, bramką, kwotą i statusem dostawy. Listę wyeksportujesz do pliku CSV.

6. Plugin i dostawy

Plugin EpicPay wgrywasz do folderu plugins serwera Minecraft. Dane do pliku config.yml znajdziesz w panelu: Ustawienia sklepu → Plugin.

shop_uuid: "UUID-twojego-sklepu"
api_secret: "sekret-z-panelu"

• Po opłaceniu zamówienia plugin pobiera je z EpicPay i wykonuje komendy produktu, także gdy nie ma Cię przy komputerze.
• Jeśli tryby gry działają na osobnych serwerach, każdy z nich może pobierać tylko zakupy swojego trybu (parametr mode_uuid).
• Status każdej dostawy widzisz w panelu; dostawę wyślesz ponownie jednym kliknięciem.
• Klucz api_secret traktuj jak hasło. Jeśli wycieknie, wygeneruj nowy w ustawieniach sklepu.

Zakładka Przegląd pokazuje, czy plugin łączy się z EpicPay na każdym trybie gry. Gdy zakup długo czeka na dostarczenie, dostaniesz powiadomienie.

7. Wygląd i szablony

Do wyboru są trzy szablony: Starter (w każdym pakiecie), Origin i Fusion (od pakietu Pro). Szablon zmienisz w zakładce Wygląd sklepu, a przed zmianą obejrzysz go przyciskiem Podgląd. Szablony na żywo zobaczysz też na stronie Funkcje.

W każdym szablonie ustawisz logo i favicon, kolor akcentu i przycisków, tekst nagłówka, IP serwera z licznikiem graczy, linki do Discorda, YouTube i TikToka oraz zaokrąglenie kart.

8. Języki sklepu

Sklep działa po polsku, angielsku, niemiecku, czesku i ukraińsku. Gracz widzi go w języku swojej przeglądarki i może go zmienić w rogu strony. Interfejs sklepu tłumaczy EpicPay, a nazwy i opisy produktów zostają takie, jak je wpiszesz.

Jeden język działa w każdym pakiecie, kilka naraz od pakietu Pro.

9. Vouchery, ogłoszenia, cel serwera i podstrony

• Vouchery - rabat procentowy, kwotowy albo darmowy produkt, z limitem użyć, datą ważności i blokadą jednego użycia na gracza.
• Ogłoszenia - komunikaty na górze sklepu z własnym kolorem i terminem wyświetlania.
• Cel serwera (od pakietu Start) - pasek zbiórki na stronie sklepu, liczony sam z opłaconych zakupów.
• Podstrony (od pakietu Start) - własne strony w sklepie, np. zasady serwera albo opis rang.

10. Ekipa

W zakładce Ekipa zaprosisz administratorów serwera do panelu sklepu. Każdej osobie nadajesz dostęp tylko do wybranych sekcji, np. produktów albo transakcji. Zaproszenie przychodzi e-mailem. Liczba osób w ekipie zależy od pakietu.

11. Powiadomienia i statystyki

O każdym zakupie EpicPay powiadomi Cię na Discordzie (webhook kanału), e-mailem i dzwonkiem w panelu. W pakiecie Pro dochodzą podsumowania sprzedaży. Wiadomość na Discord obejrzysz i przetestujesz w ustawieniach sklepu.

Zakładki Przegląd i Przychody pokazują ruch w sklepie, przychody z ostatnich dni i najlepiej sprzedające się produkty. W pakiecie Business masz też dziennik zmian: kto i kiedy zmienił produkt, cenę albo ustawienia.

Własną aplikację lub bota podłączysz przez API i webhooki.

12. Pakiety i portfel

EpicPay ma pakiety Free, Start, Pro i Business. Różnią się limitami (sklepy, tryby gry, produkty, vouchery, ogłoszenia, ekipa, podstrony) i funkcjami. Porównanie i aktualne ceny znajdziesz w cenniku.

Pakiet opłacasz z portfela na 7, 30, 60 albo 120 dni. Portfel doładujesz w panelu. Gdy pakiet wygaśnie, konto wraca do pakietu Free.

13. Pomoc

Nie ma tu odpowiedzi na Twoje pytanie? Napisz przez formularz kontaktowy, na contact@epicpay.eu albo na Discordzie. Jeśli masz już sklep, podaj adres e-mail konta i nazwę sklepu.