At Commerce Weavers, we specialize in building custom e-commerce solutions. Recently, we were faced with a challenging yet rewarding task: integrating Sylius, a highly flexible open-source e-commerce framework, with Tpay, a popular Polish payment gateway. 

This integration wasn't just about making the payment system work. It was about architectural scalability, and building a long-term partnership to ensure that the solution would efficiently serve our client's needs now and in the future. In this case study, we'll take you through how we approached the project, the challenges we faced, and why the outcome was a resounding success.

Tpay approached us with the request to integrate their payment system with Sylius. As the payment gateways market challenger in Poland, Tpay wanted to expand its support for businesses using our beloved technology, given its growing popularity among e-commerce merchants. 

Needless to say, Commerce Weavers hires top Sylius experts. What’s more, we had used Tpay before for the new PHPers conference website, and chose it as a default Elliot's payment service provider. This made us confident in calculating precise delivery time estimation, so we could agree on a convenient fixed-price deal. In short, we made it easy for Tpay to choose us as their official integrator ;).

Working with the entire Commerce Weavers team was a pure pleasure and a dream come true for every Product Manager. They perfectly combined their business and technological experience, making them not only a partner for us but also a huge support throughout the project. I could always count on their commitment and professionalism, which translated into the final, great product - the official Tpay plugin for Sylius.
~Klaudia Krajewska, Product Manager at Tpay

Our Sylius integration with Tpay features strong support for all payment methods popular in Poland:

• Mobile payments:

  • BLIK - the #1 in Poland - used for 50% of all e-commerce payments in our country. We’ve integrated crucial functionalities for convenience:

    • level 0, which means the user doesn’t need to leave the checkout to provide the transaction code displayed in the mobile app;

    • storing users' aliases;

  • Visa mobile;

  • PeoPay (via Pay-By-Link);

• Digital wallets:

  • Apple Pay;

  • Google Pay;

• Credit cards (Visa & Mastercard) with data storage on the merchant side;

• Pay-By-Link which unblocks more methods:

  • local bank transfers - Millenium, Pekao, Pocztowy, Santander, Citi Handlowy, Alior, Velo, Plus, mBank, inteligo, PKO, Nowy, SGB, BPS; 

  • international banks - BNP Parbias, Credit Agricole, ING;

  • BNPL (buy now, pay later) - PayPo, Twisto, BLIK Pay Later;

  • Installments with Pekao;

  • SEPA for international payments in Euro.

You can test all the functionalities yourself at our demo. Make sure to check both the shop and admin side!

What’s very unique about this integration in the Sylius ecosystem, is its full headless support. Every feature has its API endpoint which makes it easy to connect to any 3rd party app and separate frontend. We must also admit that Tpay's API has been particularly convenient to work with, which is not standard feedback from our demanding developers!

As always, we also took care of DX, including:

• Working API reference with ready examples for specific gateways;

• SyliusRecepies to facilitate installation;

• Very high coverage of single-store and functional tests (with Mockoon);

• Tests regularly checking whether Tpay contracts have not changed.

Security measures

Every Payment Service Provider needs to follow very strict security measures. It’s no different with Tpay. The company strongly commits to user safety (read more here). Our job was not to break what they had already done at the top level. ;)

That being said, the payment data does not touch the Sylius site. Additionally, we use data encryption, which is stored in the database. Authorization of notifications from Tpay is verified by checksum, JWS token with X.509 public key certificate from Tpay.

The collaboration with Tpay has turned into a very fruitful partnership. We’ve already had the pleasure of recording a VODcast together (launching this Thursday!) and are planning to co-organize an e-commerce meetup featuring Sylius in their HQ in Poznań in Q1 2025. 

A few of our clients have already expressed interest in this brand-new integration, and we’re hoping for a bigger adoption of Tpay in Poland. Actually, one of the big Polish tech players is already implementing our solution. ;)

Tech-wise, we’re aiming to provide support for Sylius 2.0 as one of the first plugins on the market. Anyway, both our business and developer teams have found a common language very quickly, and I’m sure many web agencies and merchants will do as well. Tpay’s ease of integration, low transaction fees, and solid PCI compliance make it a compelling choice for businesses targeting the Polish market.

If you don’t believe me, simply check the following:

• read Tpay's blog post about the integration;

• configure it according to the official guide.

Let us know in case you stumble upon any flaws or problems! Your feedback and active usage of the solution are key to making it even more successful!

Want us to implement seamless payments in your online store? Contact us!