{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Zdarzenie: blik:alias_status_changed","description":"Znajdziesz tutaj wszystkie niezbędne informacje dotyczące integracji i obsługi systemu płatności SimPay.pl","siteUrl":"https://docs.simpay.pl","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"zdarzenie-blikalias_status_changed","__idx":0},"children":["Zdarzenie: blik:alias_status_changed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zdarzenie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik:alias_status_changed"]}," informuje Twój system o każdej zmianie statusu aliasu BLIK. Alias to specjalny"," ","identyfikator, który pozwala na powiązanie konta klienta w Twoim sklepie z jego aplikacją bankową, co w przyszłości"," ","umożliwia inicjowanie szybkich płatności OneClick lub automatyczne pobieranie środków (Subskrypcje)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"kiedy-wysyłany-jest-ten-event","__idx":1},"children":["Kiedy wysyłany jest ten event?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Powiadomienie to jest wysyłane w momencie, gdy obsługujesz metody płatności oparte na zapisywaniu BLIKa (np. BLIK"," ","Płatności Powtarzalne lub OneClick)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Otrzymasz je między innymi, gdy:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Klient poprawnie zatwierdzi zaproszenie do subskrypcji w swojej aplikacji bankowej (status zmieni się na"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_active"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ważność aliasu wygaśnie lub klient samodzielnie wyrejestruje/usunie Twój sklep z zaufanych w swojej aplikacji"," ","bankowej (zmiana na ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_expired"]}," lub ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_unregistered"]},")."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"struktura-obiektu-data","__idx":2},"children":["Struktura obiektu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gdy pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," w głównym obiekcie powiadomienia ma wartość ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik:alias_status_changed"]},", obiekt ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," będzie zawierał"," ","następujące informacje:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Pole"},"children":["Pole"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Typ"},"children":["Typ"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Opis"},"children":["Opis"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Przykładowa wartość"},"children":["Przykładowa wartość"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UUID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ID aliasu w systemie SimPay"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["019972b1-e4c0-714f-a10b-f88a158bee50"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["char(8)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Identyfikator usługi"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e65c7519"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Typ aliasu"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYID"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Wartość aliasu"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AABBCCDD"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Etykieta wyświetlana w aplikacji mobilnej banku płacącego"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["testy"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik_identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Identyfikator aliasu w systemie BLIK (wysyłany tylko przy type === UID)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["testy"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BlikAliasStatusEnum"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Aktualny ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payment/statuses#statusGroup=Statusy+alias%C3%B3w+BLIK"},"children":["status aliasu"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_active"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ISO 8601"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Data utworzenia aliasu"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025-09-22T20:31:25+02:00"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ISO 8601"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Data ostatniej aktualizacji aliasu"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025-09-22T20:31:32+02:00"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Wskazówka"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zawsze sprawdzaj wartość pola ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},". Zanim zdecydujesz się na zainicjowanie pierwszej płatności powtarzalnej"," ","obciążającej rachunek klienta, upewnij się, że otrzymany z webhooka alias posiada status ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_active"]}]},". Próba"," ","obciążenia wygasłego (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alias_expired"]},") lub wyrejestrowanego aliasu zakończy się błędem transakcji."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykładowy-payload-json-alias-payid","__idx":3},"children":["Przykładowy Payload JSON (alias PAYID)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poniżej znajduje się kompletny zrzut (payload) powiadomienia wysyłanego dla zdarzenia ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik:alias_status_changed"]}," (w tym"," ","przypadku udana rejestracja i aktywacja aliasu)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Przykładowa sygnatura została wygenerowana przy użyciu klucza IPN: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UwSkKiIwlxIeOMF8MIq9iDkQWBTtjoJQ"]}]},". Możesz użyć"," ","tego klucza i poniższych danych do przetestowania swojego algorytmu walidacji)."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"blik:alias_status_changed\",\n  \"notification_id\": \"019972b2-0233-73d7-ad91-c114b62d56e3\",\n  \"date\": \"2025-09-22T20:31:32+02:00\",\n  \"data\": {\n    \"id\": \"019972b1-e4c0-714f-a10b-f88a158bee50\",\n    \"service_id\": \"e65c7519\",\n    \"type\": \"PAYID\",\n    \"value\": \"AABBCCDD\",\n    \"label\": \"testy\",\n    \"status\": \"alias_active\",\n    \"created_at\": \"2025-09-22T20:31:25+02:00\",\n    \"updated_at\": \"2025-09-22T20:31:32+02:00\"\n  },\n  \"signature\": \"8f1a0f6de3eb5c050e70ca0d7407588e380e8e607e131e289afb0a3a2996d4a1\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Zobacz wyliczenie sygnatury"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Flatten wszystkich elementów po kolei + separacja ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]},":"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nasz ciąg będzie wyglądać tak:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"blik:alias_status_changed|019972b2-0233-73d7-ad91-c114b62d56e3|2025-09-22T20:31:32+02:00|019972b1-e4c0-714f-a10b-f88a158bee50|e65c7519|PAYID|AABBCCDD|testy|alias_active|2025-09-22T20:31:25+02:00|2025-09-22T20:31:32+02:00\n"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dodaj klucz IPN na końcu ciągu:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["...|UwSkKiIwlxIeOMF8MIq9iDkQWBTtjoJQ"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Oblicz SHA256 z powyższego ciągu i zakoduj go w hex:"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"<?php\n\n$signature = hash('sha256', 'blik:alias_status_changed|019972b2-0233-73d7-ad91-c114b62d56e3|2025-09-22T20:31:32+02:00|019972b1-e4c0-714f-a10b-f88a158bee50|e65c7519|PAYID|AABBCCDD|testy|alias_active|2025-09-22T20:31:25+02:00|2025-09-22T20:31:32+02:00|UwSkKiIwlxIeOMF8MIq9iDkQWBTtjoJQ');\n","lang":"php"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Porównaj bezpieczną funkcją porównującą (np. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hash_equals"]}," w PHP) obliczoną sygnaturę z tą przesłaną w polu"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}," powiadomienia. W tym przypadku wynikiem hashowania będzie"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8f1a0f6de3eb5c050e70ca0d7407588e380e8e607e131e289afb0a3a2996d4a1"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykładowy-payload-json-alias-uid","__idx":4},"children":["Przykładowy Payload JSON (alias UID)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poniżej znajduje się kompletny zrzut (payload) powiadomienia wysyłanego dla zdarzenia ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik:alias_status_changed"]}," (w tym"," ","przypadku udana rejestracja i aktywacja aliasu)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Przykładowa sygnatura została wygenerowana przy użyciu klucza IPN: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UwSkKiIwlxIeOMF8MIq9iDkQWBTtjoJQ"]}]},". Możesz użyć"," ","tego klucza i poniższych danych do przetestowania swojego algorytmu walidacji)."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"blik:alias_status_changed\",\n  \"notification_id\": \"019e41ce-92d8-7193-a466-ae753719545f\",\n  \"date\": \"2026-05-19T21:55:17+02:00\",\n  \"data\": {\n    \"id\": \"019e41ce-65f6-71ac-a9b8-dcc7134591bf\",\n    \"service_id\": \"e65c7519\",\n    \"type\": \"UID\",\n    \"value\": \"aaaaaa\",\n    \"label\": \"SuperStore\",\n    \"blik_identifier\": 953832,\n    \"status\": \"alias_active\",\n    \"expires_at\": \"2028-05-19T21:55:11+02:00\",\n    \"created_at\": \"2026-05-19T21:55:06+02:00\",\n    \"updated_at\": \"2026-05-19T21:55:17+02:00\"\n  },\n  \"signature\": \"6f551ef38eef4c352f92656c17cb43bc75fe32a5250238d64a4f4f25cf8eaec7\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Zobacz wyliczenie sygnatury"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Flatten wszystkich elementów po kolei + separacja ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]},":"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nasz ciąg będzie wyglądać tak:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"  blik:alias_status_changed|019e41ce-92d8-7193-a466-ae753719545f|2026-05-19T21:55:17+02:00|019e41ce-65f6-71ac-a9b8-dcc7134591bf|e65c7519|UID|aaaaaa|SuperStore|953832|alias_active|2026-05-19T21:55:06+02:00|2026-05-19T21:55:17+02:00\n"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dodaj klucz IPN na końcu ciągu:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["...|UwSkKiIwlxIeOMF8MIq9iDkQWBTtjoJQ"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Oblicz SHA256 z powyższego ciągu i zakoduj go w hex:"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"<?php\n\n$signature = hash('sha256', 'blik:alias_status_changed|019e41ce-92d8-7193-a466-ae753719545f|2026-05-19T21:55:17+02:00|019e41ce-65f6-71ac-a9b8-dcc7134591bf|e65c7519|UID|aaaaaa|SuperStore|953832|alias_active|2026-05-19T21:55:06+02:00|2026-05-19T21:55:17+02:00|UwSkKiIwlxIeOMF8MIq9iDkQWBTtjoJQ');\n","lang":"php"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Porównaj bezpieczną funkcją porównującą (np. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hash_equals"]}," w PHP) obliczoną sygnaturę z tą przesłaną w polu"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}," powiadomienia. W tym przypadku wynikiem hashowania będzie"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["6f551ef38eef4c352f92656c17cb43bc75fe32a5250238d64a4f4f25cf8eaec7"]},"."]}]}]}]},"headings":[{"value":"Zdarzenie: blik:alias_status_changed","id":"zdarzenie-blikalias_status_changed","depth":1},{"value":"Kiedy wysyłany jest ten event?","id":"kiedy-wysyłany-jest-ten-event","depth":2},{"value":"Struktura obiektu data","id":"struktura-obiektu-data","depth":2},{"value":"Przykładowy Payload JSON (alias PAYID)","id":"przykładowy-payload-json-alias-payid","depth":2},{"value":"Przykładowy Payload JSON (alias UID)","id":"przykładowy-payload-json-alias-uid","depth":2}],"frontmatter":{"seo":{"title":"Zdarzenie: blik:alias_status_changed"}},"lastModified":"2026-05-25T10:20:35.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/notifications/payment/events/blik_alias_status_changed","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}