Skip to main content
The Embedded Flow adds Quidkey’s bank payment option alongside your existing Stripe Payment Element. Customers see both payment methods on your checkout page and choose between card payments (Stripe) or bank transfers (Quidkey), all without leaving your site.
This guide assumes you already have a Stripe Payment Element integrated on your checkout page. You’re adding Quidkey alongside Stripe, not replacing it.

Create a Payment Request

Authenticate and create a payment request to get a payment token

Embed the Checkout

Add the bank selection iframe and wire up Stripe mutual exclusion

After Payment

Handle webhooks, verify signatures, and process fees

API Playground

Test creating a payment request in your browser. No setup required

​
Prerequisites

  • Stripe Payment Element already integrated on your checkout page
  • Quidkey client_id and client_secret (sign up)
  • HTTPS enabled on your checkout page
No Stripe changes required. Your existing Stripe integration stays exactly as it is. You’re adding Quidkey alongside, not replacing anything.

​
When to Use the Embedded Flow

Embedded Flow (with Stripe)Hosted Checkout
Best forMerchants with an existing Stripe checkoutInvoicing, ad-hoc payments, no-code scenarios
Integration effortEmbed iframe, handle postMessage events, route Pay buttonOne API call to create a link, then share the URL
Customer experienceInline checkout on your site (Stripe + Quidkey side by side)Quidkey-hosted checkout page
Frontend codeHTML/JavaScript for iframe + Stripe mutual exclusionNone
Use caseE-commerce with Stripe, subscription platformsB2B invoices, service payments, cross-border pay-ins
Need both? You can use the Embedded Flow for your checkout page and Hosted Checkout for invoice emails. They share the same backend API and webhook infrastructure.

​
How It Works

​
Key Features

  • Works alongside Stripe: customers choose between card (Stripe) or bank transfer (Quidkey) on the same checkout page
  • Mutual exclusion: when a customer selects Quidkey, the Stripe Payment Element collapses, and vice versa
  • Bank prediction: Quidkey automatically predicts and pre-selects the customer’s bank
  • Multiple payment schemes: SEPA, Faster Payments, Multibanco, and more supported automatically
  • Dynamic amounts: update the payment amount after creation (e.g., shipping costs, discounts)
  • Dynamic height: iframe adjusts height automatically based on available payment methods
  • Rewards: optional loyalty rewards displayed to customers during checkout

​
Next Steps

1

Create a payment request

Follow the Create a Payment Request guide to authenticate and get a payment token.
2

Embed the checkout

Learn how to embed the bank selection iframe on your checkout page, including Stripe mutual exclusion.
3

Handle post-payment

Set up webhooks and fee processing to complete your integration.