The payment process is key element of any eCommerce store. That’s why it’s so important to offer multiple payment options and the ones that are popular in particular countries to enable customers an easy and comfortable checkout process and enhance the store’s conversion rates.

Considering that, in today’s blog we will take a closer look at Adyen – eCommerce payment solution that integrates with Sylius and provides a seamless, secure checkout process for users around the globe.

Quick Jump

What is Sylius?

In short, Sylius is an open-source, headless eCommerce framework based on PHP Symfony. Its modular architecture makes it flexible and scalable, allowing companies to adapt their eCommerce platforms exactly to their business and market needs and requirements. Unlike monolithic solutions, changes to Sylius can be made quickly, and external systems such as enterprise resource planning (ERP), product information management (PIM), or payment solutions can easily integrate with Sylius via API and communicate using protocols such as REST or GraphQL.

Want to know more about Sylius?

Learn more >>
sylius-logo

What is Adyen?

Founded in 2006, Adyen is a comprehensive payment solution that works as a payment gateway, payment processor, and acquirer in a single platform. It offers a comprehensive payment infrastructure enabling businesses to accept payments globally, manage risk, and track transactions through a unified system. Due to that, online businesses do not have to create separate agreements with payment gateways and payment processors, simplifying the whole process.

Adyen supports multi-channel payments, covering traditional eCommerce websites, mobile app transactions, and in-store Point Of Sale (POS) systems. It connects to over 100 payment methods inside and outside of Europe, including international credit cards like Visa or Mastercard, local cash-based methods such as Boleto in Brazil, mobile payment methods like BLIK in Poland or AliPay in China and digital wallets – Apple Pay and Google Pay. When it comes to security, Adyen complies with PCI DSS (Payment Card Industry Data Security Standard) and adds another layer of protection with 3D Secure authentication.

As can be seen, Adyen is a comprehensive solution that provides numerous payment options for customers worldwide.

Adyen

Adyen integration for Sylius

Both Sylius and Adyen are best for mid-to-upper-tier market companies operating in a best-of-breed environment. Adyen emerges as the perfect choice for an all-in-one payment solution that facilitates international sales, especially since it supports payment methods hardly available in other solutions such as China, Africa, and Oceania. The same goes for supporting many local currencies.  

Adyen’s payment solution can be integrated with Sylius by installing the SyliusAdyenPlugin, created through cooperation between the Sylius Partners – BitBag (by us 😉) and the Adyen team.

Now, let’s quickly go through the process of setting up the integration to ensure it will work in your Sylius configuration: 

Installation

First of all, we work on stable, supported, and up-to-date versions of packages, and we recommend that you do the same.

The full installation guide is available here.  

Customization

You can decorate available services and extend current forms.

Run the below command to see what Symfony services are shared with this plugin:

The plug-in heavily relies on Symfony’s Messenger Component. Messages and their handlers handle all the payment notifications handling actions. Feel free to play with, decorate, or provide middleware to customize the plug-in according to your needs.

All the processing is done using sylius.command_bus. The sylius.event_bus is used to hook up Refund plugin requests and let Adyen know that a refund is requested.

Configuration

The plugin provides a configuration that can be overridden:

More detailed information about these processes, as well as additional guidelines about security, frontend, and testing, can be found in the repository.

The Adyen plugin for Sylius provides a seamless method of incorporating various payment options thanks to the drop-in feature, which allows customers to choose their preferred payment option. This integration currently encompasses all popular payment methods, such as card payments, one-click payments, and digital wallets. The full list of payment methods supported by this integration is the following:

  • Google Pay
  • Apple Pay
  • PayPal
  • Klarna
  • BLIK
  • Polish Online Banking
  • iDEAL
  • Twint
  • WeChat Pay
  • Alipay

The plugin is available for free on our GitHub 

These Sylius-based eCommerce stores have chosen Adyen

Moving on, let’s take a closer look at online stores that benefit from this integration on a daily basis.

Planeta Huerto

Planeta Huerto is one of the largest Spanish online retailers created in 2011. In the span of 10 years, it became a leader in the market in Span and Portugal in selling healthy, eco-friendly, and organic products.

As the store’s customer base grew into hundreds of thousands, it had to be modernized. Along with optimizing the website for mobile devices, creating more room for marketing, and implementing new search engine, the online store also received integrations with new payment solutions – Adyen and Aplazame.

Now, the new Planeta Huerto store offers top-notch performance, excellent customer experience, and multiple payment options that cater to international customers.

Planeta Huerto

Soulz.lt

Soulz, part of the Apranga group, is an exclusive online store offering products from many famous brands. It is synchronized with Apranga’s infrastructure, which includes numerous brick-and-mortar stores and internal processes.

To successfully create an online store, three crucial elements had to be taken care of—omnichannel, mobile-first, and quick online payments. While Sylius and its flexible architecture solved the first two aspects, quick online payments were achieved thanks to integration with Adyen. It allowed to unify both online and in-store payment data and provided a wide range of payment methods for online purchases and custom setup for online Point Of Sale (POS).

Brille24

The third example will be Brille24 store. Founded in 2007, Brille24 became one of the leaders in online opticians industry, offering glasses of many types and brands.

During the replatforming from Magento to Sylius Plus, one of the crucial aspects was integrating a payment solution that could handle payments from multiple channels. Due to that, Adyen was chosen as the custom integration for Brilee24’s store. In addition, Sylius processed more payment information such as saving response time for Adyen to further improve its operations.

Summary

The integration between Adyen and Sylius is a perfect combination that perfectly meets the needs of online businesses from the mid-market and above. The drop-in feature allows for easy and quick addition of payment options, and the available choice of payment methods covers the most popular ones in Europe with some local options like Polish Online Banking, Twint, or iDeal.