Integracje Stripe

Przyjmowanie płatności online przez Stripe: karty, Apple Pay, Google Pay.

1. Przegląd#

Stripe — globalna platforma płatnicza. W rejestrze Cenaly Stripe jest dostępny do integracji w 46 krajach. Integracje Cenaly + Stripe pozwalają:

• 💳 Przyjmować płatności kartami (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — płatność jednym dotknięciem
• 💰 Otrzymywać wypłaty na Twoje konto bankowe
• 🔄 Obsługiwać zwroty z panelu administracyjnego
• 💵 Napiwki — gość dodaje napiwek przy płatności
• 📊 Raporty — pełna analityka finansowa

2. Wymagania#

• ✅ Konto Cenaly (płatność online jest dostępna w każdym planie, także bezpłatnym)
• ✅ Konto Stripe (bezpłatna rejestracja na stripe.com)
• ✅ Konto bankowe do wypłat (w walucie Twojego kraju)
• ✅ Dokumenty do weryfikacji (paszport / ID, dokumenty firmy)

Obsługiwane kraje#

Stripe jest dostępny do integracji w 46 krajach:

3. Tworzenie konta Stripe#

Krok 1. Rejestracja#

1. Przejdź na stripe.com → Start now
2. Podaj email i utwórz hasło
3. Potwierdź email

Krok 2. Weryfikacja firmy#

Stripe poprosi o:

Weryfikacja zwykle zajmuje 1–3 dni robocze.

Krok 3. Uzyskaj klucze API#

1. W panelu Stripe: Developers → API keys
2. Skopiuj:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Integracja z Cenaly#

Podłączane jest Twoje własne konto Stripe: pieniądze gościa trafiają bezpośrednio na Twoje saldo Stripe, Cenaly ich nie przechowuje.

Otwórz Sklep z aplikacjami → kategoria „Finanse” → karta Stripe → „Skonfiguruj” — blok integracji otworzy się w oknie modalnym bezpośrednio w sklepie. Znana ścieżka też działa: Placówki → karta placówki → zakładka „Płatności” (sekcja „Płatność gościa”), przycisk „Podłącz” przy karcie Stripe.

Kreator integracji (zalecany)#

Kreator krok po kroku (≈10 minut) prowadzi przez cały proces, pokazując, gdzie klikać w panelu Stripe:

1. Wybierz tryb — testowy lub produkcyjny. Tryb w Stripe i przełącznik „Testowy / Produkcyjny” w Cenaly muszą się zgadzać.
2. Skopiuj klucze — Developers → API keys: Secret key (sk_test_… / sk_live_…) jest obowiązkowy, Publishable key (pk_…) — opcjonalny.
3. Dodaj webhook — Developers → Webhooks → Add endpoint, a w polu Endpoint URL wklej adres webhooka Cenaly, który kreator udostępnia przyciskiem „Kopiuj”. Bez webhooka Stripe nie poinformuje, że zamówienie jest opłacone, i zamówienie może pozostać w statusie „oczekuje”.
4. Wybierz zdarzenia — w bloku „Select events” koniecznie dodaj checkout.session.completed (właśnie ono potwierdza opłacenie zamówienia), a dla odroczonych metod płatności — także checkout.session.async_payment_succeeded i checkout.session.async_payment_failed. Następnie naciśnij „Add endpoint”. Bez tych zdarzeń webhook zostanie utworzony, ale nie poinformuje o płatności.
5. Skopiuj Webhook signing secret (whsec_…) — pole opcjonalne, ale z nim włącza się weryfikacja podpisu powiadomień.
6. Podłącz — wprowadzone wartości trafiają do zabezpieczonego backendu.

Krótki formularz#

Jeśli już wiesz, gdzie co jest w Stripe, otwórz formularz integracji inline i wypełnij te same pola: Secret key, Webhook signing secret (opcj.), Publishable key (opcj.) plus przełącznik trybu.

5. Konfiguracja metod płatności#

Karty bankowe#

Włączone automatycznie po podłączeniu Stripe:

• Visa / Mastercard — wszystkie kraje
• American Express — większość krajów
• Diners Club / Discover — wybiórczo

Apple Pay i Google Pay#

W Cenaly nie ma dla nich osobnych przełączników: płatność odbywa się na hosted stronie Stripe Checkout, dlatego portfele włącza się po stronie Stripe.

• Google Pay — działa od razu po podłączeniu Stripe (Android, Chrome).
• Apple Pay — Stripe wymaga potwierdzenia domeny: Settings → Payment methods → Apple Pay → Add new domain. Po weryfikacji przycisk pojawi się na iOS/Safari.

Inne metody#

W Stripe Dashboard można włączyć:

Włącz potrzebne metody w Stripe Dashboard → Settings → Payment methods.

6. Napiwki#

Konfiguracja#

1. Placówki → karta placówki → zakładka „Ogólne” → przełącznik „Napiwki”.
2. Jak to działa:

Jak widzi to gość#

Przy płatności po wybraniu dań:

Twoje zamówienie: 45₾

Dodać napiwek?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Inna kwota ]
[ Bez napiwku ]

RAZEM: 49.50₾   [Zapłać →]

Raporty napiwków#

Sekcja Finanse:

• zakładka „Przegląd” — łączna kwota napiwków za okres z porównaniem do poprzedniego;
• zakładka „Sprzedaż” — napiwki w podziale na kelnerów.

7. Wypłaty na Twoje konto#

Jak Stripe wypłaca pieniądze#

Gość płaci → Stripe pobiera → Po T+2 dniach → Pieniądze na Twoim koncie

Konfiguracja harmonogramu#

W Stripe Dashboard → Settings → Payouts:

• Codziennie (zalecane)
• Co tydzień (konkretny dzień tygodnia)
• Co miesiąc

8. Prowizje Stripe#

9. Zwroty#

Zwrot pieniędzy przez Stripe uruchamia się z dwóch miejsc — w zależności od tego, jak obsługiwano zamówienie.

Zwroty sklepu internetowego (RMA)#

1. Sekcja Zwroty → karta zgłoszenia.
2. Wybierz tryb zwrotu: na pierwotną metodę płatności (Stripe), kartą podarunkową (store credit) lub wymianą.
3. Zaznacz przedmioty (pełny lub częściowy zwrot) i zdecyduj, czy zwracać towar do magazynu.
4. Pieniądze wychodzą bezpośrednio ze strony; na kartę gościa trafiają zwykle w ciągu 5–10 dni roboczych.

Zwroty w kasie#

W POS zwrot jest realizowany na podstawie paragonu — pełny lub częściowy, jest też wymiana z odsprzedażą. Zmiana kasowa musi być przy tym otwarta.

W karcie zamówienia w sekcji Zamówienia widoczne są oznaczenia zrealizowanych zwrotów z linkiem do zgłoszenia.

10. Bezpieczeństwo#

PCI DSS#

• Cenaly nie przechowuje danych kart — wszystko przetwarza Stripe
• Stripe jest certyfikowany jako PCI Level 1 (najwyższy poziom)
• Dane kart są szyfrowane i tokenizowane

3D Secure#

• Automatyczna weryfikacja 3D Secure dla kart EU (SCA/PSD2)
• Zmniejsza oszustwa i chargebacki
• Dla gościa: potwierdzenie w aplikacji banku

Radar (ochrona przed oszustwami)#

Stripe Radar automatycznie blokuje podejrzane transakcje:

• Nietypowy wzorzec zakupów
• Karty z czarnych list
• Anomalie geolokalizacyjne

11. Testowanie#

Przed włączeniem na produkcji przetestuj:

Testowe karty Stripe#

CVV: dowolne 3 cyfry. Data: dowolna przyszła. ZIP: dowolny.

Jak testować#

1. Przy podłączaniu wybierz przełącznik „Tryb testowy” (każdy provider ma swój).
2. Użyj testowych kluczy (pk_test_..., sk_test_...) — oraz webhooka utworzonego w tym samym trybie testowym Stripe.
3. Złóż testowe zamówienie → zapłać testową kartą.
4. Sprawdź status zamówienia w sekcji Zamówienia — powinien zmienić się na „Opłacone”.
5. Gdy wszystko działa — podłącz providera ponownie z kluczami produkcyjnymi w trybie „Produkcyjny”.

12. Alternatywni dostawcy#

Dla krajów bez Stripe lub jako uzupełnienie — gotowe do podłączenia:

Jeszcze 94 dostawców (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay i in.) jest już na liście, ale wyświetla się na szaro — integracja jest jeszcze testowana. Pełny przegląd — w sekcji Płatności.

Podłączenie dowolnego dostawcy: Sklep z aplikacjami → kategoria „Finanse” → karta dostawcy → „Skonfiguruj”, albo znaną ścieżką Placówki → karta placówki → zakładka „Płatności”.

13. Częste pytania#

Kiedy otrzymam pieniądze?#

Po 2 dniach roboczych od płatności (T+2). Pierwsza wypłata może zająć 7–14 dni (dopóki Stripe weryfikuje konto).

Gość chce zapłacić gotówką — co zrobić?#

Metody „gotówką” i „kartą przy odbiorze” są dostępne zawsze i nie wymagają dostawcy płatności — gość wybiera je przy finalizacji zamówienia, a rozliczenie przeprowadza kasjer. Stripe nie jest przy tym używany; paragon jest wystawiany na kasie, jeśli masz podłączony sprzęt fiskalny (zob. Fiskalizacja).

Czy można podłączyć i Stripe, i BOG iPay?#

Tak. W zakładce „Płatności” można włączyć kilka dostawców jednocześnie — przy finalizacji zamówienia gość zobaczy po jednym przycisku dla każdego, podpisanym nazwą dostawcy.

Stripe zablokował konto — co zrobić?#

1. Sprawdź email — Stripe przesyła przyczynę
2. Zwykle wymagana jest dodatkowa weryfikacja
3. Skontaktuj się z Stripe Support: support.stripe.com
4. Na czas blokady można użyć alternatywnego dostawcy

Jak zminimalizować prowizję?#

• Zachęcaj do płatności kartami EU (1,5% zamiast 2,9%)
• Używaj SEPA dla dużych kwot (0,35€ stała opłata)
• Przy dużym obrocie (>100K€/mies.) — poproś Stripe o indywidualny plan

14. Wsparcie#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → temat „Stripe / Płatność”
• Stripe Status: status.stripe.com (sprawdzenie działania)