Migrate from Stripe Elements

This page documents a legacy SDK. The new Yuno SDK (Web v2.x, iOS v3.x, Android v3.x) replaces the Full, Lite, Seamless, Render, Headless, and Secure Fields SDKs with one API across every platform. See the Yuno SDK documentation. Legacy SDKs remain supported side by side during the transition and are scheduled for deprecation in 2027. Contact your Account Manager for migration planning.

If your checkout runs on Stripe Elements today, moving to Yuno changes the checkout layer, not your Stripe account. Yuno connects to Stripe as one provider among the ones you enable, so existing Stripe processing keeps working while you add routing, other providers, and Yuno’s checkout. This page maps each Stripe concept to what you use on Yuno.

Concepts

Stripe	Yuno	Notes
PaymentIntent	Checkout session plus Create Payment	The session carries amount, country, and customer and loads the payment methods enabled on your account. The payment is created on your server with the one-time token the SDK returns.
`client_secret`	`checkout_session`	Created on your server with your private key and passed to the browser. Expires after 2.5 hours in production.
SetupIntent	Enrollment, or a payment with `vault_on_success: true`	A customer session plus `mountEnrollmentLite` stores the card without charging it. `vault_on_success` stores it on the first successful payment. Both return a `vaulted_token`.
PaymentMethod id (`pm_...`)	`vaulted_token`	Charge it later by sending `payment_method.vaulted_token` with stored credentials.
Customer (`cus_...`)	Customer	Create the customer before the session and pass its id.
`capture_method: 'manual'`	`payment_method.detail.card.capture: false`	Then capture or cancel the authorization. See Cancel and Capture Flow.
`payment_method.card.fingerprint`	`fingerprint` on the Payment Method object	Stable per card number within your organization. See Card Fingerprint.
Radar rules and block lists	Risk Conditions	Rules, blocklists, allowlists, and review lists applied on your routes.
Stripe Billing subscriptions	Subscriptions with Smart Retries	If you keep Stripe Billing, see Process Stripe Billing subscriptions with Yuno.
3D Secure via Stripe	3D Secure	Yuno runs 3DS on the routed provider and returns `sdk_action_required` when the shopper must complete a challenge.

Checkout components

Stripe Elements	Yuno Web SDK	Guide
Payment Element	Seamless SDK	Seamless SDK (Web)
Card Element	Lite SDK card component, or Secure Fields when you own the form	Lite SDK (Web), Secure Fields
Split card fields (`cardNumber`, `cardExpiry`, `cardCvc`)	Secure Fields `pan`, `expiration`, `cvv`	Secure Fields
Express Checkout Element	Lite SDK `mountExternalButtons` (Apple Pay, Google Pay, PayPal)	Lite SDK (Web)
`stripe.confirmPayment`	`yuno.startPayment` and your server’s Create Payment call	React and Next.js
`stripe.confirmSetup`	`yuno.mountEnrollmentLite`	Enrollment (Web)
`elements.update({ amount })`	`yuno.updateCheckoutSession(newSession)`	Web Reference
`@stripe/react-stripe-js`	`@yuno-payments/sdk-web` with the patterns on the React page	React and Next.js
Appearance API	Checkout Builder and SDK styling	Checkout Builder, Styling

Payment flow, side by side

Stripe Elements
Yuno (Lite SDK / Secure Fields)
Yuno (Seamless SDK)

Server creates a PaymentIntent and returns client_secret.
Browser mounts the Payment Element with the secret.
Browser calls stripe.confirmPayment.
Stripe redirects or resolves; your server listens to payment_intent.succeeded.

Server creates a checkout session and returns checkout_session.
Browser mounts the SDK with the session and calls yuno.startPayment().
The SDK gives you a one-time token in createPayment; your server calls Create Payment with payment_method.token and checkout.session.
If the response has checkout.sdk_action_required: true, the browser calls yuno.continuePayment() for 3DS or a redirect. Your server listens to the payment.purchase webhook for the final status.

Server creates a checkout session and returns checkout_session.
Browser mounts the Seamless SDK with the session and calls yuno.startPayment().
The SDK creates the payment from the checkout session on your account. Your server listens to the payment.purchase webhook for the final status.
For 3DS or a redirect, the SDK handles the challenge automatically and returns the result in paymentResult.

One structural difference across both paths: your private key never goes to the browser. The checkout session is created on your server, and for Lite SDK and Secure Fields the payment is also created there.

Webhooks

Yuno sends one event type per object and carries the status inside the payload, so several Stripe events collapse into one Yuno event. See Webhooks and Configure Webhooks.

Stripe event	Yuno event	Read
`payment_intent.succeeded`, `payment_intent.payment_failed`, `payment_intent.canceled`	`payment.purchase`	`status` (`SUCCEEDED`, `DECLINED`, `PENDING`, `ERROR`) and `sub_status`
`charge.captured`	`payment.capture`	Transaction status
`charge.refunded`	`payment.refund`	Refund transaction status
`charge.dispute.created`, `charge.dispute.updated`, `charge.dispute.closed`	`payment.chargeback`	`status` (`IN_DISPUTE`, `CHARGEBACK`, `SUCCEEDED`) and `sub_status` (`RECEIVED`, `PENDING_REVIEW`, `LOST`, `APPROVED`). See Chargeback management.
`setup_intent.succeeded`	`enrollment.enroll`	`status` `ENROLLED` and the `vaulted_token`
`customer.subscription.*`, `invoice.paid`, `invoice.payment_failed`	`subscription.*` (`active`, `past_due`, `cycle_executed`, `cancel`, and others)	Subscription status and cycle result
`review.opened`, `review.closed`	`payment.fraud_screening`	Screening result

Every Yuno webhook carries data.idempotency_key and an x-hmac-signature header; verify it as described in Verify webhook signatures.

Saved cards

Cards saved in Stripe can be brought into Yuno so returning customers do not re-enter them. Yuno supports a provider-to-provider token migration, PGP-encrypted, through the Token Migration Process. Recurring series continue without a new authentication because Yuno stores the network transaction id with each vaulted token; see Stored Credentials.

Migration order

Connect Stripe on Yuno

Add your Stripe account as a connection and put it on a route. Nothing changes for shoppers yet. See Set up a payment connection.

Replace the checkout

Swap the Payment Element for the Seamless SDK, or the Card Element for Lite SDK or Secure Fields, following React and Next.js. Run it on the same Stripe connection first so you can compare approval rates like for like.

Move webhooks

Subscribe your existing handlers to the Yuno events in the table above and switch the status logic to Yuno’s status and sub_status values.

Migrate saved cards

Run the token migration and switch stored-card charges to vaulted_token.

Add providers and routing

Once traffic is stable, add other providers and let Routing and Monitors decide where each payment goes.

Overview

Seamless SDK

Lite SDK

Headless SDK

Card Enrollment

Additional Features

Resources

Additional Platforms

Web Frameworks

External Native Modules

Concepts

Checkout components

Payment flow, side by side

Webhooks

Saved cards

Migration order

​Concepts

​Checkout components

​Payment flow, side by side

​Webhooks

​Saved cards

​Migration order

Concepts

Checkout components

Payment flow, side by side

Webhooks

Saved cards

Migration order