Seeking guidance on the approved path for a multi-card / split-payment checkout experience

Extensions
1

We are building a specialised payment solution that allows shoppers to split a single high-value purchase across multiple payment cards at checkout (e.g., splitting a £2,000 furniture purchase across two different cards).

We want to ensure we are following the most up-to-date Shopify platform policies, specifically regarding Checkout Extensibility and the Payments Apps Platform.

Our goal is to provide a seamless UI for the shopper to enter multiple card details while ensuring the merchant’s existing PSP (Stripe/Adyen) is used for the actual processing.

My questions are:

  1. For a “split-payment” use case, is the Payments Apps Platform the only approved path, or can this be achieved using Checkout UI Extensions on Shopify Plus?

  2. We’ve seen the note about “Custom Payment Extensions” being limited to eligible Plus merchants. Does this extension type support the collection of multiple card tokens within a single checkout session?

  3. If the Payments Apps Platform is the required path, how does Shopify handle a single order that requires multiple successful authorisations before the order is created?

We want to build this “the Shopify way” and avoid any legacy “off-platform” workarounds. Any guidance from the Shopify team or experienced Plus developers would be greatly appreciated.

2

Hey @Christian_Pankui — thanks for asking before you build this; it’s the right instinct.

A single checkout session collecting and authorising multiple credit cards in parallel isn’t a natively supported pattern on Shopify today, on either the Payments Apps Platform or Checkout UI Extensions. A few specifics:

  • Checkout UI Extensions can render UI and modify some checkout behaviour, but they can’t tokenize cards or trigger separate authorisations — they don’t have access to the payment-method layer.
  • Payments Apps Platform is built around a single paymentSession per order. The app resolves/pends/rejects that one session; it doesn’t model “two cards, one order, both must authorise.” See the Payments Apps API overview.
  • Custom Payment Extensions (Plus-only) let you build a custom payment method UI, but the underlying primitive is still one session = one method. They’re not a split-tender mechanism.

The only first-class split-tender that checkout natively understands today is gift cards + a primary payment method (and, in some markets, store credit). Anything beyond that — including BNPL — works by surfacing as a single payment method to checkout while the provider handles whatever splitting happens behind the scenes.

Patterns I’ve seen people consider, and the tradeoffs

  1. PSP-side splitting. Your merchant’s PSP (Stripe, Adyen) splits the authorisation across two stored payment methods, but Shopify still sees one payment from one method. This keeps you compliant with Shopify’s model, but it means your “two cards” UI has to live somewhere the PSP can manage it — typically not inside Shopify checkout.
  2. Pre-checkout draft / “wallet” pattern. Customer authorises both cards against a holding mechanism off-platform, you generate a single token / store credit equivalent, and that single thing pays for the Shopify order. Compliance here is non-trivial — review with the Plus / Payments partner team before building.
  3. POS multi-tender. Already supported in-store, but not applicable to online checkout.

I would recommend connecting with your Shopify Plus partner manager and the Payments Partnerships team before committing to an architecture. They can tell you whether your specific use case can be unblocked or whether one of the off-platform patterns above would meet policy.