Confirming the binding of a basket
- Joanna Wołosz
The method informs whether or not the basket has been bound. For a successful verification of a basket's binding by the user in the InPost Pay App, to complete the process in the response, the Merchant must pass the details of the basket.
If the details of the basket haven't been transferred or the data in the response are incorrect, the basket will not be bound.
POST /v1/izi/basket/{basket_id}/confirmation
Parameters
Field name | Description | Type | Requirement status | Additional remarks |
| Basket's unique ID assigned by the Merchant | string | Y |
|
Request
Field name | Description | Type | Requirement status | Additional remarks |
| The status of the authorization of a basket's binding by the user in the app Enum:[SUCCESS, REJECT]
| string | O |
|
| The identifier of the basket assigned by the InPost Pay app. The value not to be used by the Merchant. The identifier eventually used by the widget in order to make it possible to correctly redirect from the widget level to the InPost Pay app
| string | O |
|
| Information on the number of the user the basket will be bound to | object | O |
|
| Prefix | string | Y |
|
| Telephone number | string | Y | |
| Browser Information | object | O |
|
| A flag which informs whether or not the browser has been added to the trusted ones | boolean | Y |
|
| The Id of a trusted browser assigned by InPost Pay. To be returned when browser_trusted=true | string | O | |
| Masked phone no. | string | O |
|
| InPost Pay app user's first name | string | O |
|
| InPost Pay app user's surname | string | O |
|
Response
Field name | Description | Type | Requirement status | Additional remarks |
| Object intended to transfer the basket's key data | object | Y |
|
| Object intended to transfer the main price for the basket without the delivery costs | object | Y |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| Object intended to transfer the basket's final price with any promotion and discount code taken into account without the delivery costs. | object | O |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| An object intended to transfer a basket's price with any promotion taken into account, but without any rebate code and without the delivery costs | object | O |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2)
| Y | |
| Basket's currency. Currently, the only currency available PLN | string | Y |
|
| Basket's expiration /validity date. This is the date when the basket will be automatically removed from the InPost Pay app (it becomes invalid). The date cannot be backward. | string($date-time) | O |
|
| The field is used to transfer additional information of a basket which, from the Merchant's point of view, could be significant for the customer | string | O |
|
| Preferable payment methods for the basket. The Merchant provides the list of preferred payment forms for the basket, from which the customer can choose a payment method. In the case of transferring an empty list, the customer will be presented with a default list of payment methods according to the Merchant's configuration. List of payment types available: [CARD, CARD_TOKEN, GOOGLE_PAY, APPLE_PAY, BLIK_CODE, BLIK_TOKEN, PAY_BY_LINK, SHOPPING_LIMIT, DEFERRED_PAYMENT, CASH_ON_DELIVERY] | array | Y |
|
| An object with additional information of the basket which the Merchant wants to transfer to the customer in the InPost Pay App | object | O |
|
| Information Type. We can distinguish two information types, based on which the app presents the relevant Enum message format: [ATTENTION, ERROR]
| string | Y |
|
| The message presented to the customer in the InPost Pay app for the given notice.type | string | Y |
|
| Object intended to transfer information related to delivery methods preferred for the given basket | array | Y |
|
| Delivery method.. Two forms available Enum:[APM, COURIER]
| string | Y |
|
| Suggested delivery date | string($date-time) | Y |
|
| An object intended to inform of additional delivery options. Currently two additional delivery options available:
If, for a given basket, the payment_type is CASH_ON_DELIVER, it is required to enter COD as an additional delivery option |
| O |
|
| Name of additional delivery option | string | Y |
|
| Additional delivery option code. Currently available, two codes:
| string | Y |
|
| An object intended to transfer information related to the cost of additional delivery options | object | Y |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| Object intended to transfer information related to the cost of delivery | object | Y |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| The minimum amount of a basket from which the delivery cost will be PLN 0 | number ($decimal) (10,2) | O |
|
| Functionality using the object will be available in subsequent versions of the application Object used to provide information about the estimated delivery time in the event that the customer orders goods within a specified time. | array | O |
|
| Message presented to the customer in application | string | Y | |
| Days of the week on which the message is presented | array | O | |
| The time from which the message is presented | string | O | |
| The time until which the message is presented | string | O | |
| List of promotional codes applied for the basket | array | O |
|
| Code name. In the app's next version the field not required | string | Y |
|
| Promotion code | string | Y |
|
| Specifies the type of regulation or restriction that the promotional code is subject to. | string | O |
|
| An object used to provide a list of available promotions for the cart. | array | O |
|
| Code type: ONLY_IN_APP - code available only in InPost Pay app (TYLKO W APCE). | string | Y | |
| Code value e.g. DOSTAWA | string | Y | |
| Code description Max: 60 characters | string | Y | |
| Start date from which the code is valid | string($date-time) | O | |
| End date until which the code is valid | string($date-time) | O | |
| Code priority | integer | O | |
| Code details | object | Y | |
| Link to code information details on the merchant's website | string | Y | |
| List for providing information of the products in the basket | array | Y |
|
| Product ID assigned by the Merchant | string | Y |
|
| Product category assigned by the Merchant | string | O |
|
| Ean | string | O |
|
| Product name | string | Y |
|
| Product description | string | O |
|
| Link to the product on the Merchant's website | string | O |
|
| Link to a photograph of the product. Formats preferable: png, jpg (recommendation: png without background) | string | O |
|
| Object to pass additional product images (list) | object | O |
|
| Product image. | string | Y |
|
| Product image. | string | Y |
|
| Product's base price | object | Y |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| Promotional price of the product | object | O |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| Object intended to transfer the lowest price of the product over the previous 30 days. Required in order to handle the Omibus directive. Object required to be transferred if the product's promotional price was provoded (obiekt promo_price). | object | O |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| Object for reporting the product quantity | object | Y |
|
| product quantity | number ($decimal) | Y |
|
| Field type quantity. Available values: [DECIMAL, INTEGER] If the quantity_type of the product is INTEGER, then the Merchant provides the price for 1 piece. If the quantity_type of the product is DECIMAL, then the Merchant provides the price for the product quantity selected. · Example 1) We have 5 pcs of shirts 10 PLN a piece. In such a case, the quantity_type, is INTEGER and the product's price is PLN 10. · Example 2) We have 0.35 kg of flour, costing PLN 5. In such a case, the quantity_type, is DECIMAL and the product's price is PLN 5. | string | Y |
|
| Quantity unit of the product | string | O |
|
| The quantity available at the store | number ($decimal) | O |
|
| The minimum number of the product a Customer can order e.g. at one order | number ($decimal)
| O |
|
| The maximum number of the product a Customer can order e.g. at one order | number ($decimal) | O |
|
| The quantity jump value in case of increase/decrease of product quantity by customer (e.g. 0.1 or 0.5 or 0.01) | number ($decimal) | O |
|
| Object intended to determine the product's attributes | array | O |
|
| Attribute name | string | Y |
|
| Attribute value | string | Y | |
| Object used to provide information about available delivery methods for a product. If there is no | object | O |
|
| Delivery type | string | O |
|
| Flag indicating whether the delivery type is available. | boolean | O |
|
| Object intended to transfer the list of products suggested for a given basket that the customer can add from the level of the InPost Pay app | array | O |
|
| Product ID assigned by the Merchant | string | Y |
|
| Product category assigned by the Merchant | string | O |
|
| Ean | string | O |
|
| Product name | string | Y |
|
| Product description | string | O |
|
| Link to the product on the Merchant's website | string | O |
|
| Link to a photograph of the product. Formats preferable: png, jpg (recommendation: png without background) | string |
|
Formats preferable: png, jpg (recommendation: png without background) |
| Object to pass additional product images (list) | object | O |
|
| Product image. Preferred size 360 x 352 | string | Y |
|
| Product image. Preferred size 360 x 504 | string | Y |
|
| Product's base price | object | Y |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2) | Y | |
| Promotional price of the product | object | O |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2)
| Y | |
| Object intended to transfer the lowest price of the product over the previous 30 days. Required in order to handle the Omibus directive. Object required to be transferred if the product's promotional price was provoded (obiekt promo_price). | object | O |
|
| Net price | number ($decimal) (10,2) | Y |
|
| Gross Price (net + VAT) | number ($decimal) (10,2) | Y | |
| VAT | number ($decimal) (10,2)
| Y | |
| Object for reporting the product quantity | object | Y |
|
| product quantity | number ($decimal) | Y |
|
| Field type quantity. Available values: [DECIMAL, INTEGER] | string | Y |
|
| Quantity unit of the product | string | O |
|
| The quantity available at the store | number | O |
|
| The minimum number of the product a Customer can order e.g. at one order | number ($decimal) | O |
|
| The maximum number of the product a Customer can order e.g. at one order | number | O |
|
| The quantity jump value in case of increase/decrease of product quantity by customer (e.g. 0.1 or 0.5 or 0.01) | number ($decimal) | O |
|
| Object intended to determine the product's attributes | array | O |
|
| Attribute name | string | Y |
|
| Attribute value | string | Y |
|
| Object used to provide information about available delivery methods for a product. If there is no delivery_product object, it means that delivery is available in all types. | object | O |
|
| Delivery type | string | O |
|
| Flag indicating whether the delivery type is available. | boolean | O |
|
| Object informing whether the customer will receive free shipping after adding the suggested product to the cart If if_delivery_free= true is on a given suggested product, the customer will be presented with an appropriate message on that product. | boolean | O |
|
| Object intended to transfer the list of consents for a given basket | array | Y |
|
| Consent Id assigned by the Merchant | string | Y |
|
| The link which redirects to the full content of a consent eg. to the Merchant's website | string | Y |
|
| Label to the link passed in | string | O |
|
| Object used to provide an additional link to the consent/regulations | object | O |
|
| Consent ID assigned by the merchant | string | O |
|
| Link redirecting to the full content, e.g. to the merchant’s website | string | O |
|
| Label to the link passed in | string | O |
|
| Description of the consent, not more than 500 characters | string | Y |
|
| Consent version | string | Y |
|
| Consent type. Available values Enum: [OPTIONAL, REQUIRED_ONCE, REQUIRED_ALWAYS]
| string | Y |
|
| Object used to pass the customer's shopping cart cookie in order to enable redirection from the application to the shopping cart in the merchant's store. | object | O |
|
| Url of the merchant shop | string | Y |
|
| Object used to pass the cookie | array | Y |
|
| The cookie domain represented by pair key-value | string | Y |
|
| Cookie key | string | Y |
|
| Cookie value | string | Y |
|
| Cookie path | string | Y |
|
| Cookie expiration time or maxAge | string($date-time) | O |
|
| Cookie security information | boolean | O |
|
| Cookie http information | boolean | O |
|
| Cookie sameSite information [ STRICT, LAX, NONE ] | string | O |
|
| Cookie priority [ LOW, MEDIUM, HIGH ] | string | O |
|
| Cookie max age | integer($int32) | O |
|
Example request
{
"status": "SUCCESS",
"inpost_basket_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
"phone_number": {
"country_prefix": "+48",
"phone": "5xxxxxxxx"
},
"browser": {
"browser_trusted": true,
"browser_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
},
"masked_phone_number": "5x*****xx",
"name": "<secret>",
"surname": "<secret>"
}
Response
"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"
}
]
}