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	Karty
MW	Portfele mobilne	Google Pay, Apple Pay	Poniżej, sekcja MW
PAYSAFE	Grupa Paysafe	PaysafeCard, 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	Opis	Waluty	paymentType	Autoryzacja	Zwroty
blik	BLIK z przekierowaniem: klient wpisuje kod na bramce BLIK i potwierdza w aplikacji banku	PLN	INSTANT	REDIRECT, APP_NOTIFICATION	Pełne i częściowe
blik-level0	BLIK Level 0: klient wpisuje kod w Twoim checkoucie	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).

Kolumna Segment mówi, dla kogo jest kanał: B2C to bankowość dla klientów indywidualnych, B2B to bankowość firmowa tego samego banku (np. iPKO biznes, Velo Business Banking), z osobnym logowaniem i osobnym kanałem w GET /channels. Jeśli obsługujesz firmy, pokaż im także kanały B2B.

Bank	paymentChannel	Aliasy paymentChannel	Segment	paymentType	Autoryzacja
Alior Bank	alior_bank		B2C	INSTANT	REDIRECT
Bank Millennium	millennium		B2C	INSTANT	REDIRECT
Bank Nowy S.A.	bank_nowy		B2C	INSTANT	REDIRECT
Bank Ochrony Środowiska	bosbank		B2C	INSTANT	REDIRECT
Bank Pekao S.A.	pekao_sa		B2C	INSTANT	REDIRECT
Bank Pocztowy (Pocztowy24)	pocztowy		B2C	INSTANT	REDIRECT
Bank Spółdzielczy w Brodnicy	bs_brodnica		B2C	INSTANT	REDIRECT
Banki Spółdzielcze (Grupa BPS)	spoldzielcze		B2C	INSTANT	REDIRECT
BNP Paribas	bnp_paribas		B2C	INSTANT	REDIRECT
BNP Paribas GOonline Biznes	bnp_paribas_b2b		B2B	INSTANT	REDIRECT
Citi Handlowy	citihandlowy		B2C	INSTANT	REDIRECT
Crédit Agricole	credit_agricole		B2C	INSTANT	REDIRECT
Crédit Agricole CA24 Biznes	credit_agricole_b2b		B2B	INSTANT	REDIRECT
Erste Bank Polska	erste	santander	B2C	INSTANT	REDIRECT
eSKOK	eskok		B2C	INSTANT	REDIRECT
ING Bank Śląski	ing_bs		B2C	INSTANT	REDIRECT
Inteligo	inteligo		B2C	INSTANT	REDIRECT
iPKO biznes (PKO BP)	pko_bp_b2b		B2B	INSTANT	REDIRECT
Kasa Stefczyka	kasa_stefczyka		B2C	INSTANT	REDIRECT
Krakowski Bank Spółdzielczy	bs-kbs		B2C	INSTANT	REDIRECT
mBank	mbank		B2C	INSTANT	REDIRECT
mBank CompanyNet	mbank_b2b		B2B	INSTANT	REDIRECT
Nest Bank	nestbank		B2C	INSTANT	REDIRECT
Nicolaus Bank	nicolaus-bank		B2C	INSTANT	REDIRECT
PKO Bank Polski	pko_bp		B2C	INSTANT	REDIRECT
Plus Bank	plus_bank		B2C	INSTANT	REDIRECT
Toyota Bank (Toyota Financial Services)	toyotabank		B2C	INSTANT	REDIRECT
Velo Bank	velo_bank		B2C	INSTANT	REDIRECT
Velo Business Banking	velo_bank_b2b		B2B	INSTANT	REDIRECT
Przelew z innego banku (przelew tradycyjny)	other		B2C, B2B	OFFLINE	—

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ę.

Przepływ i 3-D Secure: Płatności kartą. Testowanie: Karty testowe.

Karta wpisywana w Twoim checkoucie bez przekierowania: Card SDK.

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

Google Pay i Apple Pay jako przyciski w Twoim checkoucie (Card SDK): Google Pay i Apple Pay.

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)
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	Brak

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	REDIRECT, 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ę.