Testowanie Płatności w Sklepie Minecraft

Jak testować zakupy w ItemShopie Minecraft. Sandbox Stripe, symulacja zamówień i testowanie webhooka – bez użycia prawdziwych pieniędzy.

Przed otwarciem sklepu minecraft (itemshop) dla graczy konieczne jest sprawdzenie, czy zakupy rang VIP i itemów poprawnie wywołują komendy na serwerze – Creepia dostarcza tryb sandbox oraz narzędzie do ręcznej symulacji zamówień właśnie w tym celu. Dzięki testowaniu bez prawdziwych pieniędzy masz pewność, że wszystko działa zanim pierwszy gracz dokona zakupu.

Przed oficjalnym otwarciem sklepu dla graczy, zdecydowanie zalecamy przeprowadzenie kilku testowych transakcji. Pozwoli to upewnić się, że wtyczka poprawnie wykonuje komendy, a bramki płatnicze są prawidłowo skonfigurowane.

Tryb Testowy (Sandbox)

Większość operatorów (HotPay, Przelewy24, Stripe) oferuje tzw. Sandbox mode. Creepia pozwala na łatwe przełączenie się w ten tryb.

W panelu Creepia przejdź do Ustawienia → Bramki płatności, wybierz skonfigurowaną bramkę i kliknij Edytuj. Znajdź przełącznik Tryb testowy i włącz go.
Użyj kluczy testowych (Test Keys) zamiast produkcyjnych.
Podczas zakupu skorzystaj z danych testowych podanych przez operatora (np. specjalny numer karty Stripe: 4242 4242 4242 4242).

Dane testowe Stripe

Numer karty: 4242 4242 4242 4242

Data ważności: dowolna przyszła (np. 12/28)

CVC: dowolne 3 cyfry (np. 123)

Ta karta symuluje udaną płatność bez dodatkowych kroków.

Numer karty: 4000 0000 0000 0002

Data ważności: dowolna przyszła

CVC: dowolne 3 cyfry

Ta karta symuluje odrzucenie przez wystawcę karty - użyteczna do testowania obsługi błędów.

Numer karty: 4000 0025 0000 3155

Data ważności: dowolna przyszła

CVC: dowolne 3 cyfry

Ta karta symuluje płatność wymagającą weryfikacji 3D Secure (uwierzytelnienie przez bank).

Symulacja Zakupu (Panel Creepia)

Jeśli chcesz przetestować wyłącznie egzekucję komend na serwerze (bez przechodzenia przez bramkę płatniczą), możesz skorzystać z funkcji Symulacja Zakupu w Panelu Administracyjnym:

Przejdź do zakładki Zamówienia.

Kliknij przycisk Utwórz Zamówienie Ręczne.

Wybierz produkt i wpisz nick gracza (np. swój własny).

Zatwierdź zamówienie. System natychmiast wyśle sygnał do wtyczki CreepiaBridge, aby wykonać powiązane komendy.

Testowanie webhooka

W modelu BYOK webhooki przychodzą od Twojej bramki płatniczej bezpośrednio do Creepii na produkcji. Jednak przy lokalnym rozwoju lub debugowaniu możesz skierować je na własny serwer.

Stripe CLI

Stripe udostępnia narzędzie CLI, które przekierowuje webhooki ze Stripe bezpośrednio na lokalny serwer:

stripe listen --forward-to localhost:8080/webhooks/stripe/{shopId}

Po uruchomieniu CLI wyświetli webhook signing secret (whsec_...) - wpisz go jako Webhook Secret w konfiguracji bramki Stripe w panelu Creepia.

ngrok (dla dowolnej bramki)

Jeśli chcesz przetestować webhooki HotPay, Przelewy24 lub CashBill lokalnie, użyj ngrok, aby wystawić swój lokalny serwer na internet:

ngrok http 8080

Skopiuj wygenerowany URL (np. https://abc123.ngrok.io) i wklej go zamiast domyślnego URL webhooka Creepia w panelu swojej bramki płatniczej.

W środowisku produkcyjnym Creepia automatycznie obsługuje wszystkie webhooki od bramek płatniczych. Testowanie lokalnego webhooka jest opcjonalne i zalecane wyłącznie dla deweloperów integrujących własne rozszerzenia lub debugujących problemy z konfiguracją bramki.

Co sprawdzić podczas testów?

Czy po udanym zakupie w konsoli serwera Minecraft pojawiają się logi o wykonaniu komend?
Czy gracz otrzymał przedmioty/rangę w grze (nawet jeśli był offline w momencie zakupu)?
Czy status zamówienia w panelu zmienił się na COMPLETED?
Czy wiadomość o zakupie została rozesłana na czacie (jeśli taką skonfigurowałeś)?

Pamiętaj o wyłączeniu Trybu Testowego przed udostępnieniem sklepu graczom! W przeciwnym razie gracze będą mogli "kupować" przedmioty za darmo, używając danych testowych.

Diagnostyka: Rozwiązywanie problemów z połączeniem

Nie masz jeszcze własnego sklepu? Załóż darmowy ItemShop na Creepia.com w 3 minuty.

Testowanie Płatności w Sklepie Minecraft – Sandbox