- Created by Michał Machowski, last modified by Joanna Wołosz on Sept 27, 2023
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 53 Next »
InPost Pay (Basket App) - jest to moduł udostępniający API, pozwalający na wymianę informacji o koszyku i realizacji zamówienia.
W danym momencie, użytkownik może mieć wiele aktywnych, synchronizowanych koszyków (robić zakupy u różnych Merchantów). Płatność za każdy koszyk odbywa się osobno. Modyfikacja koszyka tj. zmiana ilości sztuk, kody promocyjne też są procesowane odrębnie, zgodnie z wytycznymi danego Merchanta.
Relacja między koszykiem po stronie Merchanta i InPost Pay jest 1:1. Jeden koszyk po stronie Merchanta odpowiada jednemu koszykowi w InPost Pay.
Po stronie aplikacji InPost Mobile, użytkownik będzie miał możliwość:
Zmiany ilości danego produktu w koszyku
Usunięcia produktu z koszyka
Podania kodu rabatowego
Każda zmiana informacji o koszyku po stronie InPost Mobile jest przesłana do Merchanta. Merchant odsyła zawsze całą zawartość koszyka.
Jeżeli po stronie Merchanta zsynchronizowany koszyk ulega zmianie, Merchant odsyła do InPost Pay zawsze cały koszyk.
Merchant wraz z koszykiem przesyła do InPost Mobile informacje:
Dane | Opis |
---|---|
Lista towarów |
|
Podsumowanie koszyka |
|
Data wygaśnięcia koszyka | Po tej dacie koszyk zostaje usunięty z listy koszyków w InPost Mobile. |
Listy produktów sugerowanych | Użytkownik po stronie InPost Mobile może dodać produkt sugerowany do koszyka. Informacja jest przesyłana do Merchanta, analogicznie jak przy innych operacjach na koszyku w InPost Mobile. Jakie produkty są powiązane/sugerowane dyktuje Merchant. |
Wykorzystane kody rabatowe | Użytkownik ma możliwość podania kilku kodów, każdy z nich musi zostać wpisany pojedynczo. Użytkownik ma możliwość usunięcia dodanego kodu rabatowego z poziomu aplikacji InPost Mobile.
|
Dodatkowe opcje dostawy oraz koszt opcji | Dla usługi InPost Paczkomat® 24/7 dostępne usługi dodatkowe:
Usługa pakowania - np. 15zł (Nie jest powiązana z wybraną formą dostawy) |
Zgody | Lista zgód powinna zawierać pola:
|
InPost Mobile przechowuje informacje o zgodach zaznaczonych dla danego Merchanta, tak aby zgody o wymagalności „gdy nowa wersja” były pobierane tylko raz dla danego nadanego ID i wersji zgody.
Zgody wymagane „zawsze”, użytkownik musi zaakceptować przy każdym złożeniu zamówienia.
Widok koszyka w InPost Pay Mobile
Na tej stronie
Widok aktywnych koszyków w InPost Mobile:
Szczegóły koszyka w InPost Mobile:
Lista złożonych zamówień:
InPost Pay API
Środowisko produkcyjne
Adres środowiska produkcyjnego: https://api.inpost.pl
Środowisko sandbox
Adres środowiska testowego: https://sandbox-api.inpost.pl
Lista endpointów wystawionych przez aplikacje InPost Pay, służąca do komunikacji pomiędzy Merchantem a aplikacją InPost Pay:
Metoda | Opis | |
---|---|---|
Przeglądarka | DELETE | Metoda usuwa powiązaną przeglądarkę lub usuwa telefon z powiązanej przeglądarki. |
Koszyk | PUT | Metoda aktualizuje lub tworzy koszyk, np. zmienia ilość produktów, typ dostawy itp |
DELETE | Desynchronizacja koszyka z numerem telefonu | |
POST | Metoda łączy koszyk z aplikacją InPost | |
GET | Metoda sprawdza, czy koszyk jest połączony z aplikacją InPost | |
GET | Opcjonalny endpoint back office'owy, zwraca listę koszyków dla Merchanta | |
Zamówienie | POST | Aktualizacja zamówienia |
GET | Opcjonalny endpoint back office'owy, zwraca listę zamówień dla Merchanta | |
Weryfikacja sygnatury | GET | Zwraca publiczne klucze podpisujące |
GET | Zwraca publiczny klucz podpisujący dla wersji |
Informacje dodatkowe
Dodatkowy opis dla basket_summary
basket_base_price
- Cena podstawowa koszyka bez promocji, kodu rabatowego i bez kosztów dostawy.basket_promo_price
- Cena koszyka z uwzględnieniem promocji i bez kosztów dostawy.basket_final_price
- Cena końcowa koszyka z uwzględnieniem promocji i kodu rabatowego i bez kosztów dostawy. Jeżeli nie używamy kodu rabatowego wartość basket_promo_price
jest taka sama jak basket_final_price
.
Sposób przesyłania cen przez Merchanta w zależności od typu produktu
Jeżeli typ produktu jest integer, to Merchant przesyła cenę za 1 szt. Jeżeli typ produktu jest decimal, to przesyła cenę za wybraną ilość.
Przykład
Mamy 5 sztuk koszul w cenie 10 zł za sztukę. W takim przypadku quantity_type
, to INTEGER
i cena 10 zł.
Mamy 0,35 kg mąki w cenie 5 zł. W takim przypadku quantity_type
, to DECIMAL
i cena 5 zł.
Przykłady dla wybranych metod
Metoda | Przykład |
---|---|
PUT | Request body
|
POST | Request body
|
POST | Request body
|
- No labels