Płatności i Podatki

Moduł płatności i podatków umożliwia integrację z bramkami płatniczymi, konfigurację stawek VAT oraz obsługę wielu walut.

Bramki Płatności

DoSwiftly obsługuje najpopularniejsze polskie bramki płatności.

PayU

Najpopularniejsza bramka płatności w Polsce.

Konfiguracja PayU

Ustawienia → Płatności → PayU → Połącz

Pole	Skąd pobrać
Merchant POS ID	Panel PayU → Punkty płatności
Signature Key	Panel PayU → Punkty płatności → Klucze
OAuth Client ID	Panel PayU → Moje sklepy → OAuth
OAuth Client Secret	Panel PayU → Moje sklepy → OAuth
Środowisko	Sandbox (testy) / Produkcja

Testowanie PayU

Użyj środowiska Sandbox do testów:

1. Zarejestruj się w PayU Sandbox
2. Utwórz punkt płatności testowy
3. Pobierz klucze API
4. Skonfiguruj w DoSwiftly z trybem "Sandbox"
5. Testuj płatności z kartami testowymi

Obsługiwane Metody PayU

• Karty płatnicze – Visa, Mastercard, American Express
• Szybkie przelewy – wszystkie polskie banki
• BLIK – płatność jednym kodem
• Raty – PayU Raty (bez BIK)
• Odroczona płatność – PayU Pay Later

Przelewy24

Alternatywna bramka płatności należąca do PayPro.

Konfiguracja Przelewy24

Ustawienia → Płatności → Przelewy24 → Połącz

Pole	Skąd pobrać
Merchant ID	Panel P24 → Dane techniczne
POS ID	Panel P24 → Dane techniczne
CRC Key	Panel P24 → Dane techniczne → Klucz CRC
API Key	Panel P24 → API → Klucz API
Środowisko	Sandbox / Produkcja

Obsługiwane Metody Przelewy24

• Karty płatnicze
• Przelewy bankowe – wszystkie polskie banki
• BLIK
• Google Pay / Apple Pay
• Visa Mobile

Metody płatności - kolejność dostawców, widoczność i opłaty

DoSwiftly wspiera method-centric wybór płatności - Twoi klienci widzą jeden kafel „BLIK" nawet jeśli masz skonfigurowane oba PayU i Przelewy24 wspierające BLIK. To Ty decydujesz, który dostawca obsłuży transakcję.

Ustawienia → Płatności → zakładka „Metody płatności"

Zakładka pokazuje jedną hierarchię: metoda → dostawcy → formy płatności. Dla każdej metody (BLIK, Karta, Przelew bankowy, Portfel cyfrowy, Raty, Płatność przy odbiorze) widzisz listę dostawców, którzy potrafią ją obsłużyć:

• Kolejność ustalasz przeciągając bloki dostawców - płatność obsłuży pierwszy dostawca z widoczną formą (nosi plakietkę „Preferowany"). Nie ma osobnego pola „priorytet"; kolejność na ekranie jest dokładnie kolejnością rozstrzygania w kasie.
• Jedna kontrolka: „Widoczna w kasie" przy każdej formie płatności. Udział dostawcy w metodzie wynika z niej wprost - dostawca obsługuje metodę, gdy choć jedna jego forma jest widoczna; schowasz wszystkie - wypada z metody.
• Dostawcy wyłączeni w zakładce „Dostawcy" nie pojawiają się na tej liście - panel wymienia ich w jednej nocie nad grupami.
• Plakietka „Wyłączone u dostawcy" - bramka tymczasowo wyłączyła formę po swojej stronie (incydent/maintenance); Twoja konfiguracja zostaje i wróci do kasy automatycznie.

Pod każdym dostawcą wymienione są jego formy płatności w tej metodzie (np. pod „Przelewem bankowym" u Przelewy24 - komplet banków, zwinięty do jednego wiersza z licznikiem i rozwijaną listą). Przy każdej formie decydujesz:

• „Widoczna w kasie" - czy klient ją zobaczy (np. w Portfelu cyfrowym możesz zostawić PayPala, a schować Apple Pay). Gdy panel nie zna form dostawcy z imienia (lista zapasowa), ten sam przełącznik stoi na nagłówku bloku i przełącza całą metodę u tego dostawcy.
• Opłata - kwotowa (w walucie sklepu) albo procentowa (liczona od wartości zamówienia z dostawą). Kwota jest interpretowana zgodnie z trybem cen sklepu (brutto/netto - panel mówi to wprost nad listą).

Opłaty - czego pilnuje system

• Karty i portfele oparte na karcie (Apple Pay, Google Pay, Visa Mobile) nie mogą mieć dopłaty - zakazuje tego art. 38a ustawy o usługach płatniczych (wdrożenie dyrektywy PSD2). Panel pokazuje powód wprost przy wierszu i nie proponuje pola opłaty.
• Opłata nie może przekraczać kosztów, które sam ponosisz za daną formę płatności (art. 383¹ Kodeksu cywilnego) - wysokość ustalasz Ty, panel przypomina o limicie.
• Opłata równa zeru znaczy „brak opłaty" - nie pojawi się jako pusty wiersz w podsumowaniu.

Przykład: BLIK przez P24, karty przez PayU

W metodzie BLIK przeciągnij Przelewy24 na górę (albo schowaj formę BLIK u PayU); w metodzie Karta - odwrotnie. Efekt: klient klikający „BLIK" → transakcję obsłuży P24, klient klikający „Karta" → PayU.

Co widzi klient

Kupujący wybiera typ płatności (BLIK, karta, ...) - NIE widzi nazw bramek. To Ty decydujesz routing na podstawie kosztów, niezawodności, czasu rozliczeń. Klient może opcjonalnie nadpisać domyślny routing, wskazując konkretną bramkę (rzadkie, używane tylko w zaawansowanych storefrontach).

Live status z bramek

System co godzinę odpytuje bramki (PayU GET /paymethods, P24 GET /payment/methods/pl) o aktualną listę aktywnych form płatności. Jeśli bramka tymczasowo wyłączy BLIK (np. incident), zobaczysz plakietkę „Wyłączone u dostawcy" - Twoja konfiguracja zostaje, ale kasa nie pokaże tej formy klientom, dopóki bramka nie zacznie jej obsługiwać ponownie.

Soft-fail: jeśli bramka jest niedostępna, system użyje statycznej listy capabilities - checkout NIGDY nie zostanie zablokowany przez problem po stronie gateway.

Proces Płatności

Flow Zamówienia

1. Klient składa zamówienie w storefront
2. Wybiera metodę płatności (PayU / Przelewy24)
3. System tworzy zamówienie ze statusem Oczekujące
4. Klient przekierowywany do bramki płatności
5. Po udanej płatności:
   • Bramka wysyła powiadomienie do DoSwiftly (webhook)
   • System zmienia status na Opłacone
   • Klient otrzymuje email z potwierdzeniem
   • Merchant widzi zamówienie gotowe do realizacji

Statusy Płatności

Status	Opis
Oczekująca	Zamówienie utworzone, czeka na płatność
W trakcie	Klient w trakcie procesu płatności
Opłacone	Płatność zakończona sukcesem
Nieudana	Płatność odrzucona przez bank/bramkę
Anulowana	Płatność anulowana przez klienta
Zwrócona	Płatność zwrócona (refund)

Potwierdzenia Płatności

System automatycznie weryfikuje płatności przez:

• Webhooks – natychmiastowe powiadomienia z bramki
• Polling – okresowe sprawdzanie statusu (backup)
• Weryfikacja podpisu – zabezpieczenie przed fałszywymi powiadomieniami

ostrzeżenie

Nigdy nie zmieniaj statusu zamówienia na "Opłacone" ręcznie bez zweryfikowania płatności w panelu bramki!

Zwroty Płatności

Automatyczne Zwroty

Przy zwrocie zamówienia system może automatycznie zlecić refund:

Zamówienia → [Zamówienie] → Zwrot płatności

1. Wybierz kwotę do zwrotu (częściowa / pełna)
2. System wysyła request do bramki
3. Bramka przetwarza zwrot (1-7 dni roboczych)
4. Pieniądze wracają na kartę/konto klienta
5. Status zamówienia: Zwrócone

Ręczne Zwroty

Jeśli automatyczny zwrot nie działa:

1. Zaloguj się do panelu bramki (PayU/P24)
2. Znajdź transakcję
3. Wykonaj zwrot ręcznie
4. W DoSwiftly zmień status na "Zwrócone"

Podatki (VAT)

Konfiguracja Stawek VAT

Ustawienia → Podatki → Dodaj stawkę

Podstawowe Stawki w Polsce

Nazwa	Stawka	Zastosowanie
VAT 23%	23%	Większość towarów
VAT 8%	8%	Książki, czasopisma, usługi turystyczne
VAT 5%	5%	Żywność podstawowa, książki cyfrowe
VAT 0%	0%	Eksport, WDT (wewnątrzwspólnotowa dostawa)
ZW	0%	Towary zwolnione z VAT

Strefy Podatkowe

Strefa podatkowa grupuje kraje, w których obowiązują te same stawki VAT.

Ustawienia → Podatki → zakładka Strefy → Dodaj strefę

W oknie strefy podajesz Nazwę i wybierasz Kraje (co najmniej jeden). Pole wyboru krajów działa tak samo jak w strefach wysyłki: lista wszystkich krajów świata z nazwami w języku panelu, wyszukiwarka po nazwie lub kodzie kraju, przyciski Wszystkie i Kraje UE (dopisują kraje do wyboru) oraz Wyczyść. Wybrane kraje widać jako plakietki - pojedynczy usuniesz krzyżykiem. Na liście stref kraje są pokazane po nazwie, alfabetycznie.

W odróżnieniu od stref wysyłki strefa podatkowa może obejmować także Rosję, Białoruś i Koreę Północną - określa, gdzie obowiązuje stawka, a nie dokąd sprzedajesz. Sprzedaż do tych krajów blokują strefy wysyłki.

Jeśli zapisana strefa zawiera wartość, która nie jest rozpoznanym krajem (np. po imporcie z innego systemu), okno edycji pokaże ją w ostrzeżeniu „Część krajów nie może zostać w tej strefie" - zniknie ze strefy, gdy ją zapiszesz.

Przykładowe strefy:

Strefa: Polska

• VAT 23%, 8%, 5%, 0%

Strefa: Unia Europejska

• VAT kraju docelowego (reverse charge lub OSS)

Strefa: Poza UE

• VAT 0% (eksport)

Przypisanie VAT do Wariantu

Klasę podatkową ustawiasz na poziomie wariantu, nie całego produktu - tak samo jak cenę, SKU i kod EAN. Dzięki temu jeden produkt może mieć warianty o różnych stawkach (rzadkie, ale możliwe), a co najważniejsze: stawka zawsze idzie w parze z konkretną ceną.

Produkt bez wariantów (jeden wariant domyślny):

1. Otwórz produkt i znajdź w kolumnie głównej kartę Cena
2. W wierszu z SKU i kodem kreskowym wybierz klasę podatkową (np. „VAT 23%", „VAT 8%")
3. Zapisz

Produkt z kilkoma wariantami:

1. Na stronie produktu, w karcie Więcej, wejdź na podstronę Warianty
2. Otwórz wariant, który chcesz skonfigurować
3. Wybierz klasę podatkową w panelu wariantu
4. Zapisz

notatka

Selektor klasy podatkowej pojawia się dopiero wtedy, gdy sklep ma zdefiniowaną choć jedną klasę podatkową w Ustawienia → Podatki. Dopóki ich nie ma, wszystko liczy się domyślną stawką sklepu.

Jeśli nie wybierzesz klasy dla wariantu, system użyje domyślnej klasy podatkowej sklepu (oznaczonej jako domyślna w Ustawienia → Podatki). Dla większości sklepów oznacza to automatyczne 23%.

Towar zwolniony z VAT lub ze stawką 0%

Nie ma osobnego przełącznika „produkt zwolniony". Zwolnienie i stawkę 0% modelujesz jako klasę podatkową ze stawką 0% (np. „ZW" lub „VAT 0%") i przypisujesz ją do wariantu tak samo jak każdą inną klasę.

System automatycznie:

• Oblicza VAT przy zamówieniu per pozycja - koszyk może mieszać 23%, 8% i 0% jednocześnie
• Uwzględnia strefę podatkową klienta (kraj/region wg adresu dostawy)
• Zapisuje rozbicie VAT per stawka w zamówieniu (widoczne w panelu i w mailu potwierdzającym do klienta)

Faktury

Automatyczne wystawianie faktur VAT z poziomu platformy jest w przygotowaniu. Rozbicie VAT per stawka jest już zapisywane przy każdym zamówieniu, więc po uruchomieniu fakturowania faktury otrzymają prawidłowe stawki bez dodatkowej konfiguracji.

Ceny Brutto vs Netto

Ustawienia → Sklep → zakładka Ustawienia sklepu → grupa Podatki i ceny → przełącznik Ceny brutto

Przełącznik decyduje, czy ceny wpisywane w katalogu zawierają już VAT. W nowym sklepie jest włączony.

• Włączony (ceny brutto) – typowe dla sprzedaży klientom indywidualnym (B2C). Wpisana cena to kwota, którą zapłaci klient, a VAT jest z niej wyliczany.
  • Przykład: cena 123,00 zł przy stawce 23% to 100,00 zł netto i 23,00 zł VAT.
• Wyłączony (ceny netto) – typowe dla sprzedaży firmom (B2B). VAT jest doliczany do wpisanej ceny.
  • Przykład: cena 100,00 zł przy stawce 23% daje 123,00 zł do zapłaty.

Tryb cen widać w podsumowaniu zamówienia w panelu i w e-mailu z potwierdzeniem zamówienia: przy cenach brutto pod kwotą Razem pojawia się informacja „W tym VAT", a przy cenach netto przed kwotą Razem są osobne wiersze Razem netto i VAT. Ten sam tryb obowiązuje dla kwotowych opłat za formy płatności (zakładka „Metody płatności" opisana wyżej). Złożone zamówienie zachowuje tryb z chwili złożenia - późniejsza zmiana przełącznika nie zmienia jego kwot.

Sposób pokazania cen i VAT klientom na stronie sklepu zależy od wyglądu Twojego storefrontu.

Podatki dla Różnych Klientów

B2C (Klient indywidualny)

• Zawsze płaci VAT według stawki kraju sprzedawcy (Polska)

B2B UE z VAT UE

• WDT (wewnątrzwspólnotowa dostawa towarów)
• VAT 0% w Polsce
• Klient rozlicza VAT we własnym kraju (reverse charge)

B2B Polska

• Pełen VAT według stawki produktu

Waluty

Obsługa Wielu Walut

DoSwiftly pozwala sprzedawać w różnych walutach.

Konfiguracja Walut

Ustawienia → Waluty

Waluta	Symbol	Format
PLN	zł	123,99 zł
EUR	€	€123.99
USD	$	$123.99
GBP	£	£123.99

Waluta Główna

Wybierz walutę główną sklepu:

• Ceny produktów przechowywane w tej walucie
• Raporty finansowe w tej walucie
• Rozliczenia z bramką w tej walucie

Waluty Dodatkowe

Dodaj waluty dla klientów międzynarodowych:

1. Ustawienia → Waluty → Dodaj walutę
2. Wybierz walutę (EUR, USD, GBP)
3. Ustaw kurs wymiany:
   • Stały kurs – ustawiasz ręcznie (np. 1 EUR = 4.30 PLN)
   • Automatyczny kurs – pobierany z NBP API (aktualizacja codzienna)
4. Zapisz

Wyświetlanie Cen w Wielu Walutach

Klient może przełączyć walutę w storefront:

• Wybiera walutę z menu (np. PLN → EUR)
• Wszystkie ceny przeliczone automatycznie
• Płatność w wybranej walucie

informacja

Płatność zawsze przetwarzana w walucie wybranej przez klienta. Bramka może doliczyć opłatę za konwersję.

Przechowywanie Kwot

WAŻNE: System przechowuje wszystkie kwoty w najmniejszych jednostkach (grosze/centy).

Przykład

• Cena produktu: 49.99 PLN
• Przechowywane w bazie: 4999 (grosze)
• W formularzu wpisujesz: 49.99
• System automatycznie konwertuje: 49.99 × 100 = 4999

Dlaczego Grosze?

Unikanie błędów zaokrągleń przy obliczeniach finansowych (standard w systemach księgowych).

Dane Finansowe i Rozliczenia

Bieżący wgląd w płatności

Aktualny stan transakcji śledzisz na liście Płatności oraz w szczegółach poszczególnych zamówień:

• Płatności – lista wszystkich transakcji z ich statusem (opłacone, oczekujące, zwrócone)
• Zamówienia → szczegóły zamówienia – pełny rozkład kwot pojedynczego zamówienia: wartość netto, VAT według stawek, wartość brutto, koszt wysyłki i rabaty

Każda kwota przechowywana jest w jednej walucie zamówienia, z dokładnym rozbiciem podatku per stawka.

Zbiorcze raporty finansowe (w przygotowaniu)

Dedykowany moduł raportów zbiorczych jest w przygotowaniu. Po udostępnieniu pozwoli generować:

• Raport płatności – zbiorcze podsumowanie transakcji w wybranym okresie (liczba, wartość netto, VAT, brutto)
• Raport VAT – zestawienie obrotu według stawek podatkowych za dany okres

Status

Funkcja raportów zbiorczych nie jest jeszcze dostępna w panelu. Do czasu jej udostępnienia dane do rozliczeń pobierzesz z listy Płatności oraz ze szczegółów poszczególnych zamówień.

Eksport do księgowości (planowany)

Eksport danych finansowych do plików dla księgowości oraz plik JPK dla urzędu skarbowego są na mapie rozwoju platformy. Funkcje te nie są jeszcze dostępne.

Status

Eksport księgowy (w tym JPK) jest planowany, ale nie został jeszcze wdrożony. Bieżące rozliczenia opieraj na danych z zamówień.