# Gapli Payments

> Moduł WordPress/WooCommerce GAPLI (`gapli-payments`) · kategoria: Płatności · aktualna wersja 2.7.0 · WordPress 6.0+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/gapli-payments

Płatności online obsługiwane centralnie przez GAPLI: BLIK, karta, Apple Pay, Google Pay, Przelewy24 i Link. Sklep nie potrzebuje własnego konta u operatora płatności ani kluczy API.

## Gdzie go znajdziesz

WooCommerce → Ustawienia → Płatności → GAPLI Payments (link „Ustawienia” znajdziesz też na liście wtyczek). Osobnego menu moduł nie ma.

## Pierwsze uruchomienie

1. Upewnij się, że sklep jest połączony z GAPLI (Gapli → Status Połączenia).
2. Włącz moduł i sprawdź w WooCommerce → Ustawienia → Płatności, że „GAPLI Payments” jest włączone.
3. Opcjonalnie zmień „Nazwę metody płatności” (domyślnie „Płatność online”) i „Opis”, które widzi klient w kasie.
4. „Adres API GAPLI” zostaw bez zmian (https://gapli.com) — zmieniaj tylko na polecenie obsługi GAPLI.
5. Przycisk „Kup teraz” oraz Apple Pay / Google Pay na karcie produktu są domyślnie włączone; portfele pokazują się klientom z urządzeniem, które je obsługuje.

## Co dzieje się automatycznie

- Tworzy sesję płatności i po zapłacie sam oznacza zamówienie jako opłacone na podstawie powiadomienia z GAPLI.
- Na liście zamówień dodaje kolumnę „Kanał płatności”, a na karcie zamówienia — opis kanału.
- Klient może zgłosić zwrot lub anulowanie w „Moje konto” do 30 dni od zapłaty.

## Wymagania i powiązane moduły

- Gapli Status Połączenia — wymagany.
- Płatności muszą być włączone dla rynku sklepu po stronie GAPLI.
- Obsługuje nowe przechowywanie zamówień WooCommerce (HPOS) i kasę blokową.

## Gdy coś nie działa

- **Metoda płatności nie pojawia się w kasie** — Sklep nie jest połączony albo płatności nie są włączone dla jego rynku. Sprawdź Status Połączenia; jeśli jest aktywny, napisz do obsługi GAPLI. Zmiana po stronie GAPLI jest widoczna w sklepie po około 5 minutach.
- **„Zwrotów nie wykonuje się w sklepie…”** — Zwroty płatności realizuje GAPLI. Klient zgłasza zwrot w „Moje konto”, a Ty obsługujesz go w panelu GAPLI.
- **Klient widzi „Nie udało się przygotować płatności”** — Klient może spróbować ponownie albo wybrać inną metodę. Jeśli problem się powtarza, zgłoś go do obsługi GAPLI z numerem zamówienia.