Confirming the binding of a basket

Field name

Description

Type

Requirement status

Additional remarks

basket_id

Basket's unique ID assigned by the Merchant

string

Y

Field name

Description

Type

Requirement status

Additional remarks

status

Authorization status for basket linking by the user in the application Enum:[ SUCCESS, REJECT ]

SUCCESS – basket has been successfully linked

REJECT – linking rejected by the customer

string

O

inpost_basket_id

Basket identifier assigned by the InPost Pay app. Value not used by the Merchant. Identifier will ultimately be used by the widget to enable proper redirection from the widget to the InPost Pay app

string

O

 "inpost_basket_id": " 866e5bf6-4e8a-443e-98f5-f9b0c5c149dd"

phone_number

Information about the user number to which the basket will be linked

object

O

country_prefix

Prefix

string

Y

"phone_number":{"country_prefix":"+48","phone":"600000000"}

phone

Phone number

string

Y

browser

Browser information

object

O

browser_trusted

Flag indicating whether the browser has been added to trusted

boolean

Y

"browser":{"browser_trusted":true,"browser_id":"fbfac472-3bcc-4c2c-bd41-968032233e03"}

browser_id

The trusted browser ID assigned by InPost Pay. Returned when browser_trusted=true

string

O

masked_phone_number

Masked phone number

string

O

"masked_phone_number":"60*****00"

name

First name of the InPost Pay app user

string

O

"name":"Piotr"

surname

Surname of the InPost Pay app user

string

O

"surname":"Nowak"

Field name

Description

Type

Requirement status

Additional remarks

summary

Object used to provide basic details about the basket

object

Y

summary.basket_base_price

Object used to pass the base price for the basket without delivery costs

object

Y

summary.basket_base_price.net

Net price

number ($decimal) (10,2)

Y

"summary":{"basket_base_price":{"net":"250.00","gross":"307.50","vat":"57.5

summary.basket_base_price.gross

Gross price (net + VAT)

number ($decimal) (10,2)

Y

summary.basket_base_price.vat

VAT

number ($decimal) (10,2)

Y

summary.basket_final_price

An object used to pass the final price of a basket with a promotion and discount code included on the basket, without delivery costs.
The value of the discount on the basket resulting from the application of the code (a promotional code that is not regulated by the OMNIBUS Directive), shown in the basket summary, will be the difference between promo_price and final_price or base_price and final_price, if the basket is not covered by a promotion.

object

O

summary.basket_final_price.net

Net price

number ($decimal) (10,2)

Y

"basket_final_price":{"net":"220.00","gross":"270.60","vat":"50.60"}

summary.basket_final_price.gross

Gross price (net + VAT)

number ($decimal) (10,2)

Y

summary.basket_final_price.vat

VAT

number ($decimal) (10,2)

Y

summary.basket_promo_price

An object for passing the price of a basket with a promotion included for the basket, but without an applied discount code and without delivery costs.

object

O

summary.basket_promo_price.net

Net price

number ($decimal) (10,2)

Y

"basket_promo_price":{"net":"220.00","gross":"270.60","vat":"50.60"}

summary.basket_promo_price.gross

Gross price (net + VAT)

number ($decimal) (10,2)

Y

summary.basket_promo_price.vat

VAT

number ($decimal) (10,2)

Y

summary.free_basket

The flag indicating whether the basket without delivery costs is free.

boolean

O

summary.currency

Basket currency. The only currency currently supported is PLN

string

Y

"currency":"PLN"

summary.basket_expiration_date

Basket expiration/validity date. This is the date after which the basket will be automatically removed from the InPost Pay app (will expire). The date cannot be a past date.

string($date-time)

O

"basket_expiration_date":"2023-09-13T07:40:53.000Z"

summary.basket_additional_information

This field is used to provide additional information about the basket that, from the Merchant's point of view, may be relevant to the customer

string

O

"basket_additional_information": "Order today, and receive a discount code for future purchases"

summary.payment_type

Preferred payment method for the basket. The Merchant passes a list of preferred payment methods for the basket from which the customer can then select payment methods. If an empty list is passed, the customer will be presented with a default list of payments according to the merchant's configuration in the payment gateway and CASH_ON_DELIVERY when "delivery_code_value" ="COD" has been passed for the relevant delivery option in "delivery".

List with possible payment types: [ CARD, CARD_TOKEN, GOOGLE_PAY, APPLE_PAY, BLIK_CODE, BLIK_TOKEN, PAY_BY_LINK, SHOPPING_LIMIT, DEFERRED_PAYMENT, CASH_ON_DELIVERY]

array

Y

 "payment_type":["CARD","CARD_TOKEN","APPLE_PAY","BLIK_CODE","BLIK_TOKEN","PAY_BY_LINK","SHOPPING_LIMIT","DEFERRED_PAYMENT","GOOGLE_PAY"],

summary.basket_notice

Object with additional information about the basket that the Merchant wants to provide to the customer in the InPost Pay app

object

O

summary.basket_notice.type

Type of information. There are two types of information based on which the application will present the appropriate format of the message Enum: [ ATTENTION, ERROR ]:

ATTENTION – used when we want to inform the customer about important information on the basket, such as the application of a promotional code, the addition of a free product, etc.

ERROR – used when some action on the basket failed, such as an invalid promo code or a failed attempt to add a suggested product.

string

Y

"type":"ATTENTION"

summary.basket_notice.description

The contents of the message presented to the customer in the InPost Pay app for the relevant notice.type

string

Y

"description": "the code has been activated"

summary.basket_additional_parameters

An object used to pass additional basket parameters that are saved in the basket details during basket creation/update. The Merchant can use this object, for example, to save parameters that will enable identification/association of the basket with a campaign. Additional parameters are not displayed in the application.

array

O

summary.basket_additional_parameters.key

Key

string

Y

summary.basket_additional_parameters.value

Value

string

Y

delivery

An object used to provide information about the preferred delivery options for the relevant basket

array

Y

delivery.delivery_type

Delivery option. Enum:[ APM, COURIER, DIGITAL ].  

APM – automated parcel machine, COURIER – InPost courier service 
DIGITAL – digital delivery

string

Y

"delivery_type":"APM"

delivery.delivery_date

Suggested delivery date

string($date-time)

Y

"delivery_date":"2023-09-14T12:00:00.000Z"

delivery.delivery_options

An object used to pass information about additional delivery options. Currently, two additional delivery options are available:

PWW – weekend parcel

COD – cash on delivery.

If the CASH_ON_DELIVERY value is passed for the relevant basket in payment_type, it is mandatory to pass COD as an additional delivery option

O

delivery.delivery_options.delivery_name

Name of additional delivery option

string

Y

"delivery_name": "Paczka w Weekend"

delivery.delivery_options.delivery_code_value

Additional delivery option code. Currently, there are two codes available:

PWW – weekend parcel

COD – cash on delivery

string

Y

 "delivery_code_value": "PWW"

delivery.delivery_options.delivery_option_price

An object used to pass information about the cost of additional delivery option

object

Y

delivery.delivery_options.delivery_option_price.net

Net price

number ($decimal) (10,2)

Y

"delivery_option_price ":{"net":"10.00","gross":"12.30","vat":"2.30"}

delivery.delivery_options.delivery_option_price.gorss

Gross price (net + VAT)

number ($decimal) (10,2)

Y

delivery.delivery_options.delivery_option_price.vat

VAT

number ($decimal) (10,2)

Y

delivery.delivery_price

An object used to provide information about the cost of delivery

object

Y

delivery.delivery_price.net

Net price

number ($decimal) (10,2)

Y

"delivery_price":{"net":"10.00","gross":"12.30","vat":"2.30"}

delivery.delivery_price.gorss

Gross price (net + VAT)

number ($decimal) (10,2)

Y

delivery.delivery_price.vat

VAT

number ($decimal) (10,2)

Y

free_delivery_minimum_gross_price

Minimum basket value starting from which the cost of delivery will be PLN 0

number ($decimal) (10,2)

O

"free_delivery_minimum_gross_price": "100.00"

promo_codes

List of promotional codes applied to the basket

array

O

promo_codes.name

Code name. This field is not required in the next version of the application.

string

Y

 "name ": "Promotion 5%"

promo_codes.promo_code_value

The type of regulation or restriction to which the promo code is subject.

NOTE: Where the promo code is a code within the meaning of the OMNIBUS Directive, then the “OMNIBUS” value should be passed.

string

Y

"promo_code_value": "INPOST10"

promo_codes.regulation_type

Promo code

string

O

"regulation_type": "OMNIBUS"

promotions_available

A list of available promo codes that customers can apply to the basket.

array

O

"promotions_available": [
{
"type": "MERCHANT",
"promo_code_value": "IZI",
"description": "Super promocja -- 20 PLN ",
"start_date": "2024-10-03T07:33:13.942Z",
"end_date": "2024-11-03T07:33:13.942Z",
"priority": 0,
"details": { "link": " https://inpostpay.pl/ " } } ],