Do wszystkich usług wołanych przez InPost Pay (Basket App) w Backend merchanta zostaną dodane poniższe nagłówki (headery). Obecnie nagłówki są opcjonalne, ale docelowo będą wymagane.
Nagłówek
Opis
Nagłówek
Opis
x-signature
Sygnatura
x-signature-timestamp
Ciąg daty i czasu ISO8601 w strefie czasowej UTC z czasem wygenerowania podpisu, np. 2023-05-11T15:02:23.429Z
x-public-key-ver
Wersja kluczy użytych do wygenerowania podpisu
x-public-key-hash
SHA-256 hash klucza publicznego użytego do wygenerowania podpisu
echo "$PUBLIC_KEY_BASE64" | openssl base64 -d -A | openssl rsa -pubin -inform DER -outform PEM -out pubkey.pem replace $PUBLIC_KEY_BASE64 with value from field: public_key_base64
DIGEST=$(echo -n "$(<message_body)" | openssl dgst -sha256 -binary | openssl enc -base64 -A) where message_body is a file with EXACT request body (without any additions, whitespaces etc.)
echo -n "$DIGEST,$EXTERNAL_MERCHANT_ID,$KEY_VERSION,$SIGNATURE_TIMESTAMP" | openssl enc -base64 -A -out signature_string where $EXTERNAL_MERCHANT_ID value is from public key endpoint - field merchant_external_id, $KEY_VERSION value is from header x-public-key-ver and $SIGNATURE_TIMESTAMP value is from x-signature-timestamp
openssl enc -base64 -d -A -in request_signature -out signature.bin where request_signature is a file with value from header x-signature
openssl dgst -sha256 -verify pubkey.pem -signature signature.bin signature_string should print Verified OK
Lista metod wystawianych przez merchanta służąca do komunikacji z InPost Pay
Metoda
Opis
Koszyk
GET /v1/izi/basket/{basketId}
Pobranie szczegółów koszyka
POST /v1/izi/basket/{basketId}/confirmation
Potwierdzenie dodania koszyka
POST /v1/izi/basket/{basketId}/event
Przesłanie informacji o aktualizacji koszyka
DELETE /v1/izi/basket/{basketId}/binding
Desynchronizacja koszyka (rozparowanie koszyka z numerem tel.)
{ "summary": { "basket_base_price": { "net":"249.59", "gross":"307.00", "vat":"57.41" }, "basket_final_price": { "net":"242.01", "gross":"297.67", "vat":"55.66" }, "basket_promo_price": { "net":"242.01", "gross":"297.67", "vat":"55.66" }, "currency":"PLN", "basket_expiration_date":"2023-08-25T11:09:29.000Z", "basket_additional_information":"", "payment_type": [ "CARD", "CARD_TOKEN", "APPLE_PAY", "BLIK_CODE", "BLIK_TOKEN", "PAY_BY_LINK", "SHOPPING_LIMIT", "DEFERRED_PAYMENT", "GOOGLE_PAY", "CASH_ON_DELIVERY" ], "basket_notice":null }, "delivery": [ { "delivery_type":"APM", "delivery_date":"2023-08-25T12:00:00.000Z", "delivery_options":[], "delivery_price": { "net":"0.00", "gross":"0.00", "vat":"0.00" } }, { "delivery_type":"COURIER", "delivery_date":"2023-08-25T12:00:00.000Z", "delivery_options":[], "delivery_price": { "net":"0.00", "gross":"0.00", "vat":"0.00" } } ], "promo_codes":[], "products": [ { "product_id":10678, "product_category":53, "ean":"wp-pennant-1", "product_name":"Klocki Paczkomat InPost z samochodem eko", "product_description":" \r\n\r\nA wiesz, że każdy jest kurierem własnego życia? Przecież gdy mówisz, to dostarczasz informacje, a jak się uśmiechasz to... dostarczasz radość. Jeszcze większą radość zobaczysz na twarzy dziecka, gdy dostarczysz mu zestaw klocków: paczkomat wraz z ekobusem.\r\n\r\nTo unikalny zestaw, dzięki któremu dzieci mogą wcielić się w rolę kuriera i poczuć jak to jest, gdy dostarcza się same dobre wiadomości czy prezenty. A co najlepsze, klocki pasują do innych klocków konstrukcyjnych co sprawia, że możliwości zabawy stają się nieograniczone.\r\n\r\nKlocki przeznaczone są dla dzieci od 8 lat, ale potrafią obudzić dziecko w człowieku do 80 lat i więcej. W końcu dobra zabawa nie zna wieku.", "product_link":"https://outofthebox.pl/product/paczkomat-inpost-z-samochodem-eko/", "product_image":"https://outofthebox.pl/app/uploads/2022/11/INPOST_aranzacje-z-modelami18.jpg", "base_price": { "net":"113.01", "gross":"139.00", "vat":"25.99" }, "promo_price": { "net":"113.01", "gross":"139.00", "vat":"25.99" }, "quantity": { "quantity":2, "quantity_type":"INTEGER", "quantity_unit":"pcs", "available_quantity":7507, "max_quantity":7507 }, "product_attributes": [ { "attribute_name":"Wymiary/Pojemność", "attribute_value":"344 cm x 60 cm x 240 cm" } ], "variants":[] }, { "product_id":549, "product_category":20, "ean":"0", "product_name":"Paczkotorba bawełniana", "product_description":" \r\n\r\nTa torba bawełniana lubi być czysta i wyprana. Lubi, bo jest z bawełny, tak jak wiele Twoich ubrań. Dlatego pralka nie robi jej krzywdy.\r\n\r\nTorba polecana jest szczególnie tym, którzy nie chcą za każdym razem wracać z zakupów z toną jednorazowych woreczków foliowych.\r\n\r\nTorba jest szyta lokalnie. W Polsce, a nie na końcu świata.\r\n\r\nMetr kwadratowy materiału, z którego stworzono torbę, waży 280 gramów. Gdyby miała ręce, włożyłaby sobie do środka spory ciężar i nic by się jej nie stało.\r\n\r\nUwaga: torba InPost ma wielkie uszy, żeby można było ją nosić w stylu out of the box.", "product_link":"https://outofthebox.pl/product/paczkotorba-bawelniana/", "product_image":"https://outofthebox.pl/app/uploads/2022/10/INPOST_aranzacje-z-modelami24-1.jpg", "base_price": { "net":"23.58", "gross":"29.00", "vat":"5.42" }, "promo_price": { "net":"15.99", "gross":"19.67", "vat":"3.68" }, "quantity": { "quantity":"1", "quantity_type":"INTEGER", "quantity_unit":"pcs", "available_quantity":240, "max_quantity":240 }, "product_attributes":[], "variants":[] } ], "related_products": [ { "product_id":606, "product_category":17, "ean":"0", "product_name":"Paczkokurtka","product_description":" \r\n\r\nNormalne kurtki są normalne.\r\n\r\nPrzód i tył. Lewy rękaw i prawy rękaw. Kaptur i kieszenie.\r\n\r\nKurtki InPost -- są zawsze out of the box! Oprócz wszystkiego, co ma normalna kurtka -- mają jeszcze ogromną kieszeń, są wodoodporne i wiatroszczelne. Ta kieszeń jest tak duża, że może pomieścić w sobie na przykład paczkę. Albo coś innego, co tylko przyjdzie Ci do głowy.\r\nWierzchni materiał pokryty jest powłoką Water Repellent, dzięki czemu woda skrapla się na jego powierzchni\r\n\r\nBo wszystko, co najlepsze, zaczyna się od głowy.\r\nOd pomysłu, który jest inny.\r\n\r\nKtóry jest Out of the box!\r\n\r\nPaczkokurtka InPost dostępna jest w czterech rozmiarach: S, M, L, XL.", "product_link":"https://outofthebox.pl/product/paczkokurtka-rozm-s/", "product_image":"https://outofthebox.pl/app/uploads/2022/10/INPOST_aranzacje-z-modelami25-1.jpg", "base_price": { "net":"172.07", "gross":"211.65", "vat":"0.00" }, "promo_price": { "net":"172.07", "gross":"211.65", "vat":"0.00" }, "quantity": { "quantity":1, "quantity_type":"INTEGER", "quantity_unit":"pcs", "available_quantity":999, "max_quantity":999 }, "product_attributes":[], "variants":[] }, { "product_id":452, "product_category":53, "ean":"0", "product_name":"Klocki Sortownia", "product_description":"sdadsadsadasdas", "product_link":"https://outofthebox.pl/product/sortownia/", "product_image":"https://outofthebox.pl/app/uploads/2022/10/INPOST_aranzacje-z-modelami17.jpg", "base_price": { "net":"186.18", "gross":"229.00", "vat":"0.00" }, "promo_price": { "net":"186.18", "gross":"229.00", "vat":"0.00" }, "quantity": { "quantity":1, "quantity_type":"INTEGER", "quantity_unit":"pcs", "available_quantity":55844, "max_quantity":55844 }, "product_attributes":[], "variants":[] } ], "consents": [ { "consent_id":3, "consent_link":"https://outofthebox.pl/zwroty-i-reklamacje/", "consent_description":"zwroty i reklamacje", "consent_version":1, "requirement_type":"OPTIONAL" } ] }
"summary": { "basket_base_price": { "net": 80.49, "gross": 99.00, "vat": 18.51 }, "basket_final_price": { "net": 80.49, "gross": 99.00, "vat": 18.51 }, "basket_promo_price": { "net": 80.49, "gross": 99.00, "vat": 18.51 }, "currency": "PLN", "basket_expiration_date": "2023-08-25T09:26:01.000Z", "basket_additional_information":"", "payment_type": [ "CARD", "CARD_TOKEN", "APPLE_PAY", "BLIK_CODE", "BLIK_TOKEN", "PAY_BY_LINK", "GOOGLE_PAY", "CASH_ON_DELIVERY" ] "basket_notice":null }, "delivery": [ { "delivery_type": "APM", "delivery_date": "2023-08-25T12:00:00.000Z", "delivery_options": [], "delivery_price": { "net": 0.00, "gross": 0.00, "vat": 0.00 } }, { "delivery_type": "COURIER", "delivery_date": "2023-08-25T12:00:00.000Z", "delivery_options": [], "delivery_price": { "net": 0.00, "gross": 0.00, "vat": 0.00 } } ], "promo_codes": [], "products": [ { "product_id": "585", "product_category": "20", "ean": "0", "product_name": "Drewniane bule", "product_description": " \r\n\r\nCo to są bule? Na mieście mówią, że „bule to kule na nudy bóle". To gra, w której zasady są proste, a emocje sięgają 10 piętra. Bule to kule. W tym przypadku -- drewniane, z twardego drewna bukowego. Jedna z nich to świnka zwana prosiaczkiem. Taka kruszynka-wieprzowinka.\r\n\r\nCo trzeba mieć, żeby zagrać w bule? Przynajmniej jednego przyjaciela. Albo przyjaciółkę. Albo sąsiada, wujka, kuzynkę, znajomego, brata, siostrę, kolegę. Trzeba też mieć kawałek trawnika, może być bez trawy. Bule to rzucanie kulami w świnkę. Kto rzuci najbliżej, ten wygrywa. Gra w bule jest prosta, choć kule są okrągłe. Dziwne, co nie?", "product_link": "https://outofthebox.pl/product/drewniane-bule/", "product_image": "https://outofthebox.pl/app/uploads/2022/10/INPOST_aranzacje3-1.jpg", "base_price": { "net": 80.49, "gross": 99.00, "vat": 18.51 }, "promo_price": { "net": 80.49, "gross": 99.00, "vat": 18.51 }, "quantity": { "quantity": 1, "quantity_type": "INTEGER", "quantity_unit": "pcs", "available_quantity": 275, "max_quantity": 275 }, "product_attributes": [], "variants": [] } ], "related_products": [ { "product_id": "567", "product_category": "20", "ean": "0", "product_name": "Mata do ćwiczeń", "product_description": " \r\n\r\nNie wiemy, ile korków wystrzelonych w Sylwestra potrzeba do stworzenia korkowej maty do jogi. Ale wiemy, że dzięki niej możesz zacząć całkiem nowy czas w swoim życiu.\r\n\r\nĆwiczenia na niej to prawdziwy body & soul balance.\r\n\r\nZatem rusz swe "body" po naturalny zastrzyk energii i zadbaj o relaks swojej "soul". Warto wiedzieć, że mata korkowa z naturalnego kauczuku ma najlepsze właściwości antypoślizgowe.", "product_link": "https://outofthebox.pl/product/mata-do-cwiczen/", "product_image": "https://outofthebox.pl/app/uploads/2022/10/INPOST_aranzacje25.jpg", "base_price": { "net": 202.44, "gross": 249.00, "vat": 0.00 }, "promo_price": { "net": 202.44, "gross": 249.00, "vat": 0.00 }, "quantity": { "quantity": 1, "quantity_type": "INTEGER", "quantity_unit": "pcs", "available_quantity": 197485, "max_quantity": 197485 }, "product_attributes": [ { "attribute_name": "Wymiary/Pojemność", "attribute_value": "183x61 cm, 4 mm grubości" }, { "attribute_name": "Materiał", "attribute_value": "Korek i naturalny kauczuk" }, { "attribute_name": "Waga", "attribute_value": "2.6 kg" } ], "variants": [] }, { "product_id": "554", "product_category": "20", "ean": "0", "product_name": "Paryżanka", "product_description": " \r\n\r\nCzy wiesz, co tak naprawdę widzą ludzie, kiedy idziesz sobie z paryżanką?\r\n\r\nWidzą, że jesteś EKO. Nie używasz foliowych woreczków jednorazowego użytku.\r\n\r\nWidzą, że jesteś modna. W końcu Paryż to miejsce, w którym od dawna decyduje się o tym, co warto ze sobą nosić.\r\n\r\nParyżanka nie kryje się z tym, że wygląda rewelacyjnie, kiedy jest wypełniona świeżymi owocami.\r\n\r\nWidzą też, że lubisz naturalne materiały, bo paryżanka wykonana jest w 100 procentach z bawełny.\r\n\r\nI że w swoim życiu działasz zgodnie z zasadą out of the box.\r\nPo swojemu. Jak InPost.", "product_link": "https://outofthebox.pl/product/paryzanka/", "product_image": "https://outofthebox.pl/app/uploads/2022/10/INPOST_aranzacje11-1.jpg", "base_price": { "net": 23.58, "gross": 29.00, "vat": 0.00 }, "promo_price": { "net": 23.58, "gross": 29.00, "vat": 0.00 }, "quantity": { "quantity": 1, "quantity_type": "INTEGER", "quantity_unit": "pcs", "available_quantity": 468, "max_quantity": 468 }, "product_attributes": [], "variants": [] } ], "consents": [ { "consent_id": "3", "consent_link": "https://outofthebox.pl/zwroty-i-reklamacje/", "consent_description": "zwroty i reklamacje", "consent_version": "1", "requirement_type": "OPTIONAL" } ] }