# inpost/magento2-module-inpost-pay

> Module integrates InPost Pay Mobile application with Magento store.

`composer require inpost/magento2-module-inpost-pay`

Canonical URL: https://packagento.com/inpost/magento2-module-inpost-pay

## At a glance

- **Vendor**: inpost (https://packagento.com/inpost.md)
- **Latest version**: v2.7.1 — released 2026-07-16
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/inpost/magento2-module-inpost-pay and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require inpost/magento2-module-inpost-pay:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Module integrates InPost Pay Mobile application with Magento store.

## README

Module integrates InPost Pay Mobile application with Magento store.

### Compatibility

Compatibility and dependency requirements are defined in [`composer.json`](composer.json).

### Installation

```bash
composer require inpost/magento2-module-inpost-pay
bin/magento module:enable InPost_InPostPay
bin/magento setup:upgrade
```

### License

This plugin is licensed under the Creative Commons BY-NC-ND 4.0 License.

You are free to use this plugin in its original, unmodified form for non-commercial purposes only.
Redistribution, modification, and commercial use are strictly prohibited.

License details: http://creativecommons.org/licenses/by-nc-nd/4.0/

## Changelog

All notable changes to this project will be documented in this file.

### [2.7.1] - 2026-06-16

#### Fixed
- Unified Widget JS scripts analytics data sources for checkout and rest of places. Before that Checkout searched for analytics data in local storage and other widget JSs searched for cookies.

### [2.7.0] - 2026-05-29

#### Added
- Added InPost Pay Module version header to all defined WebAPI endpoints responses. Before there was only header added to sent requests.

#### Fixed
- Fixed security and performance issues related to: DB query parameter binding, PHTML escaping, timeout handling, signature comparison, form_key validation and early returns in native observers
- Fixed displaying all options to Bundle Products in InPost Pay Order preview
- Fixed calculating total discount on order preview
- Fixed logs by silencing 404 critical error on failed basket binding when that is expected

### [2.6.4] - 2026-04-14

#### Fixed
- Fixed displaying Bundle Products options in InPost Pay Basket when Bundle has multiple checkbox options in a single section. Before only the first option was displayed.

### [2.6.2] - 2026-03-24

#### Fixed
- Fixed cross-sell products prices. In Mobile App cross-sell products will no longer display the regular price but the final price.

### [2.6.1] - 2026-03-05

#### Fixed
- Fixed getBasket request handling by adding forced collectTotals. That fixes the issue with cart price rule not being correctly calculated when the rule is enabled or disabled and the cart has not been changed.

### [2.6.0] - 2026-02-19

#### Added
- Support for PHP 8.4
- Handling of new analytics parameter ttclid
- Change in analytics parameters source from browser storage to cookies

#### Fixed
- Fixed the handling of native Magento customer address configuration that limits street lines between 1 and 4 lines


### [2.5.0] - 2026-01-29

#### Added
- Modified handling of creditmemo refunds. From now on, if InPost Pay API returns an error on refund creation, depending on the error code, order transaction will be checked after a short delay in case of that refund was successfully created while API timed out.
- Creditmemo refunds will be created even in case of handled error codes from the API however, the status of that creditmemo will be opened.
- Added a webapi endpoint for handling refund confirmation webhook. If the confirmation is received, the creditmemo changes status based on external API status, either refunded or canceled.

### [2.4.2] - 2025-12-16

#### Fixed
- Fixed issue with stock validation for configurable products
- Fixed issue with not displayed widget on modified checkout thank-you page with no minicart loaded
- changed flag is_offline=1 in general payment configuration to is_offline=0

### [2.4.1] - 2025-11-26

#### Fixed
- Resolved an issue where previous order emails could be added to subsequent orders in mass processing scenarios by clearing registry state.

### [2.4.0] - 2025-11-04

#### Added

- Added support for Hyva Theme and Hyva Checkout (requires installation of InPost Pay Hyva module)
- Added new configuration for InPost Pay timed-out orders error handling
- Changed configuration for widget styles

### [2.3.1] - 2025-10-22

#### Added

- Added Owebia Advanced Shipping support by adding a configuration field for mapping custom shipping method code not present in a dropdown list.

### [2.3.0] - 2025-10-01

#### Added

- Added support for downloadable and virtual products
- Added new configuration for InPost Pay Terms and Conditions (legacy configuration is still default)
- Added Magento Coupon condition that only works if an order is placed via InPost Pay Mobile App
- Added support for free orders, for example, a voucher that covers all order costs (requires InPost Mobile App upgrade)

_(Changelog truncated for .md surface. Full history on https://packagento.com/inpost/magento2-module-inpost-pay.)_

## Recent Versions

| Version | Released |
|---|---|
| v2.7.1 | 2026-07-16 |
| v2.7.0 | 2026-06-05 |
| 2.4.2 | 2026-03-24 |
| v2.6.2 | 2026-03-24 |
| v2.6.1 | 2026-03-05 |
| v2.6.0 | 2026-02-19 |
| 2.5.0 | 2026-01-29 |
| 2.4.1 | 2025-11-26 |
| 2.4.0 | 2025-11-04 |
| 2.3.1 | 2025-10-22 |

Showing 10 of 15 versions. Full release history on https://packagento.com/inpost/magento2-module-inpost-pay.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| guzzlehttp/guzzle | * |
| inpost/magento2-module-restrictions | >=2.3.0 |
| laminas/laminas-http | * |
| monolog/monolog | * |
| php | >=8.1 |
| psr/log | * |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["inpost/magento2-module-inpost-pay"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

inpost is a Magento 2 vendor on Packagento. See https://packagento.com/inpost.md for their full catalogue.