Order

Owned by Joanna Wołosz
Last updated: Mar 21, 2024
4 min read

This chapter describes handling and performing orders with the InPost Pay service together with a list and description of the methods called by the Merchant to InPost, to update an order or download the list of orders.

List of methods

Order Processing with the InPost Pay service

  1. After the user chooses the option "Kupuję i płacę (Buy and pay)" in the InPost Mobile app, before the actual commencement of the payment for the basket, InPost Pay verifies the status of the basket, by downloading the current basket from the Merchant and comparing it with the basket saved in InPost Pay. If the current basket downloaded from the Merchant is the same as the one saved in InPost Pay, then it is verified if the order can be placed. The validation of the order for correctness is performed on the Merchant's side. If the product is not available or another validation is not fulfilled, the order is not created. In such a case, the user sees the relevant message, and  they may keep edit the basket.

  2. After an order is created correctly, the basket cannot be edited anymore from the InPost Mobile level, and should not be available for editing on the Merchant's website.

  3. When creating an order, InPost Mobile transfers to the Merchant:

    1. The identifier of the basket, based on which the order is to be created

    2. The final value of the basket with the delivery cost

    3. The payment form chosen by the customer

    4. The ordering party's data (first name, last name, email adres, phone number)

    5. The ordering party's address (optional)

    6. The form and address of the delivery

    7. Invoice data

    8. Comments to order

    9. Information on the consents accepted

  4. When the Customer pays for an order in the InPost Pay app, this information is transferred to the Merchant in order to begin the implementation of the order.

  5. If the COD payment is selected, the order is considered paid immediately.

  6. The Merchant updates the changes in the status of the order along with transferring the information regarding the shipments (one or several), used to send the order. The statuses handled when ordering:

    1. Technical status - used to specify the authorizations that the customer may exercise for the order in the InPost Pay app. We can distinguish 3 technical statuses:

      1. ORDER_COMPLETED- the status assigned by the merchant, informing the InPost Pay app that the order was completed by the customer on the merchant store's website. An order with the status ORDER_COMPLETED cannot be paid and rejected in the InPost Pay app.

      2. ORDER_REJECTED- the status assigned by the Merchant, or the customer in the InPost Pay app (in the InPost Pay App the customer has the option of rejecting the order before it is paid). The status means the order was rejected. An order with the status ORDER_REJECTED cannot be paid in the InPost Pay app.

      3. ORDER_PROCESSING- the status assigned automatically by the InPost Pay app after being informed by the Merchant of creating an order. An order with the ORDER_PROCESSING status may be paid in the InPost Pay App.

    2. A descriptive status presented to the customer in the InPost Pay app - each Merchant can name a status according to their own process, so that the statuses presented in InPost Mobile are compliant with the status on the Merchant's platform.

  7. Payment statuses - within the payment handling for an order in InPost Pay (Basket App), the following payment statuses will be available:

    1. UNPAID- the status upon the creation of an order, unpaid. Assigned by InPost Pay (Basket App).

    2. STARTED- the status initiates the customer's payment proces in the InPost Mobile app. Assigned by InPost Pay (Basket App), based on of information from the InPost Mobile app.

    3. PENDING- process commencement. The status assigned by the InPost Pay (Basket App), on the basis of the information transferred from the InPost Mobile app.

    4. AUTHORIZED- payment successful. The status assigned by InPost Pay (Basket App), on the basis of the information transferred from the payment system (payment gate).

    5. DECLINED- payment denial. The status assigned by InPost Pay (Basket App), on the basis of the information transferred from the payment system (payment gate).

    6. CANCELLED- transaction rejected. The status assigned by InPost Pay (Basket App), on the basis of the information transferred from the payment system (payment gate).

    7. ERROR- error. The status assigned by InPost Pay (Basket App), on the basis of the information transferred from the payment system. or from the InPost Mobile app.

    8. COD- cash on delivery.

The ability to pay for an order is available when it has the payment status UNPAID.
Repeating the payment is possible when an order has the payment status DECLINED, CANCELLED, or ERROR.

  1. Payments - redirecting to the payment process at the InPost Mobile app level after placing an order. Available payment forms:

    1. CARD - payment with a debit/credit card

    2. CARD_TOKEN - payment with a tokenized card

    3. GOOGLE_PAY - payment using Google Pay

    4. APPLE_PAY - payment using Apple Pay

    5. BLIK_CODE - BLIK payment

    6. BLIK_TOKEN- BLIK ONE-CLIK payment

    7. PAY_BY_LINK - PBL payment

    8. SHOPPING_LIMIT - payment with a limit request: (AION)

    9. DEFERRED_PAYMENT - payment postponed (AION)

    10. CASH_ON_DELIVERY - cash on delivery.