Zmiana statusu aliasu BLIK

PAYMENT.BLIK_ALIAS_STATUS_CHANGED

Webhook wysyłany przy każdej zmianie statusu aliasu BLIK — identyfikatora używanego w mechanizmie BLIK One Click do płatności bez wpisywania kodu BLIK. Pozwala Ci utrzymywać po swojej stronie aktualną informację o tym, którzy klienci mogą skorzystać z płatności jednym kliknięciem.

Kiedy jest wywoływany

Webhook jest wysyłany tylko wtedy, gdy zmieni się status aliasu — najczęściej po potwierdzeniu (lub wycofaniu) zgody przez klienta w aplikacji banku:

• Po pomyślnej aktywacji aliasu przez klienta w aplikacji bankowej (status: ACTIVE)
• Gdy klient wycofa zgodę na alias w aplikacji banku (status: UNREGISTERED)
• Po wygaśnięciu aliasu po upływie daty expiresAt (status: EXPIRED)

uwaga

Jeżeli przy rejestracji klient odrzuci ekran zgody w aplikacji banku, alias nie powstaje i tego webhooka nie otrzymasz. Sama transakcja nadal może zakończyć się sukcesem — dostaniesz PAYMENT.TRANSACTION_STATUS_CHANGED ze statusem PAID, ale bez BLIK_ALIAS_STATUS_CHANGED. Brak tego webhooka po udanej rejestracji to sygnał, że klient odmówił zapamiętania aliasu.

Struktura body

{
  "aliasId": "01jzzz2j9fzmsbda2p8m9v1nx6",
  "pointId": "000cb241",
  "status": "ACTIVE",
  "type": "UID",
  "value": "9a453733-b088-4ee1-89ac-ed42d9c97e51",
  "expiresAt": "2027-09-20T09:48:03+02:00"
}

Opis pól

Pole	Typ	Format	Wymagane	Opis
aliasId	string	ULID	Tak	Unikalny identyfikator aliasu w systemie Paymentic. Używaj go do śledzenia konkretnego aliasu w logach i przy wsparciu.
pointId	string	-	Tak	Identyfikator punktu płatności, do którego przypisany jest alias.
status	string	Enum	Tak	Aktualny status aliasu. Możliwe wartości: CREATED, ACTIVE, UNREGISTERED, EXPIRED.
type	string	Enum	Tak	Typ aliasu. Możliwe wartości: UID, PAYID.
value	string	-	Tak	Wartość aliasu, którą podajesz w request-ach type: "ALIAS" przy płatności. Dokładnie ta sama wartość, którą przesłałeś przy rejestracji.
expiresAt	string	ISO 8601	Nie	Data i czas wygaśnięcia aliasu. null oznacza alias bezterminowy.

Statusy aliasu

Status	Znaczenie	Czy można płacić aliasem?
CREATED	Alias został zainicjowany po stronie Paymentic, czekamy na potwierdzenie klienta w aplikacji bankowej.	Nie — czekaj na ACTIVE.
ACTIVE	Alias aktywny, klient zgodził się na zapamiętanie płatności.	Tak.
UNREGISTERED	Klient odrzucił rejestrację lub wycofał zgodę w aplikacji banku.	Nie — oznacz jako nieaktywny i poproś o kod BLIK.
EXPIRED	Upłynął czas ważności aliasu.	Nie — oznacz jako wygasły, zaproś do ponownej rejestracji.

Typy aliasu

Typ	Znaczenie
UID	Alias identyfikowany przez unikalną wartość po stronie sklepu (najczęściej ID klienta w systemie).
PAYID	Alias oparty o mechanizm PayID po stronie BLIK-a.

Obsługa po stronie sklepu

• ACTIVE — zapisz alias w bazie obok profilu klienta; od tej pory możesz pokazywać mu przycisk "Zapłać One Click".
• UNREGISTERED lub EXPIRED — oznacz alias jako nieaktywny i ukryj przycisk One Click. Przy kolejnym zamówieniu klient przejdzie zwykłą ścieżką BLIK Level 0 i (opcjonalnie) zarejestruje nowy alias.
• CREATED — stan przejściowy, zwykle nie wymaga akcji. Finalny status (ACTIVE lub UNREGISTERED) przyjdzie chwilę później osobnym webhookiem.

wskazówka

Pamiętaj o idempotentności — jedna zmiana statusu aliasu może przyjść do Ciebie wielokrotnie w ramach ponawiania notyfikacji. Zawsze sprawdzaj X-Paymentic-Notification-Id przed aktualizacją stanu aliasu w swojej bazie.

Co dalej?

• BLIK One Click — pełny przewodnik po integracji płatności aliasem.
• Struktura notyfikacji — nagłówki, wersjonowanie, wymagana odpowiedź.
• Sygnatura — weryfikacja autentyczności webhooków.