Configuration

Configuration

Everything here happens in the Sylius back office, under Configuration → Payment methods.

Each payment method you create is one gateway, connected to one Payplug account, serving one set of channels. Create as many as you need — to run several shops or companies, see Multiple channels and accounts.

---

1. Create the payment method

Configuration → Payment methods → Create, then pick the gateway type — Payplug, Oney by Payplug, Bancontact by Payplug, and so on.

Fill in the usual Sylius fields (code, name, channels), set the Payplug options described on Payment methods, and save.

2. Connect your Payplug account

Saving a new Payplug payment method sends you to Payplug to log in. Once you authorize the connection you land back on the payment method, now connected: the plugin has stored the credentials it will use for every call on this gateway.

The credentials belong to this payment method only. Another payment method — even of the same type — has its own connection and can point at a different account.

The account you connected is shown on the payment method's edit screen, under Connected Payplug account. Three states are possible:

The screen reads	It means
The account's email	Connected
No PayPlug account connected yet	The method was saved but never authorized
Re-authenticate to display the connected account	Connected before the plugin started recording the account — reconnect to fill it in

Switching to a different account

Tick Force OAuth reconnection and click Update. This starts the login flow again and replaces the stored credentials.

Disconnecting

Click Disconnect this account under the connected account. It removes the credentials stored for this payment method and disables it. The other payment methods keep their own connection.

3. LIVE or TEST

Every Payplug gateway has a LIVE Mode checkbox:

• unticked — TEST mode. No real money moves. The shop displays a TEST Mode badge.
• ticked — LIVE mode. Real payments.

The credentials for both modes are created when you connect the account, so switching is just this checkbox.

---

When something is misconfigured

After every save, the plugin validates the payment method against your Payplug account — that the features you ticked are actually enabled on it, that required fields are filled. If a check fails, it disables the payment method and explains why in a red banner at the top of the screen:

⚠️ The payment method has been disabled because some validation criteria are not met.

Fix what the banner names, then re-enable the method.

More symptoms and their usual causes are on Troubleshooting.