Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payreque.st/llms.txt

Use this file to discover all available pages before exploring further.

​
Connecting Stripe

Stripe gives PayRequest payment links a worldwide reach. Customers can pay with cards, Apple Pay, Google Pay, Klarna, Afterpay, iDEAL, Bancontact, and many more — and Adaptive Pricing automatically shows them the price in their own local currency.
Phase 1 scope: Stripe currently powers payment links only. Invoices, subscriptions, and customer billing continue to use Mollie. We’re rolling out wider Stripe support over the coming releases.

​
Why Add Stripe

Global checkout

Cards in 200+ countries, plus regional methods that drop in automatically based on the buyer’s location.

Adaptive Pricing

A buyer in Canada sees CAD, a buyer in Japan sees JPY — without you doing the FX math. The conversion fee is paid by the buyer, not you.

Apple & Google Pay

One-tap mobile checkout that consistently lifts conversion. Enabled out of the box on supported devices.

Buy Now, Pay Later

Klarna and Afterpay surface for orders above the regional threshold, helping convert higher-ticket sales.

​
How to Connect

1

Open Provider Settings

Go to /provider-settings and find the Stripe card.
2

Click Connect

You’ll be sent to Stripe’s secure onboarding page. Sign in to your Stripe account, or create one if you don’t have it yet.
3

Approve the connection

Stripe asks for permission to charge on your behalf. Approve, and you’re returned to PayRequest with the connection live.
4

Confirm in PayRequest

The Stripe card now shows a green Connected banner with your account name and email.
First time using Stripe? The onboarding wizard guides you through identity verification, bank details, and payout settings — required by Stripe before you can take live payments.

​
What Customers See

When a customer opens a payment link, the Stripe checkout shows up as an embedded form on your payment page — no redirect to a separate site. They pick their preferred method, fill in card or bank details, and confirm. Cards are charged instantly; methods like iDEAL or Bancontact bounce briefly through the buyer’s bank for authorization.

Branded experience

The payment form uses a dark theme that matches PayRequest’s checkout chrome. Buyers stay on your payment page from start to finish.

Smart method labels

The pay button updates as the buyer picks a method — “Pay with iDEAL”, “Pay with Apple Pay”, and so on — so they always know what they’re confirming.

​
Adaptive Pricing

Adaptive Pricing is what makes Stripe especially valuable for international payment links. Stripe detects each buyer’s country and shows the price converted to their local currency, with the exchange rate locked in for 24 hours.
You don’t pay anything extra. Stripe takes a 2–4% conversion fee, and that fee is added to the buyer’s price — not yours. You receive the original amount in your account’s settlement currency.

​
How It Works for Buyers

  1. Buyer opens a €25 payment link from Toronto
  2. Stripe detects their location and converts the price (e.g., to CAD 36.50)
  3. The Currency Selector lets them switch back to your default currency if they prefer
  4. They pay in their own currency through whichever method they choose
  5. You receive €25 in your Stripe account — Stripe handles the conversion

​
Managing Adaptive Pricing

Adaptive Pricing is enabled by default when you connect Stripe. To turn it off for your account:
1

Open Provider Settings

Visit /provider-settings and find your connected Stripe card.
2

Toggle Adaptive Pricing

In the Stripe section there’s a panel labelled Adaptive Pricing with a switch. Flip it off if you want all buyers to see your account currency only.
Most merchants leave Adaptive Pricing on — it’s a free conversion lift for international buyers. The only common reason to disable it is if you have legal or pricing constraints that require a single currency display.

​
Refunds and Disputes

Open the transaction in your dashboard and click Refund. You can issue a full refund or a partial amount. Stripe handles the conversion if the original payment was in a different currency — the buyer gets back the exact amount they paid.
If a buyer disputes a charge with their bank, Stripe notifies PayRequest via webhook and the dispute is logged on the transaction. Use the Stripe Dashboard to upload evidence; the Handling Chargebacks guide covers the workflow.
Supported. Issue any amount up to the full charge value. Multiple partial refunds on a single transaction are allowed until the total reaches the original amount.

​
Disconnecting Stripe

You can disconnect Stripe at any time from Provider Settings. Existing transactions stay accessible in your dashboard, and refunds on past transactions continue to work. Only new payments are blocked while Stripe is disconnected.
If you have payment links or QR codes that route to Stripe specifically, disconnecting will fall back to your other connected providers. If Stripe is your only provider, your payment links will be unavailable until you reconnect.

​
Frequently Asked Questions

Stripe’s standard processing fees apply — typically 2.9% + €0.25 for European cards, varying by region and method. Adaptive Pricing’s 2–4% currency conversion fee is paid by the buyer, not you. PayRequest itself only charges its own platform fee on free-plan accounts (2% per transaction); paid plans pay nothing on top.
Yes. Stripe requires identity verification (KYC) for any merchant taking live payments. The onboarding form asks for business details, owner identification, and payout bank details. Most merchants finish in under 10 minutes.
Stripe lets you settle in your account’s primary currency (typically EUR, USD, GBP, CHF, or your local currency). Adaptive Pricing then handles displaying prices to buyers in any of 150+ presentment currencies.
Yes, but make sure your custom domain is allowed to load Stripe’s scripts. PayRequest’s standard payment domain (payrequest.me) is configured out of the box.
Yes. Connect Stripe alongside Mollie or PayPal, test with a small payment, then update your payment links once you’re happy. You don’t have to disconnect anything during the transition.

​
Next Steps

Payment Methods Overview

See every payment method available through Stripe and other providers.

Connect PayPal

Add PayPal, Pay Later, and Venmo alongside Stripe for broader buyer reach.

Create a Payment Link

Build the shareable link or QR code your customers will pay through.

Handle Chargebacks

Learn how to respond to disputes from Stripe and other providers.