Metody i kanały płatności

Paymentic udostępnia wiele metod płatności — od BLIK-a, przez przelewy online, karty i portfele mobilne, po płatności odroczone. W API każda metoda opisana jest dwoma polami:

• paymentMethod — rodzina metody płatności (np. BLIK, PBL, CARD). Enum na poziomie API.
• paymentChannel — konkretny kanał wewnątrz metody (np. bank, operator karty, dostawca portfela). Dynamiczna wartość pobierana z endpointu GET /v1_2/payment/points/{pointId}/channels.

Oba pola podajesz razem tylko wtedy, gdy integrujesz się w trybie bezpośrednim — czyli sam pokazujesz klientowi wybór metody. Jeśli chcesz, żeby klient wybierał metodę na bramce Paymentic, oba pola zostaw puste.

wskazówka

Lista kanałów, ich waluty, typ księgowania (paymentType) i dostępność są dynamiczne — zależą od Twojej umowy, waluty i kwoty transakcji. Dla konkretnego punktu płatności pobieraj je z GET /v1_2/payment/points/{pointId}/channels. Szczegóły: Płatność z pominięciem bramki → Krok 1.

Typy płatności i autoryzacji

Endpoint /channels zwraca dla każdego kanału dwa pola opisujące jego charakter z punktu widzenia księgowania i interakcji z klientem. Warto zrozumieć je raz — potem tabele poniżej są oczywiste.

paymentType — moment księgowania

Wartość	Znaczenie
INSTANT	Płatność rozlicza się natychmiast. Po sukcesie transakcja przechodzi prosto w PAID — środki są zaksięgowane, zwrot możliwy od razu.
PRE_AUTHORIZATION	Najpierw blokada środków (autoryzacja), potem osobne potwierdzenie — capture — żeby faktycznie pobrać pieniądze. Typowe dla kart.
OFFLINE	Rozliczenie następuje poza czasem rzeczywistym (voucher, przelew tradycyjny). Status przez chwilę pozostaje w PENDING dłużej niż w INSTANT.

Pre-autoryzacja jest używana, gdy chcesz zablokować środki przed wysyłką towaru i pobrać je dopiero po kompletacji zamówienia. Do pobrania środków służy PATCH /transactions/{id}/capture — zobacz Statusy transakcji.

authorization.type — jak klient zatwierdza płatność

Wartość	Znaczenie
REDIRECT	Klient jest przekierowywany na zewnętrzną stronę (bank, PayPal, PayPo) i tam zatwierdza płatność.
APP_NOTIFICATION	Klient dostaje push-a w aplikacji mobilnej (BLIK, Google Pay / Apple Pay w tokenizowanym wariancie) i tam klika "Zatwierdź".
SCAN_CODE	Klient skanuje kod QR (np. BLIK QR, mobilne portfele w modelu in-store).
MULTI_FACTOR	Płatność wymaga dodatkowego uwierzytelnienia — np. 3-D Secure przy karcie.

W odpowiedzi /channels pole authorization.type jest tablicą — wiele kanałów obsługuje więcej niż jeden sposób autoryzacji jednocześnie (np. karta: REDIRECT + MULTI_FACTOR dla 3DS).

Przegląd metod

paymentMethod	Rodzaj płatności	Opis	Szczegóły
BLIK	BLIK	Kod 6-cyfrowy (Level 0) lub płatność w aplikacji banku (redirect)	BLIK
PBL	Pay-by-link	Przelew online — klient loguje się do swojego banku (mBank, PKO, ING itd.)	Poniżej, sekcja PBL
CARD	Karty płatnicze	Visa, Mastercard, Maestro	Poniżej, sekcja CARD
MW	Portfele mobilne	Google Pay, Apple Pay	Poniżej, sekcja MW
PAYSAFE	Grupa Paysafe	PaysafeCard, Paysafe, Skrill	Poniżej, sekcja PAYSAFE
PAYPAL	PayPal	Płatność kontem PayPal	Poniżej, sekcja PAYPAL
BNPL	Płatności odroczone	PayPo, Twisto, BLIK Płacę później	BNPL

BLIK

Najpopularniejsza metoda płatności w Polsce. Paymentic obsługuje zarówno wprowadzenie 6-cyfrowego kodu w checkoucie sklepu (Level 0), jak i przekierowanie do aplikacji banku.

paymentChannel	Waluty	paymentType	Autoryzacja	Zwroty
blik-level0	PLN	INSTANT	APP_NOTIFICATION	Pełne i częściowe

Szczegóły implementacji: BLIK Level 0, BLIK One-Click (aliasy).

PBL

Przelew online — klient jest przekierowywany do strony logowania swojego banku i zatwierdza przygotowany formularz przelewu. W paymentChannel podajesz identyfikator banku.

Wszystkie kanały PBL mają wspólne parametry: Waluty: PLN, Zwroty: pełne i częściowe. Różnią się paymentType i autoryzacją — zdecydowana większość banków rozlicza się natychmiastowo (INSTANT, REDIRECT), ale kanał other to zwykły przelew tradycyjny, więc jest OFFLINE i nie ma autoryzacji online (klient dostaje dane do przelewu i wykonuje go w swoim banku).

Bank	paymentChannel	Aliasy paymentChannel	paymentType	Autoryzacja
Alior Bank	alior_bank		INSTANT	REDIRECT
Bank Millennium	millennium		INSTANT	REDIRECT
Bank Nowy S.A.	bank_nowy		INSTANT	REDIRECT
Bank Ochrony Środowiska	bosbank		INSTANT	REDIRECT
Bank Pekao S.A.	pekao_sa		INSTANT	REDIRECT
Bank Pocztowy	pocztowy		INSTANT	REDIRECT
Bank Spółdzielczy w Brodnicy	bs_brodnica		INSTANT	REDIRECT
Banki Spółdzielcze	spoldzielcze		INSTANT	REDIRECT
BNP Paribas	bnp_paribas		INSTANT	REDIRECT
Citi Handlowy	citihandlowy		INSTANT	REDIRECT
Crédit Agricole	credit_agricole		INSTANT	REDIRECT
eSKOK	eskok		INSTANT	REDIRECT
ING Bank Śląski	ing_bs		INSTANT	REDIRECT
Inny (przelew zwykły)	other		OFFLINE	—
Inteligo	inteligo		INSTANT	REDIRECT
Kasa Stefczyka	kasa_stefczyka		INSTANT	REDIRECT
mBank	mbank		INSTANT	REDIRECT
Nest Bank	nestbank		INSTANT	REDIRECT
PKO BP	pko_bp		INSTANT	REDIRECT
Plus Bank	plus_bank		INSTANT	REDIRECT
Erste Bank Polska	erste	santander	INSTANT	REDIRECT
Toyota Bank	toyotabank		INSTANT	REDIRECT
Velo Bank	velo_bank		INSTANT	REDIRECT

informacja

Lista banków może się zmieniać w zależności od Twojej umowy i dostępności kanałów. Aktualną, dynamiczną listę dla Twojego punktu płatności pobierzesz z GET /v1_2/payment/points/{pointId}/channels, filtrując po method == "PBL".

CARD

Płatność kartą. W zdecydowanej większości przypadków nie musisz podawać paymentChannel — wybór schematu karty (Visa / Mastercard) odbywa się na podstawie numeru karty wprowadzonego przez klienta.

paymentChannel	Waluty	paymentType	Autoryzacja	Zwroty
(pomiń lub null)	PLN	INSTANT lub PRE_AUTHORIZATION	REDIRECT, MULTI_FACTOR (3DS)	Pełne i częściowe

Karty obsługują pre-autoryzację — możesz zablokować środki na czas kompletacji zamówienia i potwierdzić pobranie przez PATCH /transactions/{id}/capture. Ustawia się to polem autoCapture w requeście tworzącym transakcję.

Testowanie: Karty testowe.

MW

Portfele mobilne (Mobile Wallets). W paymentChannel wskazujesz konkretnego dostawcę portfela.

paymentChannel	Opis	Waluty	paymentType	Autoryzacja	Zwroty
google-pay	Google Pay	PLN	INSTANT	APP_NOTIFICATION, MULTI_FACTOR	Pełne i częściowe
apple-pay	Apple Pay (wymaga obsługi domeny Apple)	PLN	INSTANT	APP_NOTIFICATION, MULTI_FACTOR	Pełne i częściowe

PAYSAFE

Metody z grupy Paysafe — dobre na rynki poza PL, zwłaszcza dla klientów bez konta bankowego.

paymentChannel	Opis	Waluty	paymentType	Autoryzacja	Zwroty
paysafecard	Voucher prepaidowy (16-cyfrowy PIN)	PLN	INSTANT	REDIRECT	Brak (voucher)
paysafe	Paysafe Cash / Paysafe Account	PLN	INSTANT	REDIRECT	Pełne
skrill	Skrill — e-wallet	PLN	INSTANT	REDIRECT	Pełne i częściowe

informacja

PaysafeCard jako voucher prepaidowy technicznie nie pozwala na zwrot na to samo źródło — wypłata do klienta odbywa się poza API. Jeśli planujesz integrację z PaysafeCard, uzgodnij proces zwrotów z opiekunem handlowym.

PAYPAL

Płatność kontem PayPal. paymentChannel nie jest wymagany — wystarczy sama metoda.

paymentChannel	Waluty	paymentType	Autoryzacja	Zwroty
(pomiń lub null)	PLN	INSTANT	REDIRECT	Pełne i częściowe

BNPL

Wszyscy dostawcy BNPL są ukryci pod wspólną wartością paymentMethod: "BNPL", a konkretny dostawca to paymentChannel.

paymentChannel	Dostawca	Waluty	paymentType	Autoryzacja	Zwroty	Strona
paypo	PayPo	PLN	INSTANT	REDIRECT	Pełne i częściowe	PayPo
twisto	Twisto	PLN	INSTANT	REDIRECT	Pełne i częściowe	Twisto
blik-bnpl	BLIK Płacę później	PLN	INSTANT	APP_NOTIFICATION	Pełne i częściowe	BLIK Płacę później

Wspólne cechy BNPL (wymagane dane klienta, adresy, koszyk) — zobacz Wprowadzenie do BNPL.

Co dalej?

• Płatność z pominięciem bramki — jak wysłać paymentMethod i paymentChannel w requeście tworzącym transakcję.
• Filtrowanie metod płatności — jak zawęzić widoczne metody na bramce Paymentic.
• Statusy transakcji — pełny cykl życia transakcji, niezależnie od wybranej metody.
• Zwroty — jak zwrócić środki na opłaconą transakcję.