# StillDream Pay

[!badge variant="primary" text="Polecane dla klientów StillDream"]

Hostujesz serwer w [StillDream](https://stilldream.pl)? Z StillDream Pay pieniądze ze sklepu trafiają **prosto na saldo Twojego konta hostingowego**. Opłacisz nimi odnowienie albo większy plan serwera — bez przelewów i czekania na wypłatę.

1. Gracz kupuje w Twoim sklepie, np. VIP za 25 zł.
2. Płaci na bezpiecznej stronie `stilldream.pl/pay/…`.
3. Saldo Twojego konta StillDream rośnie o 25 zł, a komendy trafiają na serwer.

## Wymagania

- Konto na [stilldream.pl](https://stilldream.pl).
- Sklep w walucie **PLN**.
- Kwota zamówienia od **1 zł** do **10 000 zł**.

## Podłączenie

### 1. Utwórz sklep w StillDream

1. Zaloguj się na [stilldream.pl](https://stilldream.pl/dashboard/shops) i otwórz **Integracja / API**.
2. Kliknij **Nowy sklep** i nadaj mu nazwę. Pole **Adres webhooka** możesz na razie zostawić puste.
3. Skopiuj **token API** (zaczyna się od `sd_`) i **sekret webhooka** (`whsec_`).

!!!warning Token widzisz tylko raz
Jeśli go zgubisz, wygeneruj nowy w panelu StillDream i podmień go w StillShop.
!!!

### 2. Wklej dane w StillShop

1. W panelu StillShop otwórz **Płatności → StillDream Pay**.
2. Wklej **Token API sklepu** i **Sekret webhooka**.
3. Zostaw włączone **Pokazuj graczom** i kliknij **Zapisz StillDream Pay**. Panel sprawdzi, czy token działa.

### 3. Ustaw adres webhooka

Po zapisie karta StillDream Pay pokaże adres powiadomień, np.:

```
https://stillshop.pl/api/payments/webhook/cm3x…
```

Skopiuj go, wróć na stilldream.pl → **Integracja / API**, edytuj swój sklep i wklej go jako **Adres webhooka**. Od teraz zamówienia potwierdzają się od razu po zapłacie.

!!!
Bez webhooka płatność też się potwierdzi — gdy gracz wróci ze strony płatności. Webhook potrzebny jest na wypadek, gdyby gracz zamknął kartę wcześniej.
!!!

## Bezpieczeństwo

- Każde powiadomienie z StillDream jest podpisane (HMAC-SHA256 sekretem `whsec_`) i odrzucane, jeśli podpis się nie zgadza lub jest starszy niż 5 minut.
- Niezależnie od powiadomienia StillShop zawsze odczytuje status płatności z API StillDream, zanim wyda produkt.

## Saldo i rozliczenia

Saldo, historię wpłat i ewentualne zwroty obsługuje StillDream zgodnie ze [swoim regulaminem](https://stilldream.pl/regulamin). Saldo sprawdzisz na [stilldream.pl/dashboard/wallet](https://stilldream.pl/dashboard/wallet).

Dokumentacja API po stronie StillDream: [docs.stilldream.pl → API sklepu](https://docs.stilldream.pl/platnosci/api-sklepu/).