Changelog
Ten artykuł zawiera listę zmian wprowadzonych w dokumentacji wraz z linkami do poszczególnych artykułów. Lista zmian jest uporządkowana według dat modyfikacji.
Kategoria zamian:
major - używana do określania zmian niekompatybilnych wstecznie lub przełomowych względem opublikowanej aktualnie dokumentacji oraz obowiązującej wersji interfejsu API.
minor - używana do określenia kolejnych przyrostów funkcjonalności w dokumentacji oraz interfejsu API, nie powodująca niekompatybilności.
patch - określająca zmiany/poprawki nie powodujące niekompatybilności wstecznej ani przyrostów funkcjonalności oraz zamiany informacyjne.
27.06.2024
PATCH - Wyszukiwanie zamówienia poprzez GET/v1/izi/orders
Dodanie parametru order_id
do GET/v1/izi/orders umożliwiającego wyszukiwanie zamówienia po identyfikatorze zamówienia
Parametr order_id dodano do:
18.06.2024
MINOR - Informacja o dostępnej dostawie dla produktu w koszyku
Merchant przekazując do InPost Pay koszyk będzie miał możliwość zdefiniowania jakie są dostępne metody dostawy dla danego produktu w koszyku oraz produktów powiązanych. Do przekazywania powyższej informacji służyć będą obiekty:
delivery_product dla produktów
Nazwa pola | Opis | Typ | Wymagalność |
| Obiekt służący do przekazania informacji o dostępnych formach dostawy dla produktu. Jeśli brak obiektu delivery_product, to oznacza że dostawa dostępna wszystkimi typami | object | O |
| Typ dostawy | string | O |
| Flaga informująca czy typ dostawy jest dostępny. | boolean | O |
oraz delivery_related_products dla produktów powiązanych
Nazwa pola | Opis | Typ | Wymagalność |
| Obiekt służący do przekazania informacji o dostępnych formach dostawy dla produktu. Jeśli brak obiektu delivery_product, to oznacza że dostawa dostępna wszystkimi typami | object | O |
| Typ dostawy | string | O |
| Flaga informująca czy typ dostawy jest dostępny. | boolean | O |
Użytkownikowi aplikacji InPost Pay w szczegółach koszyka na produkcie, który ma niedostępną formę dostawy zostanie zaprezentowany odpowiedni komunikat.
Przykład:
Logika przekazywania informacji o dostępnych formach dostawy dla produktu:
Jeśli produkt w koszyku lub produkt powiązany ma dodatkowe ograniczenia w zakresie formy dostawy w stosunku do przekazanych form dostawy w obiekcie delivery, merchant powinien przekazać informacje o formach dostawy dla produktu w delivery_product lub dla produktów powiązanych w delivery_related_products zgodnie z logiką:
Obiekt delivery_product/delivery_related_products powinien zawierać informacje o wszystkich formach dostawy, które zostały przekazane w koszyku w obiekcie delivery (czyli jeśli w obiekcie delivery są zdefiniowane APM i CURRIER, to w delivery_product/delivery_related_products powinna być również informacja o dostępności APM i CURRIER).
Jeśli merchant chce zdefiniować, że dana forma dostawy jest dostępna dla danego produktu, to powinien przekazać w delivery_type - forma dostawy np. "APM" i wartość flagi if_delivery_available=true.
{ "delivery_type": "APM" "if_delivery_available": true }
Jeśli merchant chce zdefiniować, że dana forma dostawy jest niedostępna dla danego produktu, to powinien przekazać w delivery_type - forma dostawy np. "APM" i wartość flagi if_delivery_available=false.
{ "delivery_type": "APM" "if_delivery_available": false }
W przypadku, gdy w koszyku w obiekcie delivery są zdefiniowane więcej niż jedna forma dostawy (np. AMP i CURRIER) i merchant w produkcie w obiekcie delivery_product/delivery_related_products przekaże tylko informacje o dostępności jednej formy dostawy, to forma dostawy która nie została zdefiniowana w delivery_product/delivery_related_products będzie interpretowana jako niedostępna.
Brak przekazania obiektu delivery_product/delivery_related_products w produkcie oznacza, że dla produktu są dostępne wszystkie formy dostawy, które zostały przekazane w delivery w koszyku.
Obiekt delivery_product oraz delivery_related_products dodano do:
Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)
Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)
Aktualizacja koszyka - Developer Documentations - Confluence (atlassian.net)
MINOR - Informacja, czy po dodaniu produktu sugerowanego koszyk będzie miał darmową formę dostawy
W produkcie sugerowanym dla danego koszyka merchant ma możliwość przekazania informacji, czy po dodaniu produktu do koszyka wybrana forma dostawy będzie darmowa. Aby przekazać, że wybrana forma dostawy będzie darmowa w obiekcie delivery_related_products należy przekazać:
formę dostawy w delivery_type,
informacje czy dostawa jest dostępna if_delivery_available = true
oraz czy po dodaniu produktu do koszyka dostępna będzie darmowa forma dostawy if_delivery_free=true. Przykład:
{
"delivery_type": "APM",
"if_delivery_available": true,
"if_delivery_free": true
}
Aplikacja InPost Pay po otrzymaniu if_delivery_free=true dla danego produktu sugerowanego zaprezentuje odpowiedni komunikat klientowi.
Dano if_delivery_free:
Nazwa pola | Opis | Typ | Wymagalność |
| Flaga informująca czy po dodaniu produktu sugerowanego do koszyka, klient będzie miał darmową dostawę. W przypadku, gdy if_delivery_free=true jest na danym produkcie sugerowanym, klientowi zostanie zaprezentowany odpowiedni komunikat na tym produkcie. | boolean | O |
do API:
Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)
Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)
Aktualizacja koszyka - Developer Documentations - Confluence (atlassian.net)
13.06.2024
MAJOR - Obsługa Dyrektywy Omnibus
Wymaganie:
Merchant w przypadku zastosowania kodu, który spełnia warunki określone w Dyrektywie Omnibus na produkcie lub grupie produktów jest zobowiązany do przekazania informacji w szczegółach koszyka:
Wartość produktu po zastosowaniu kodu promocyjnego (products.promo_price)
Oznaczenie kodu promocyjnego jako „OMNIBUS” (promo_codes."regulation_type": "OMNIBUS")
Wartość najniższej ceny produktu z ostatnich 30 dni przed wprowadzeniem promocji na produktach w koszyku dla których został zastosowanych kod omnibusowy (products.lowest_price)
Opis biznesowy:
Przypadek 1: Wykorzystanie przez użytkownika kodu rabatowego merchanta, który spełnia warunki określone w Dyrektywie OMNIBUS.
Merchant musi oznaczyć kod promocyjny jako Omnibus (promo_codes."regulation_type": "OMNIBUS")
Merchant musi przesłać dla każdego produktu, na który ma wpływ zastosowany kod Omnibusowy, cenę Omnibusową na koszyku oraz na szczegółach dodanego do koszyka produktu (products.lowest_price) oraz cenę promocyjną (products.promo_price)
W aplikacji InPost Pay na koszyku dla produktów, dla których został zastosowany kod Omnibusowy zostanie zaprezentowana zarówno cena do zapłaty (products.promo_price) pokazana na czerwono, oraz przekreśloną cenę Omnibusową wraz z informacją, że jest to najniższa cena z 30 dni przed wprowadzeniem promocji (products.lowest_price).
Aplikacja InPost Pay w podsumowaniu koszyka nie będzie prezentowała wartość zastosowanego rabatu („Kod rabatowy sklepu”).
Przypadek 2: Wykorzystanie przez użytkownika kodu rabatowego merchanta, który nie spełnia warunków określonych w Dyrektywie OMNIBUS.
Merchant nie powinien przesyłać dla produktów w koszyku ceny Omnibusowej (products.lowest_price) oraz (products.promo_price).
Aplikacja InPost Pay zaprezentuje przy każdym produkcie cenę podstawową (products.base_price) na czarno.
W przypadku gdy zostanie przekazana wartość w parametrze products.promo_price, to w aplikacji przy produkcie zostanie zaprezentowana cena z products.promo_price na czarno.
Aplikacja InPost Pay w podsumowaniu koszyka zaprezentuje informację „Kod rabatowy sklepu” wraz z sumą obniżki, jaka wynika z zastosowanych kodów rabatowych sklepu. Jeśli zostały zastosowane kody rabatowe na koszyku (nie na produkcie), to wartość zastosowanych rabatów powinna być uwzględniona w basket_promo_price i basket_final_price zgodnie z opisem w dokumentacji.
Dodano: regulation_type
Nazwa pola | Opis | Typ | Wymagalność |
| Typ regulacji lub restrykcji, której kod promocyjny podlega | string | O |
do API:
https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/199688193
https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/253788271
https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/201490481
19.04.2024
MiNOR - Umożliwienie klientowi przejścia do koszyka w sklepie Merchanta ze szczegółów koszyka w aplikacji InPost Pay.
Użytkownik aplikacji InPost Pay będzie miał możliwości z poziomu szczegółów powiązanego koszyka, przejść do koszyka w sklepie Merchanta. Funkcjonalność będzie dostępna dla koszyków, których Merchant przekaże dane w nowym obiekcie merchant_store
umożlwiające poprawne przekierowanie do koszyka użytkownika w sklepie Merchanta z poziomu aplikacji InPost Pay
Dodano obiekt merchant_store
Nazwa pola | Opis | Typ | Wymagalność |
| Obiekt służący do przekazania cookie koszyka klienta w celu umożliwienia przejścia z aplikacji InPost Pay do koszyka w sklepie Merchanta | object | O |
| url sklepu | string | Y |
| Obiekt do przekazania cookie | object | Y |
| Domena pliku cookie reprezentowana przez parę key-value | string | Y |
| Cookie key | string | Y |
| Cookie value | string | Y |
| Cookie path | string | O |
| Czas wygaśnięcia pliku cookie lub maxAge | string($date-time) | O |
| Informacje o bezpieczeństwie plików cookie | string | O |
| Informacje http o plikach cookie | string | O |
| Informacje o pliku cookie sameSite [ STRICT, LAX, NONE ] | string | O |
| Priorytet plików cookie [ LOW, MEDIUM, HIGH ] | string | O |
| Maksymalny czas cookie | number ($decimal) | O |
do API:
Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)
Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)
Aktualizacja koszyka - Developer Documentations - Confluence (atlassian.net)
17.04.2024
MiNOR - dodanie metody umożliwiającej sprawdzenie Merchantowi dostępnych metod płatności, jakimi mogą być opłacone utworzone zamówienia w aplikacji InPost Pay.
28.03.2024
MiNOR - Umożliwienie przekazania dodatkowych zdjęć produktów w koszyku.
Zmiana umożliwia przekazanie więcej, niż jednego zdjęcia produktu w koszyku. Po przekazaniu dodatkowych zdjęć, klient będzie miał możliwość w aplikacji InPost Pay na szczegółach produktu przejrzenia przesłanych zdjęć produktu, a tym samy uzyskanie dodatkowych informacji o kupowanym produkcie.
Dodano:
Nazwa pola | Opis | Typ | Wymagalność |
| Obiekt do przekazania dodatkowych zdjęć produktu (lista) | object | O |
| Zdjęcie produktu. Preferowany rozmiar 360 x 352 | string | Y |
| Zdjęcie produktu. Preferowany rozmiar 360 x 504 | string | Y |
do API:
MiNOR - Dodanie nowych miejsc osadzenia dla InPost Pay widget.
Nowe miejsca osadzenia widget:
LOGIN_PAGE – strona logowania.
CHECKOUT_PAGE – stona checkout
REGISTERFORM_PAGE – strona rejestracji
MINICART_PAGE - minikarta
Dodano: LOGIN_PAGE, CHECKOUT_PAGE, REGISTERFORM_PAGE, MINICART_PAGE do binding_place
w request metody POST/v1/izi/basket/{basket_id}/binding
MiNOR - Dodanie flagi if_delivery_free w produkcie sugerowanym w koszyku.
Nazwa pola | Opis | Typ | Wymagalność |
| Flaga informująca czy po dodaniu produktu sugerowanego do koszyka, klient będzie miał darmową dostawę. W przypadku, gdy if_delivery_free=true jest na danym produkcie sugerowanym, klientowi zostanie zaprezentowany odpowiedni komunikat na tym produkcie. | boolean | O |
w API:
27.03.2024
PATCH - Dodanie maksymalnej ilości zgód w koszyku.
Maksymalna ilość obsługiwanych zgód dla koszyka to 10. W przypadku, gdy w obiekcie consents
dla koszyka zostanie przekazanych więcej niż 10 zgód, to w aplikacji InPost Pay będzie obsługiwanych dziesięć pierwszych zgód z obiektu consents
. Opis obiektu consents
zaktualizowany w artykułach:
Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)
Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)
06.03.2024
MINOR - Przekazanie więcej, niż jednego linku dla jednej zgody w koszyku do InPost Pay.
Zmiana umożliwia obsługę i prezentacje zgód w aplikacji InPost Pay które mają więcej niż jeden link w treści
Obiekt consents rozszerzony w api:
Aktualizacja lub dodanie koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie listy koszyków - Developer Documentations - Confluence (atlassian.net)
Potwierdzenie powiązania koszyka - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów koszyka - Developer Documentations - Confluence (atlassian.net)
o dane:
Nazwa pola | Opis | Typ | Wymagalność |
| Label do linku przekazanego w label_link | string | O |
| Obiekt służący do przekazania dodatkowego linku do zgody/regulaminu | object | O |
| Id zgody nadawane przez merchanta | string | O |
| Link przekierowujący do pełnej treści zgodny np. do strony merchanta | string | O |
| Label do linku przekazanego w label_link | string | O |
MINOR - Umożliwienie przekazania dodatkowego identyfikatora zamówienia przez Merchanta.
Zmiana umożliwia przekazania dodatkowego identyfikatora zamówienia w przypadku, gdy Merchant ma rozwiązanie obsługi zamówień oparte o dwa identyfikatory (jeden służący do komunikacji pomiędzy systemami, drugi do komunikacji i prezentacji klientowi).
Dodano:
Nazwa pola | Opis | Typ | Wymagalność |
| Identyfikator zamówienia prezentowany klientowi oraz wykorzystywany do płatności. W przypadku braku wykorzystywany jest order_id | string | O |
w api:
Pobranie listy zamówień - Developer Documentations - Confluence (atlassian.net)
Utworzenie zamówienia - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów zamówienia - Developer Documentations - Confluence (atlassian.net)
MINOR - Dodanie pola umożliwiającego przekazania przez Merchanta informacji o wartości zastosowanych rabatów w zamówieniu.
Wartość będzie prezentowana klientowi na podsumowaniu zamówieniu w aplikacji InPost Pay. Dodano:
Nazwa pola | Opis | Typ | Wymagalność |
| Wartość zastosowanych kodów rabatowych na zamówieniu | number($decimal) | O |
w api:
Pobranie listy zamówień - Developer Documentations - Confluence (atlassian.net)
Utworzenie zamówienia - Developer Documentations - Confluence (atlassian.net)
Pobranie szczegółów zamówienia - Developer Documentations - Confluence (atlassian.net)
26.02.2024
MINOR - Dodano nowy parametr min_height
w kodzie widgetu -
07.02.2024
MINOR - Aktualizacja opisu parametru lowest_price w zakresie wymagalności dla metod:
Parametr lowest_price należy przekazać obligatoryjnie, gdy została przekazana cena promocyjna promo_price.
29.01.2024
PATH - Aktualizacja opisu parametrów account_info.mail i delivery.mail w opisie metody służącej do utworzenia zamówienia -
18.12.2023
PATCH - Aktualizacji opisu metod udostępnionych przez InPost Pay (Basket App) poprzez podanie fragmentów kodu i przykładów implementacji w języku PHP.
14.12.2023
PATCH - Aktualizacja opisu dla parametru order_id
metody GET
/v1/izi/transaction
w
13.12.2023
MAJOR - Dodano nowe parametry max_width
oraz frame_style
w kodzie html widgetu
08.11.2023
PATCH - Aktualizacja opisu dla metody iziBindingDelete o uwagi dla developera w
03.11.2023
PATCH - Aktualizacja opisu dla parametrów summary.basket_final_price
i summary.basket_promo_price
w Aktualizacja lub dodanie koszyka ,Potwierdzenie powiązania koszyka ,Pobranie szczegółów koszyka , Aktualizacja koszyka.
30.10.2023
PATCH Uzupełnienie opisu metod iziGetPayData, iziGetIsBound, iziAddToCart dla Widget frontend o przykłady implementacji i przykłady odpowiedzi. Uzupełnienie opisu używanych parametrów o przykłady zastosowania dla
12.10.2023
PATCH Aktualizacja Swagger o opis dla obiektu related_products_event_data -
02.10.2023
PATCH Uzupełniono opis metod dla InPost API i Merchant Backend API wraz z parametrami
27.09.2023
PATCH Aktualizacja Swagger -
PATCH Aktualizacja Swagger -
15.09.2023
PATCH Aktualizacja Swagger o opis dla delivery_options -
PATCH Aktualizacja Swagger o opis dla delivery_options -
MINOR Aktualizacja opisu iziMobileLink -
07.09.2023
minor Aktualizacja Swagger o dodanie free_delivery_minimum_gross_price do metod zwracających szczegóły koszyka i opisanie kodów błędów dla metod API -
minor Aktualizacja Swagger o dodanie free_delivery_minimum_gross_price do metod zwracających szczegóły koszyka i opisanie kodów błędów dla metod API -
28.08.2023
major Aktualizacja Swagger o dodanie wymagalności pola order_final_price -
major Aktualizacja Swagger o dodanie wymagalności pola order_final_price, usunięcie obiektu address_details z response POST/v1/izi/order oraz GET/v1/izi/order/{order_id} -
25.08.2023
minor Aktualizacja Swagger -
08.08.2023
minor Uaktualnienie sandbox / prod js link -
07.08.2023
patch Dodano opis dla wartości pola binding_place -
minor Aktualizacja Swagger o dopisanie kodów błędów -
04.08.2023
patch Zaktualizowano diagramy sekwencji wraz z opisem dla:
minor Aktualizacja Swagger -
02.08.2023
minor Aktualizacja w Swagger dla
DELETE /v1/izi/basket/{basket_id}/binding oraz DELETE /v1/izi/browser/{browser_id}/binding -
POST /v1/izi/order -
01.08.2023
MINOR Zaktualizowano diagram sekwencji dla koszyka powiązanego z InPost Pay -
31.07.2023
MINOR Zaktualizowano html w sekcji Osadzanie HTML -
MINOR Dodano informacje o wyświetlaniu w zależności od danych z serwera -
21.07.2023
patch Aktualizacja opisu dla “Połączenie koszyka z innym numerem telefonu (Usunięcie/desynchronizacja koszyka powiązanego z InPost Pay) [12-22]: “ -
18.07.2023
minor Uzupełnienie iziGetOrderComplete i dodanie informacji o aktualizacji liczby produktów na przycisku -
minor Dodano iziGetBrowserData; handleThankYouNode; opis BrowserId -
patch Poprawiono opis iziAddToCart -
07.07.2023
minor Aktualizacja opisu “Signature verification algorithm” -
minor Dodano merchant-external-id do /api/v1/izi/signing-keys/public oraz /api/v1/izi/signing-keys/public/{version}. Brak konieczności przekazywania merchant-external-id podczas onboardingu i z requestami.
06.07.2023
minor Aktualizacja w obszarze Widget - frontend:
minor Dodanie iziGetPayData - / deprecated iziGetBingingData -
minor Dodanie iziMobileLink -
05.07.2023
minor Aktualizacja opisu “Signature verification algorithm” -
04.07.2023
patch Uaktualnienie iziAddToCart -
patch Uaktualnienie opisu metod GET /v1/izi/baskets
i GET /v1/izi/orders
w
30.06.2023
minor Uaktualnienie iziGetOrderComplete -
29.06.2023
minor Uaktualnienie iziGetIsBound -