Payments
To accept orders, your store needs at least one payment method. This page explains how payments work in Sylius, what you get out of the box, and how to connect a payment provider.
A payment method defines how customers can pay. Sylius separates two concepts here:
Payment gateway — the integration with an external payment provider (PayPal, Mollie, Stripe, Adyen, etc.). Gateways are provided by plugins.
Payment method — the configuration layer on top of a gateway. One gateway can power multiple payment methods (e.g. a "Credit Card" method and a "Pay Later" method, both using the same gateway).
The built-in Offline gateway
Sylius ships with one built-in gateway: Offline. It's useful for orders that are paid manually — bank transfer, cash on delivery, invoiced B2B orders — and needs no external account.
Configured by default in Sylius-Standard
A fresh Sylius-Standard install already comes with two ready-to-use payment methods, both based on the Offline gateway:
Cash on delivery
cash_on_delivery
Offline
Bank transfer
bank_transfer
Offline
These come from the example data (fixtures) and are there to get you started — rename them, reconfigure them, or remove them to match your store.
Payments, taken care of
For online card and wallet payments, Sylius partners with leading payment service providers (PSPs). Their plugins come pre-installed in Sylius-Standard, so you don't build an integration from scratch — going live is a matter of onboarding, not development.
To start accepting payments with a provider, complete the onboarding flow inside its payment method to connect your store to your provider account (for example, your PayPal business account). Each provider's documentation walks you through it step by step:
On a Sylius-Standard release older than 2.2? Some of these plugins may not be bundled yet — we still recommend installing them to accept online payments. Each plugin's documentation covers installation.
Through these partnerships, payments come with SLA-backed support handled on the provider's side, by teams offering professional, dedicated customer service.
Using These Integrations? You're Supporting Open Source 🫶
Every project using an officially supported payment integration contributes directly to the development of the Sylius Community Edition.
Sylius reinvests 100% of the revenue from affiliate and revenue-share partnerships with Payment Service Providers into the growth of its open-source platform.
Thank you for helping us build a better Sylius for everyone!
Creating a payment method
Whichever gateway you use, a payment method is created the same way in the admin panel:
Go to Configuration → Payment Methods
Click Create and select a gateway
Set a name (shown to customers at checkout) and a code
Assign it to a Channel
Enable the method and save
For the preferred PSPs above, installing the plugin makes its gateway available here — create a payment method with that gateway, then follow the provider onboarding in the plugin's documentation to connect it to your account.
What's next
Additional payment gateway and logistics integrations are available via Sylius Addons.
With payments configured, the next step is setting up how orders are delivered on the Shipments page.
Last updated
Was this helpful?