Shipping & Payment
Before customers can complete a purchase, your store needs at least one shipping method and one payment method. This page explains how both work in Sylius and how to configure them.
Shipping methods
A shipping method in Sylius defines how an order can be delivered — and under what conditions it's available. Availability is controlled by two factors:
Zone — a shipping method is available only to customers whose shipping address falls within the method's assigned Zone. A method for "European Union" won't appear at checkout for a customer shipping to the US. This is why Zones were configured first.
Shipping Category — optionally, a method can be restricted to products belonging to a specific Shipping Category. Useful when certain products (e.g. oversized items, hazardous goods) require a dedicated carrier.
Each shipping method also has a calculator that determines the cost. The simplest calculator charges a flat rate per order. More advanced calculators can price per item, per unit weight, or per volume.
To create a shipping method:
Go to Configuration → Shipping Methods
Click Create
Set a name (shown to customers at checkout) and a code (internal identifier)
Assign a Zone — the regions where this method is available
Choose a calculator and set the rate
Enable the method and save
You need at least one enabled shipping method before customers can complete checkout. If your store only ships to one region, one flat-rate method is enough to get started.
Payment methods
A payment method defines how customers can pay. Sylius separates two concepts here:
Payment gateway — the integration with an external payment provider (Stripe, PayPal, Mollie, etc.). Gateways are added via 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 Stripe 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. For card payments and other online gateways, install the relevant plugin first.
To create a payment method:
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
What's next
Additional payment gateway and logistics integrations are available via Sylius Addons.
With a shipping method and payment method in place, your store is ready to accept orders. The next step is creating your first product.
Last updated
Was this helpful?