> For the complete documentation index, see [llms.txt](https://docs.sylius.com/public/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sylius.com/public/getting-started/payments.md).

# 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:

| Name             | Code               | 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:

| Provider                                                                  |                                                         |
| ------------------------------------------------------------------------- | ------------------------------------------------------- |
| <img src="/files/Xt15LZhQFr9R3id8JybD" alt="PayPal" data-size="original"> | [Read the docs](https://docs.sylius.com/paypal-plugin/) |
| <img src="/files/xbkRbu19wo2MCmBmErhb" alt="Stripe" data-size="original"> | [Read the docs](https://docs.sylius.com/stripe-plugin/) |
| <img src="/files/t0KaVyDkZAV8LqDuDKXm" alt="Adyen" data-size="original">  | [Read the docs](https://docs.sylius.com/adyen-plugin/)  |
| <img src="/files/Jo9DQ929PTTIzBOgcHK4" alt="Mollie" data-size="original"> | [Read the docs](https://docs.sylius.com/mollie-plugin/) |

{% hint style="info" %}
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.
{% endhint %}

Through these partnerships, payments come with **SLA-backed support handled on the provider's side**, by teams offering professional, dedicated customer service.

{% hint style="success" %}
**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!
{% endhint %}

### Creating a payment method

Whichever gateway you use, a payment method is created the same way in the admin panel:

1. Go to **Configuration → Payment Methods**
2. Click **Create** and select a gateway
3. Set a name (shown to customers at checkout) and a code
4. Assign it to a Channel
5. Enable the method and save

<figure><img src="/files/53NQAGaXVhntYOfryQqK" alt=""><figcaption></figcaption></figure>

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

{% hint style="success" icon="store" %}
Additional payment gateway and logistics integrations are available via [Sylius Addons](https://addons.sylius.com).
{% endhint %}

With payments configured, the next step is setting up how orders are delivered on the [Shipments](/public/getting-started/shipments.md) page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sylius.com/public/getting-started/payments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
