Payment Providers
Connect Stripe, Mollie, PayPal, Adyen, or Square to start processing payments through Rheopay.
Payment Providers
Rheopay connects to your existing payment service provider (PSP) account. You bring your own credentials — Rheopay never holds your funds.
Go to Settings → Payment Providers to add or manage provider connections.
You can connect more than one provider. When creating a payment link you can choose which provider handles that specific link.
Stripe
Stripe is the recommended provider for most merchants. It supports cards, wallets, local payment methods, and recurring payments.
What you need
- A Stripe account at stripe.com
- Secret key (
sk_live_...orsk_test_...) - Publishable key (
pk_live_...orpk_test_...) - Webhook signing secret (
whsec_...)
Setup steps
- In your Stripe Dashboard go to Developers → API keys and copy your Secret key and Publishable key.
- In Rheopay go to Settings → Payment Providers → Add Stripe.
- Paste both keys and save.
- Back in Stripe go to Developers → Webhooks → Add endpoint.
- Set the endpoint URL to
https://yourdomain.com/api/stripe/webhook. - Select the events:
checkout.session.completed,account.updated. - Copy the Signing secret and paste it into the Rheopay Stripe configuration.
Never share your Stripe secret key or commit it to source control. Rheopay stores it encrypted.
Features enabled by Stripe
- Card payments (Visa, Mastercard, Amex, and more)
- Apple Pay and Google Pay (where available)
- Local payment methods (iDEAL, Bancontact, SEPA, etc.) depending on your Stripe account
- Recurring / subscription payments
- Automatic refunds from the Rheopay transactions screen
Mollie
Mollie is a European PSP with strong support for local payment methods.
What you need
- A Mollie account at mollie.com
- Client ID (
app_...) - Client secret
Setup steps
- In the Mollie dashboard go to Developers → Your apps and create an OAuth app.
- Copy the Client ID and Client secret.
- In Rheopay go to Settings → Payment Providers → Add Mollie.
- Paste your credentials and save.
- Rheopay will register the webhook endpoint with Mollie automatically (
/api/mollie/webhook).
Features enabled by Mollie
- iDEAL, Bancontact, SOFORT, Klarna, PayPal (via Mollie), and more
- Card payments
- Refunds from the Rheopay transactions screen
PayPal
What you need
- A PayPal Business account at paypal.com
- Client ID and Secret from the PayPal Developer Dashboard
Setup steps
- Log in to developer.paypal.com and go to My Apps & Credentials.
- Create a new app or select an existing one.
- Copy the Client ID and Secret.
- In Rheopay go to Settings → Payment Providers → Add PayPal.
- Paste your credentials and save.
Rheopay uses /api/paypal/return as the return URL after a PayPal payment. This is configured automatically.
Adyen
Adyen is an enterprise-grade PSP used by large merchants and marketplaces.
What you need
- An Adyen merchant account
- API key
- Merchant account name
- HMAC key (for webhook verification)
Setup steps
- In the Adyen Customer Area go to Developers → API credentials.
- Create an API credential and copy the API key.
- Note your Merchant account name (shown at the top of the Customer Area).
- Go to Developers → Webhooks, create a Standard webhook pointing to
https://yourdomain.com/api/adyen/webhook, and copy the HMAC key. - In Rheopay go to Settings → Payment Providers → Add Adyen.
- Enter your API key, merchant account name, and HMAC key, then save.
Square
What you need
- A Square Developer account at developer.squareup.com
- Access token
- Application ID
- Location ID
Setup steps
- In the Square Developer Dashboard create or select an application.
- Go to Credentials and copy your Access token and Application ID.
- Go to Locations and copy the Location ID you want to charge under.
- In Rheopay go to Settings → Payment Providers → Add Square.
- Enter your credentials and save.
- Rheopay registers the Square webhook endpoint automatically (
/api/square/webhook).
Switching providers
You can change which provider a link uses when creating or editing the link. Existing completed transactions are not affected.
Removing a provider
Go to Settings → Payment Providers, open the provider, and click Remove. This does not affect existing transactions but will make any active links using that provider unable to accept new payments until you switch them to another provider.
Related pages
- Payment Links — selecting a provider per link.
- Webhooks & API — outgoing webhooks from Rheopay to your systems.