FloPay SDK Changelog

v1.2.8 - Free-trial and $0 checkout support #

FloPay SDK now supports $0 checkouts and free trials end-to-end, routing setup-only client secrets through Stripe's SetupIntent flow so wallets, card forms, and 3DS resume all complete cleanly without a charge.

FloPay SDK v1.2.8 introduces first-class support for free-trial and $0 checkout sessions. When a session has no upfront amount, the SDK now routes through Stripe's SetupIntent APIs end-to-end — across the core adapter, the Express Checkout wallet button, the card form, and the 3DS resume-after-redirect flow — so shoppers can authorize a payment method without a charge and integrators no longer hit the amount must be greater than 0 error from Stripe.

What changed

• $0 and trial-only sessions now use SetupIntents throughout. seti_ client secrets are accepted by the adapter, the Express Checkout wallet button, and the saved-payment 3DS resume path, and confirmed through the corresponding setup APIs instead of payment confirmation.
• Apple Pay and Google Pay sheets render correctly for $0 carts. The wallet button switches to setup mode automatically, so buyers no longer see a misleading placeholder amount on the wallet sheet.
• The split card form omits the placeholder amount and capture method when running in setup mode, keeping the form valid for free-trial sessions.
• Cash App Pay is now hidden automatically when the cart total is below $0.50 USD, preventing a failed selection on amounts the provider cannot accept.
• React ecosystem and tooling have been refreshed: @stripe/react-stripe-js and @stripe/stripe-js move to the latest minor releases, @paypal/paypal-js advances to v10, and React 19.2.7 is now the supported peer version.

Why it matters

• Merchants running free trials, $0 authorization captures, or "card-on-file" onboarding can now use the standard FloPayCheckout, SplitCardForm, and automatic payment button surfaces without custom workarounds.
• Wallet checkouts on $0 sessions no longer display a confusing fallback amount, removing a common source of buyer drop-off on trial offers.
• 3DS challenges that redirect back into the page now resume correctly for setup-only sessions, so saved-payment flows complete cleanly after step-up authentication.

Developer notes

• No public API or request/response shapes change. Existing paid-checkout integrations continue to work without modification.
• To enable free-trial / $0 checkout, create a checkout session whose computed total is 0. The SDK detects the resulting setup-only client secret and selects the correct confirmation path automatically.
• Update your peer dependencies to React 19.2.7 and @stripe/react-stripe-js ^6.6.0 when upgrading. If you pin @paypal/paypal-js directly, move to ^10.0.0 alongside this release.
• Bump all @flopay/* packages together to 1.2.8 (@flopay/js, @flopay/react, @flopay/node, @flopay/shared).