InPost Pay - Woocommerce (Widget 2.0) [ENG]
Introduction
Technical documentation of the InPost Pay plugin for Woocommerce with Widget 2.0 support.
The plugin adds functionality to Woocommerce store that allows to place orders through the InPost app by:
Adding an array in the database,
Adding the "Create basket with InPost Pay" button on the product card,
Adding the "Buy with InPost Pay" button on the basket page,
Adding the "Buy with InPost Pay" button on the order page,
Actions performed on standard hooks,
Adding a field on the order page,
Adding an administration section,
Providing access to REST API,
Attaching a JS file served from webserver and a file served from an external resource to the page.
Plugin
Version 3.0.1 (21.07.2026)
Changelog
On this page:
- 1 Introduction
- 2 Plugin
- 2.1 Changelog
- 3 Requirements
- 4 Installation / Update
- 5 Test Configuration
- 6 Production Configuration
- 7 Instructions for configuring functional cookies for cookie plugins in a WooCommerce shop with InPostPay
- 8 Promoted products
- 9 Suggested products
- 10 Unavailable Products and Categories
- 11 Logistics plugin
- 12 Support for Digital Products and Electronic Deliveries
- 13 Full configuration
- 13.1 API settings
- 13.2 Environment
- 13.3 Show widget
- 13.4 Client ID
- 13.5 Client Secret
- 13.6 POS ID
- 13.7 Merchant ID
- 13.8 Enable payments consistent with the signed agreement with the bank
- 13.9 Enable cash on delivery in accordance with the signed agreement with InPost
- 13.10 Select payment methods available in the app
- 13.11 Virtual payment method
- 13.12 Order status for an order paid through InPost Pay
- 13.13 Order status names
- 13.14 Maximum number of suggested products
- 13.15 Custom Thank You Page (optional)
- 13.16 Settings for transferred descriptions
- 13.17 Refresh page after adding product to cart
- 13.18 Response format
- 13.19 Phone-based user lookup in order history
- 13.20 Refresh WooCommerce cart fragments after basket update from the app
- 13.21 Early basket update response (bypass shutdown hook)
- 13.22 Output buffer for order creation (emergency mode)
- 13.23 Additional WooCommerce actions for orders and basket
- 14 Consents
- 14.1 Description of available options:
- 14.1.1 Consent address
- 14.2 Link ID
- 14.3 Link label
- 14.4 Descriptions visible in the app
- 14.5 Whether required
- 14.1 Description of available options:
- 15 InPost Pay coupons
- 16 Transport costs
- 17 Button appearance
- 17.1 Background
- 17.2 Variant
- 17.3 Rounding
- 17.4 Widget size
- 17.5 Display
- 17.6 Location
- 17.7 Position
- 17.8 Margin
- 18 Marketing
- 19 Support
- 20 Advertising analytics (GA4, Meta Ads, Google Ads)
- 21 Support for custom order numbers (aliases)
- 22 InPost Pay Shipping Filter
- 23 Display in a non-standard location
- 24 Programmable actions
- 25 Adding an InPost Pay widget using Gutenberg blocks
- 26 Adding an InPost Pay widget using Elementor
- 27 Uninstallation
Requirements
In order to function properly, the plugin requires:
Woocommerce version not older than 7.0.0
PHP version not older than 7.4
Installation / Update
Follow the steps below to install the plugin:
Download the zipped Woocommerce plugin from the InPost website and do not unzip it
Log in to the administration section of your store
From the menu on the left, select "Plugins" and then "Add new"
At the top of the page, select "Upload plugin to server" then "Select file" and locate the zipped plugin file downloaded in step 1
Click "Install”
In the next window, click "Enable plugin"
Follow the above steps to update the plugin. When updating the plugin, the settings will not be deleted.
When installing the plugin for the first time on a store running PHP 8.x, after activation, you need to go to the Settings tab, select the appropriate Environment, and then save the changes.
Test Configuration
In this section, we describe the abbreviated configuration process needed to test the functioning of integration with InPost Pay. For the initial configuration, go to the administration section of the store and click "InPost Pay" in the menu on the left. Once clicked, a form that allows you to configure the plugin will be displayed. Fill in the fields according to the list below:
Select the environment and display options
a. Set the environment to "Sandbox" - this way you will test the shopping process on a test environment.
b. Set show widget to "Testers" - this way the widget will be visible only to the people who are supposed to see it. Setting another option will display the widget, either operational or non-operational, to all visitors of your store. To display the widget in a web browser, type the address of your store with ?showIzi=true added at the end Example: https://mystore.pl?showIzi=trueFill in the API access credentials you received from InPost in the fields
a. Client ID
b. Client Secret
Fill in the POS ID field according to the value you received from InPost
Fill in the Merchant ID field according to the value received from InPost
Enable payment option
Select the order status that will be assigned to orders paid through InPost Pay and to cash on delivery orders.
Check whether the order status glossary is consistent with what you actually present in your communications to customers. This section is used for stores that have an unusual shopping process. This section will be different in different stores because it represents the statuses in your store.
Enter how many suggested products you want to present in the InPost app. A detailed description of how this mechanism works is described in the Suggested Products section.
Add consents that will be required in your store. You can find a detailed description of each option in the Full Configuration section
Specify which base shipping methods are supported by the shopping process of your store.
Combine shipping by Courier with automated shipping. When you select a shipping method from the drop-down list, the same availability and pricing rules for the selected method will apply to shipping by Courier in the InPost app.
You can skip this part in the basic configuration. It defines the prices of additional shipping options for the Courier option. See the Full Configuration section for a complete description.
Combine shipping by APM with automated shipping. When you select a shipping method from the drop-down list, the same availability and pricing rules for the selected method will apply to shipping by APM in the InPost app.