README

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

• 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

Please verify your environment meets the following criteria:

Installation & Setup

Follow these steps to integrate Tpay into your OroCommerce instance:

1. Install via Composer

Execute the following command in your project root:

composer req macopedia/orotpay

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

1. Parameters: If necessary, customize the default parameters found in:
   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 > Integrations > 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 > 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

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

1. Polish
2. English

License

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

About extension

This extension is a joint initiative developed by Macopedia in official partnership with Tpay.

About Tpay

Tpay is one of Poland’s leading online payment operators, providing secure and convenient payment solutions for thousands of e-commerce businesses.

About Macopedia

Macopedia 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 and PIM Academy, supporting the growth of the digital commerce community.

Contact us