Onboarding with PayPal

To enable PayPal payments in your Sylius store, you need to onboard using a PayPal Business account. This process connects your store to PayPal Commerce Platform and allows for processing payments securely.

By default, the plugin uses sandbox mode for safe testing. You must onboard with a PayPal sandbox account unless you've switched to live mode. Learn more in Configuring Sandbox and Production Modes.

1. Enable PayPal Integration

Navigate to Admin > Payment Methods and either:

• Click Enable PayPal, if a predefined method exists, or

• Create a new payment method with the gateway factory set to PayPal.

2. Confirm PayPal Authorization

You’ll be prompted to accept PayPal consents required for the integration.

If you encounter an error like the one below:

Expected a value identical to "https". Got: "http"

Make sure that:

• Your store is publicly accessible (no localhost, tunnels like ngrok may be required).

• Your site uses HTTPS.

See also the Installation > Usage section.

3. Click "Sign up for PayPal"

You’ll be redirected to PayPal’s onboarding flow.

4. Choose Your PayPal Account

Select the PayPal account you want to connect.

5. Log in with a Business Account

• If you're using a business account, you’ll be prompted to log in.

• If you're using a personal account, PayPal will ask you to upgrade it to business.

6. Authorize Sylius to Access Your PayPal Account

Grant permissions required for the integration.

7. Return to Your Store

After successful authorization, you'll be redirected back to your Sylius Admin Panel.

8. Complete the Payment Method Configuration

Finish the payment method setup. The following credentials should now be automatically filled in:

• Client ID

• Client Secret

Final Check

If the following conditions are met:

• PayPal consents accepted

• Email verified

• Webhooks successfully created

You’re ready to start accepting payments via PayPal Commerce Platform!