Zamówienie
Ten rozdział zawiera informacje dotyczące obsługi i realizacji zamówień z usługą InPost Pay wraz z listą i opisem metod wywoływanych przez Merchanta do InPost w celu aktualizacji zamówienia lub pobrania listy zamówień.
Lista metod
POST
/v1/izi/order/{order_id}/event
- Aktualizacja zamówieniaGET
/v1/izi/orders
- Pobranie listy zamówień
Realizacja zamówienia z usługą InPost Pay
Po wybraniu przez użytkownika opcji „Kupuję i płacę” w aplikacji InPost Mobile, przed faktycznym rozpoczęciem płatności za koszyk, InPost Pay weryfikuje stan koszyka, poprzez pobranie aktualnego koszyka od Merchanta i porównanie go z koszykiem zapisanym w InPost Pay. Jeśli aktualny koszyk pobrany od Merchanta jest identyczny jak ten zapisany w InPost Pay, to następuje sprawdzenie czy zamówienie może zostać złożone. Walidacja poprawności złożenia zamówienia wykonywana jest po stronie Merchanta. W przypadku braku dostępności produktu lub niespełnieniu innej walidacji zamówienie nie jest tworzone. W takim przypadku użytkownikowi prezentowany jest odpowiedni komunikat oraz może dalej edytować koszyk.
Po poprawnym utworzeniu zamówienia, koszyk przestaje być edytowalny z poziomu InPost Mobile oraz nie powinien być dostępny do edycji na stronie Merchanta.
Przy tworzeniu zamówienia InPost Mobile przekazuje do Merchanta:
Identyfikator koszyka, na podstawie którego mam być utworzone zamówienie
Finalną wartość koszyka uwzględniającą koszt dostawy
Wybraną przez klienta formę płatności
Dane zamawiającego (imię, nazwisko, adres email, numer telefonu)
Adres zamawiającego (opcjonalny)
Formę i adres dostawy
Dane do faktury
Uwagi do zamówienia
Informacje o zaakceptowanych zgodach
W przypadku, gdy klient opłaci zamówienie w aplikacji InPost Pay, informacja ta jest przekazywana do Merchanta w celu rozpoczęcia realizacji zamówienia.
W przypadku wybrania płatności COD, zamówienie od razu traktowane jest jako opłacone.
Merchant aktualizuje zmiany statusu zamówienia wraz z przekazaniem informacji o przesyłkach (jednej lub wielu), przy pomocy których zostało zamówienie wysłane. Statusy obsługiwane przy zamówieniu:
Status techniczny - służy do określenia uprawnień, jakie może wykonać klient na zamówieniu w aplikacji InPost Pay. Wyróżniamy 3 statusy techniczne:
ORDER_COMPLETED
- status nadawany przez Merchanta, informujący aplikacje InPost Pay, że zamówienie zostało sfinalizowane przez klienta na stronie sklepu Merchanta. Zamówienie ze statusemORDER_COMPLETED
nie może być opłacone oraz odrzucone w aplikacji InPost Pay.ORDER_REJECTED
- status nadawany przez Merchanta lub klienta w aplikacji InPost Pay (klient w aplikacji InPost Pay ma możliwość odrzucenia zamówienia przed opłaceniem). Status oznacza odrzucenie zamówienia. Zamówienie ze statusemORDER_REJECTED
nie może być opłacone w aplikacji InPost Pay.ORDER_PROCESSING
- status nadawany automatycznie przez aplikację InPost Pay, po otrzymaniu informacji od Merchanta o utworzeniu zamówienia. Zamówienie ze statusemORDER_PROCESSING
może być opłacone w aplikacji InPost Pay.
Status opisowy prezentowany klientowi w aplikacji InPost Pay - każdy Merchant może nazywać status według własnego procesu tak aby statusy prezentowane w InPost Mobile były zgodne ze statusem z platformy Merchanta.
Statusy płatności - w ramach obsługi płatności za zamówienie w InPost Pay (Basket App) będą dostępne następujące statusy płatności:
UNPAID
- status po utworzeniu zamówienia, nieopłacony. Nadawany przez InPost Pay (Basket App).STARTED
- status inicjujący proces płatności przez klienta w aplikacji InPost Mobile. Nadawany przez InPost Pay (Basket App) na podstawie informacji z aplikacji InPost Mobile.PENDING
- uruchomienie procesu. Status nadawany przez InPost Pay (Basket App) na podstawie informacji przekazanej z aplikacji InPost Mobile.AUTHORIZED
- płatność zakończona z sukcesem. Status nadawany przez InPost Pay (Basket App) na podstawie informacji przekazanej z systemu płatniczego (bramki płatniczej).DECLINED
- odmowa płatności. Status nadawany przez InPost Pay (Basket App) na podstawie informacji przekazanej z systemu płatniczego (bramki płatniczej).CANCELLED
- transakcja odrzucona. Status nadawany przez InPost Pay (Basket App) na podstawie informacji przekazanej z systemu płatniczego (bramki płatniczej).ERROR
- błąd. Status nadawany przez InPost Pay (Basket App) na podstawie informacji przekazanej z systemu płatniczego lub z aplikacji InPost Mobile.COD
- płatność przy odbiorze.
Możliwość opłacenia zamówienia jest w przypadku, gdy posiada ono status płatności UNPAID.
Możliwość ponowienia płatności jest w przypadku, gdy zamówienie posiada status płatności DECLINED
, CANCELLED
lub ERROR
.
Płatności - po złożeniu zamówienia, następuje przekierowanie do procesu płatności na poziomie aplikacji InPost Mobile. Dostępne formy płatności:
CARD
- płatność kratą debetową/kredytowąCARD_TOKEN
- płatność kartą stokenizowanąGOOGLE_PAY
- płatność z wykorzystaniem Google PayAPPLE_PAY
- płatność z wykorzystaniem Apple PayBLIK_CODE
- płatność BLIKIEMBLIK_TOKEN
- płatność BLIK ONE-CLIKPAY_BY_LINK
- płatność PBLSHOPPING_LIMIT
- płatność z wnioskiem o limit (AION)DEFERRED_PAYMENT
- płatność odroczona (AION)CASH_ON_DELIVERY
- płatność za pobraniem.