Versions Compared
Version | Old Version 7 | New Version 8 |
---|---|---|
Changes made by | ||
Saved on |
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Widget InPost Pay dostarcza możliwość parowania koszyków zakupowych w sklepach z aplikacją InPost Mobile. Warstwa frontend dostarczona jest w formie wtyczki JavaScript do osadzenia na stronie oraz niniejszej dokumentacji.
Do poprawnej integracji wymagane jest dostarczenie warstwy backend, osaczenie html wtyczki, oraz sterowanie stanem warstwy frontend poprzez dostarczenie opisanych poniżej metod.
Lista metod które należy zaimplementować w celu używania wtyczki:
1. iziGetBindingData
2. iziGetIsBound
3. iziGetOrderComplete
4. iziBindingDelete
Na tej stronie
Table of Contents |
---|
Pobranie skryptu
Skrypt wtyczki znajduje się pod adresem: https://izi.inpost.pl/inpostizi.js
Osadź go na swojej stronie przez:
Code Block | ||
---|---|---|
| ||
<script src="https://izi.inpost.pl/inpostizi.js"></script> |
Osadzenie html
W celu wyświetlenia widgetu należy osadzić w html poniższy kod:
Code Block | ||
---|---|---|
| ||
<inpost-izi-button name="" masked_phone_number="" data-product-id="" language="pl" mode=""></inpost-izi-button> |
Parametr | Opis |
---|---|
| imię kupującego, wypełnij jeśli koszyki są sparowane |
| id produktu, wymagane jeśli przy parowaniu chcesz dodać produkt o podanym id do koszyka |
| zamaskowany numer telefonu, wymagane jeśli koszyki są sparowane |
| tryb wyświetlania widgetu: details, cart, order, mini-cart, order-summary |
iziGetBindingData
Pobiera dane potrzebne do parowania koszyków.
Parametry | id - identyfikator produktu |
---|---|
Zwraca | Promise |
Wartość | dane z zapytania backend basket-app Basket App |
Code Block | ||
---|---|---|
| ||
function iziGetBindingData(id) { return Promise.resolve({ qr_code: 'string', deep_link: 'string', deep_link_hms: 'string', }); } |
iziGetIsBound
Wywoływana po wyświetleniu qr code bądź deep link w celu sprawdzenia, czy parowanie przebiegło pomyślnie. Po stronie developera należy obsłużyć komunikację tak, żeby nie obciążać zbytnio serwera przez wykorzystanie websocket bądź long pooling.
Parametry | brak |
---|---|
Zwraca | Promise |
Wartość | dane otrzymane od basket app Basket App na zapytanie |
Code Block | ||
---|---|---|
| ||
function iziGetIsBound() { return Promise.resolve({ "phone_number": { "country_prefix": "string", "phone": "string" }, "browser_trusted": boolean, "name": "string", "surname": "string" }); } |
iziGetOrderComplete
Metoda wywołana po sparowaniu koszyka i na każdej stronie z koszykiem już sparowanym. Nasłuchuje na zakończenie zamówienia w aplikacji. W odpowiedzi dostajemy url strony typu thank you page z podziękowaniem za zakupy.
Parametry | brak |
---|---|
Zwraca | Promise |
Wartość | {redirect: ‘url’} |
Code Block | ||
---|---|---|
| ||
function iziGetOrderComplete() { return Promise.resolve({ redirect: 'string' }) } |
iziGetOrderComplete
Metoda wywoływana przy usuwaniu parowania.
Parametry | brak |
---|---|
Zwraca | Promise |
Wartość | void |
Code Block | ||
---|---|---|
| ||
function iziBindingDelete() { return Promise.resolve(); } |