Activating Stripe Checkout and Configuring Alternative Payment Methods

What This Article Covers

This article explains how to switch your marketplace to the Stripe-hosted checkout page, how to enable alternative payment methods for your buyers, and how to configure and test everything properly before going live.

Why Switch to Stripe Checkout?

With the legacy embedded payment form, buyers entered their card details directly inside your marketplace, and only card payments were supported.

Stripe Checkout is a hosted payment page managed entirely by Stripe. When a buyer checks out, they are redirected to a secure Stripe-hosted page, complete their payment there, and are then returned to your marketplace.

What changes	Benefit
Payment page hosted by Stripe	More modern, polished experience maintained by Stripe
Support for additional payment methods	Not limited to card-only anymore
PCI compliance on the payment page	Stripe handles it — less responsibility on your side
Payment confirmed via secure webhook	More reliable than relying on browser redirects alone

You can switch at any time, and you can switch back if needed — the legacy embedded form remains available.

Step 1: Activate Stripe Checkout in Your Admin

Go to Admin → Payment service providers → Stripe Connect Custom → Settings
Under Payment workflow, select Stripe Checkout hosted payment page
Save your settings

The Payment workflow selector showing both options — "Embedded payment form (card only)" and "Stripe Checkout hosted payment page" — with the Stripe Checkout option selected

That's all that is required to activate the hosted checkout page. Your buyers will now be redirected to Stripe when they proceed to payment.

Note: The webhook configuration for your marketplace needs to work correctly. Stripe confirms completed payments by sending a webhook event — without it, orders may not finalize. You can check your webhook status at Admin → Payment service providers → Stripe Connect Custom → Manage Webhooks. If the status is not healthy, use the Resync Webhooks button.

Step 2: Enable Alternative Payment Methods (Optional)

When Stripe Checkout is active, you can let buyers pay with additional methods beyond credit and debit cards — such as iDEAL, Klarna, Bancontact, PayPal, and others.

Which methods are available to you depends on your Stripe account configuration, your country, and your marketplace's currency.

Enable the toggle in your admin

In the same Settings page (Stripe Checkout must already be selected as your payment workflow)
Switch Use alternative payment methods configured in Stripe to Yes
A list of the methods currently enabled in your Stripe account appears below the toggle

The alternative payment methods toggle set to "Yes" with the method list loaded below it, showing a few example methods with checkmarks

The list is loaded directly from your Stripe default payment method configuration. Methods that are enabled on the Stripe side and compatible with your setup will appear here.

Enable or disable individual methods in Stripe

The Kreezalid admin reflects what is configured in your Stripe account, but you control which methods are active from the Stripe Dashboard itself.

To enable or disable a payment method:

Log in to your Stripe Dashboard
Go to Settings → Payments → Payment methods, choose the "Default" configuration with the type "Your platform account"
Enable or disable individual methods as needed
Come back to your Kreezalid admin settings and reload the page — the list will update automatically. Do not forget to save your settings after making changes.

The Stripe Payments view showing the "Default" configuration with a list of payment methods.

Note: Some methods may not be available depending on your Stripe account capabilities, your country, or the currencies you support. If a method you expect is not visible, check your Stripe account eligibility in the Stripe Dashboard.

Step 3: Register Your Domain for Certain Payment Methods

Some payment methods require your marketplace domain to be registered in Stripe before they will work correctly. These methods are indicated in the settings page with an asterisk (*****): Apple Pay, Google Pay, and PayPal.

When one of these methods is present in your list, a notice appears below it with your marketplace domain pre-filled for copy-pasting. (See the screenshot of alternative payment methods above.)

How to register your domain

Copy your marketplace domain from the field shown in the notice (for example, https://www.yourmarketplace.com)
In your Stripe Dashboard, go to Settings → Payments → Payment method domains
Click + Add an new domain, paste your domain, and click Add domain and save.

Stripe Dashboard — Payment method domains page showing the domain form

Method	Stripe documentation	Where to configure in Stripe
Apple Pay	docs.stripe.com/payments/apple-pay	Dashboard → Settings → Payment methods → Apple Pay
Google Pay	docs.stripe.com/payments/google-pay	Dashboard → Settings → Payment methods → Google Pay
PayPal	docs.stripe.com/payments/paypal	Dashboard → Settings → Payment methods → PayPal

Important: If the domain is not registered and domain registration is required, the payment method may not appear to buyers even if it is enabled in Stripe.

Before Going Live

If you have not yet tested your Stripe setup with a sandbox account, do so before activating Stripe Checkout for real buyers — and make sure to test the buyer checkout flow before onboarding any real vendors, not after.

→ See Setting Up Stripe Connect for Your Marketplace — Step 3 covers the full sandbox test flow, including the correct order for testing vs. vendor onboarding.

What Buyers Will See

When Stripe Checkout is active, buyers who reach the payment step will be redirected to a Stripe-hosted payment page. After completing their payment, they are returned to your marketplace.

Example Stripe Checkout page showing the payment form with a card field and alternative method buttons visible

Payment method	When available to buyers	Extra configuration needed
Credit and debit cards	Always	None
Apple Pay / Google Pay	If available on the buyer's device and browser	Domain registration (see Step 3)
iDEAL, Klarna, Bancontact, etc.	If enabled in your Stripe account and compatible with the buyer's location and currency	Enable in Stripe Dashboard
PayPal	If enabled in Stripe and buyer's country is supported	Domain registration (see Step 3)

Capture Behavior — What You Should Know

Stripe Checkout uses different capture timing depending on the checkout type:

Checkout scenario	Payment method	When funds are captured
Single order, single seller	Card	At seller acceptance (preauthorization model)
Single order, single seller	Alternative method	Immediately at checkout
Cart with multiple sellers	Any	Immediately at checkout

For single-order card payments, the preauthorization model is preserved: the buyer's card is authorized at checkout, and funds are only captured when the seller accepts the order.

For alternative payment methods and multi-seller carts, funds are captured immediately at checkout. This means:

If a seller declines an order that was already captured, a refund will automatically be issued. In that case, Stripe's processing fees may already have been incurred and cannot be recovered.

This is worth considering if your marketplace uses multi-seller carts frequently and only accepts card payments. In that case, you may want to keep the legacy embedded form active until you are ready to support alternative methods.

Frequently Asked Questions

Can I switch back to the embedded form?

Yes. The setting is reversible. Return to Admin → Payment service providers → Stripe Connect Custom → Settings and select Embedded payment form (card only).

Will my current orders be affected if I switch?

No. The payment workflow setting only applies to new checkout sessions. Orders already placed are not affected.

A payment method is listed but not showing at checkout — why?

Check that the method is active in your Stripe Dashboard and that your domain is registered if required (Apple Pay, Google Pay, PayPal). Also check that the buyer's location and currency are compatible with that method.

I don't see any alternative methods in the list.

Either no additional methods are enabled in your Stripe account, or alternative methods must be enabled first in your Stripe Dashboard under Settings → Payment methods.

Updated on: 06/07/2026

Was this article helpful?

Thank you!