PHPackages                             macopedia/orotpay - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. macopedia/orotpay

ActiveSymfony-bundle[Payment Processing](/categories/payments)

macopedia/orotpay
=================

Official Tpay integration for OroCommerce 6.x

v1.0.3(3mo ago)123[1 PRs](https://github.com/macopedia/orotpay/pulls)MITPHPPHP ~8.4

Since Jan 26Pushed 2mo agoCompare

[ Source](https://github.com/macopedia/orotpay)[ Packagist](https://packagist.org/packages/macopedia/orotpay)[ RSS](/packages/macopedia-orotpay/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (4)Dependencies (2)Versions (5)Used By (0)

Tpay &amp; OroCommerce payment gateway integration
==================================================

[](#tpay--orocommerce-payment-gateway-integration)

[![Tpay trusted payments](./.github/tpay.svg)](./.github/tpay.svg) [![OroCommerce](https://camo.githubusercontent.com/25945fd2124e59879e88a9610ea785f1668499408e2f951a5ed5598004382bc5/68747470733a2f2f6f726f696e632e636f6d2f77702d636f6e74656e742f7468656d65732f6f726f696e632f696d616765732f726564657369676e2f4f726f436f6d6d657263652d4c6f676f2e7376673f783634323438)](https://camo.githubusercontent.com/25945fd2124e59879e88a9610ea785f1668499408e2f951a5ed5598004382bc5/68747470733a2f2f6f726f696e632e636f6d2f77702d636f6e74656e742f7468656d65732f6f726f696e632f696d616765732f726564657369676e2f4f726f436f6d6d657263652d4c6f676f2e7376673f783634323438)

The **OroTpay bundle** is a free and official Tpay extension for OroCommerce that enables seamless payment processing for your OroCommerce application. Bundle provides a secure, frictionless checkout experience by integrating one of Poland’s leading payment gateways directly into your store.

Key features
------------

[](#key-features)

- **Native checkout experience:** Support for BLIK, VISA Mobile, Credit Cards, Online Transfers (PBL), and PragmaPay directly on your store.
- **Digital wallets:** Ability to configure Apple Pay and Google Pay on store checkout
- **Classic gateway support:** "classic" payment method of redirect to the Tpay payment gateway.
- **Flexible payment logic:** Support for payment retries, transactions statuses and logs to troubleshoot potential payment problems, possibility for full refunds directly from the OroCommerce admin panel (v1.0 supports full refunds only)
- **Testing environment:** You can use it with Tpay Sandbox mode for safe development and staging.

Technical requirements
----------------------

[](#technical-requirements)

Please verify your environment meets the following criteria:

ComponentRequirement**OroCommerce**Version 6.x**PHP Version**&gt;= PHP 8.4**Tpay Account**Active production or Tpay sandbox account (testing only)**Apple/Goole MerchantID**To offer digital wallets (Apple Pay/Google Pay) to your customers, ensure your Merchant ID is correctly configured in the integration settings. Note on Apple Pay: to enable Apple Pay, you must verify your store domain within the Tpay Merchant Panel. This involves uploading a verification file provided by AppleInstallation &amp; Setup
========================

[](#installation--setup)

Follow these steps to integrate Tpay into your OroCommerce instance:

### 1. Install via Composer

[](#1-install-via-composer)

Execute the following command in your project root:

```
composer req macopedia/orotpay

```

### 2. Run database migrations &amp; load translations

[](#2-run-database-migrations--load-translations)

- Clear the application cache

```
php bin/console cache:clear

```

- Execute migrations

```
php bin/console oro:platform:update --force

```

- Clear the application cache

```
php bin/console cache:clear

```

### 3. Configuration

[](#3-configuration)

1. **Parameters:** If necessary, customize the default parameters found in:
    [Resources/config/parameters.yml](./Resources/config/parameters.yml)
2. **Deployment:** Deploy the changes to your OroCommerce instance (**remember: run migrations on first deployment!**)
3. **Go to ORO admin panel:**
    - Navigate to the OroCommerce admin panel.
    - Go to **System &gt; Integrations &gt; Manage Integrations**.
    - Create a new integration, select **Tpay**, provide your API credentials and select production or sandbox mode
    - Configure your desired payment methods within **System &gt; Payment Rules**.
4. Note: By default, the extension sends the client IP address to the gateway for processing in prod environments; in dev mode, this is disabled. Since the gateway validates IP addresses, ensure your server is properly configured to forward user IPs to the Oro application to avoid processing errors. For local development, please use OroCommerce in dev mode.

### 4. Documentation

[](#4-documentation)

Documentation for the extension is available on Tpay's website in:

1. [Polish](https://docs-api.tpay.com/pl/orocommerce/)
2. [English](https://docs-api.tpay.com/en/orocommerce/)

License
-------

[](#license)

This plugin's source code is completely free and released under the terms of the MIT license.

About extension
---------------

[](#about-extension)

This extension is a joint initiative developed by [Macopedia](https://macopedia.com/) in official partnership with [Tpay](https://tpay.com).

### About Tpay

[](#about-tpay)

[Tpay](https://tpay.com) is one of Poland’s leading online payment operators, providing secure and convenient payment solutions for thousands of e-commerce businesses.

### About Macopedia

[](#about-macopedia)

[Macopedia](https://macopedia.com/) is a software development house and digital commerce partner with strong expertise in PIM and e-commerce, supporting B2B and B2C companies worldwide. Since 2006, we’ve been helping manufacturers, importers, and distributors scale their digital sales by bridging business needs with robust, modern technology.

We specialize in building and maintaining solutions based on proven platforms such as OroCommerce, Adobe Commerce (Magento), Shopware, Akeneo, Pimcore, and Odoo, as well as custom integrations across complex system landscapes. Our teams deliver end-to-end solutions, from architecture and development to integrations with ERP, CRM, and payment systems. We build scalable, headless, and traditional web applications using TYPO3 and modern frameworks.

Beyond project delivery, we actively share knowledge and educate the market through initiatives like the [B2B MasterClass podcast](https://www.youtube.com/watch?v=bKcTa6id7Xs&list=PLPCr2EIkIgImMjKrm1bAI6UY0KWiG8r8y) and [PIM Academy](https://www.youtube.com/watch?v=6pbpuklMXyI&list=PLPCr2EIkIgIkJxKQtUrwbFpTS1R6Q9Pzs), supporting the growth of the digital commerce community.

[Contact us](https://macopedia.com/contact)
-------------------------------------------

[](#contact-us)

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance84

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~45 days

Total

2

Last Release

102d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e44feab70b3b53b27178be962a8b5474af354f85292f2a662f015f022fdd3c11?d=identicon)[tmotyl](/maintainers/tmotyl)

---

Top Contributors

[![twoldanski](https://avatars.githubusercontent.com/u/66474451?v=4)](https://github.com/twoldanski "twoldanski (7 commits)")

### Embed Badge

![Health badge](/badges/macopedia-orotpay/health.svg)

```
[![Health](https://phpackages.com/badges/macopedia-orotpay/health.svg)](https://phpackages.com/packages/macopedia-orotpay)
```

###  Alternatives

[oro/commerce-crm-application

OroCommerce - an open-source Business to Business Commerce application.\\This package contains a sample application.

35110.3k](/packages/oro-commerce-crm-application)[oro/customer-portal

1450.5k4](/packages/oro-customer-portal)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
