Skip to content
Gaurav TiwariDocs

Stripe Managed Payments

Updated November 19, 2026

You sell software, courses or downloads, and every buyer in another country brings a sales tax or VAT rule you’re meant to register for, charge and file. Taking cards with Stripe doesn’t change that. Your business is still the seller on every one of those sales.

Stripe Managed Payments makes Stripe the merchant of record. Stripe works out sales tax and VAT, collects and remits it, handles fraud and disputes, and bills subscriptions on Stripe Billing. Buyers pay in Stripe Checkout, embedded on a page of your own store, and Stackless keeps FluentCart orders, renewals, refunds and cancellations in step through the webhook Stripe (Stackless) already uses.

When to Use It

Use it for digital products when you’d rather Stripe carry the tax work. Keep Stripe (Stackless) for everything else. Both can be on at once: Managed Payments hides itself for carts it can’t take, and buyers pick Stripe (Stackless) instead.

Stripe (Stackless)Stripe Managed Payments
Seller of recordYour businessStripe
Sales tax and VATYou, with FluentCart taxStripe calculates, collects and remits it
What you can sellAnything Stripe allowsDigital products only
Where buyers payPayment form on your checkoutStripe Checkout on a pay page of your store
Subscription renewalsStackless charges the saved cardStripe Billing charges and retries
DisputesYou respond in StripeStripe handles them

Turn On Managed Payments at Stripe

Stripe has to approve your account first. In the Stripe Dashboard, open Settings → Managed Payments and activate it. Stripe reviews each account before it can take payments this way, and only direct Stripe accounts in the countries Stripe supports qualify.

If you sell subscriptions, also save your customer portal settings under Settings → Billing → Customer portal in Stripe. Customers update their card there.

Turn On the Gateway

  1. Set up Stripe (Stackless) first: its API keys and webhook. Managed Payments uses the same keys, the same webhook and the same test mode, so there are no separate keys to enter.
  2. Go to FluentCart → Stackless, switch on Payment Gateways, open its Settings and tick Stripe Managed Payments under Gateways to add to FluentCart. Save.
  3. Open FluentCart → Settings → Payments and choose Manage on Stripe Managed Payments (Stackless).
  4. Turn on Payment Activation, pick the Stripe tax code and Prices and tax (next section), and save.

Saving checks that Stripe (Stackless) has API keys for the store’s current mode. If it doesn’t, you’ll see Connect Stripe (Stackless) with test API keys first (or live), and nothing is saved. When it works, the screen says Stripe Managed Payments is ready. Saving also adds the Managed Payments events to the Stripe (Stackless) webhook, so renewals, refunds and subscription changes made in Stripe reach FluentCart.

Stripe Managed Payments (Stackless) settings in FluentCart: the shared Stripe connection status, Stripe tax code, Prices and tax, and setup notes

The Connection line shows each mode’s state: no Stripe (Stackless) API keys, API keys saved, no webhook signing secret yet or connected through Stripe (Stackless). Test orders use the test keys and live orders the live ones, following FluentCart’s store mode.

In FluentCart’s Payments list the gateway shows as Stripe Managed Payments (Stackless). Buyers never see that name. At checkout it reads Card, Apple Pay, Google Pay or Link.

Set the Tax Code and Prices

Managed Payments needs an eligible Stripe tax code on everything it sells. Stripe tax code applies one code to every product, so pick the one that best describes what you sell:

CodeWhat it covers
txcd_10000000Electronically supplied services (general), the default
txcd_10103000SaaS, personal use
txcd_10103001SaaS, business use
txcd_10103100SaaS, electronic download, personal use
txcd_10103101SaaS, electronic download, business use
txcd_10202000Downloadable software, personal use
txcd_10202003Downloadable software, business use
txcd_10701100Website hosting
txcd_20060058Training, self-study web-based

Prices and tax tells Stripe how to read your FluentCart prices:

  • Add tax on top of my prices (default): the buyer pays your price plus tax.
  • My prices already include tax: Stripe works the tax out of your price.

Turn off FluentCart tax for products you sell this way, or buyers are taxed twice. Stackless doesn’t block it, so check your tax settings before you go live.

Which Carts Can Use It

Managed Payments shows at checkout only when Stripe can be the seller for everything in the cart. It hides itself when:

  • a product in the cart isn’t a digital product, or is a Service Product;
  • the cart needs shipping;
  • the cart holds more than one subscription;
  • Stripe can’t charge the store currency;
  • Stripe (Stackless) has no API keys for the current mode.

While it’s hidden, store admins see a note on the checkout that only they can read, starting Only you see this: Stripe Managed Payments is hidden for this cart. with the reason. Buyers just see the other payment methods.

Being digital isn’t enough on its own. Stripe’s rules leave out professional services such as consulting or design work, and live in-person events, even when you sell them as digital products. Keep those on Stripe (Stackless).

What Buyers See

At checkout the method reads Card, Apple Pay, Google Pay or Link and tells the buyer, before they pay, that Stripe adds sales tax or VAT for their location on the next step:

FluentCart checkout payment methods with Stripe Managed Payments selected as Card, Apple Pay, Google Pay or Link, and the notes that Stripe adds sales tax or VAT on the next step

Placing the order takes the buyer to a pay page on your own store. It shows your logo, Secure checkout, the order summary and Stripe Checkout:

  • The summary lists the items, subtotal, discounts and fees, and a Sales tax or VAT: Added by Stripe row.
  • With tax added on top, the total reads Total before tax, with the note that Stripe shows the total with tax at the top of the payment form before the buyer pays.
  • For a subscription it shows the free trial and the renewal line, such as Then $19.00 every month, plus tax.
  • Choose another payment method goes back to the order’s payment page.
  • In test mode it says to use a Stripe test card and that no real payment will be taken.
  • It follows the buyer’s light or dark setting.

Stripe Checkout collects the billing details, adds the tax, and offers cards, Apple Pay, Google Pay, Link and the local methods Stripe picks for that buyer. Once Stripe confirms the payment, the buyer lands on your order confirmation page. Stripe emails its own receipt as the merchant of record.

A bank payment that’s still processing leaves the order unpaid with the note Stripe is processing the payment. It updates when the bank confirms. Prices always come from FluentCart, and nothing is added to your Stripe product catalog.

Tax on Receipts and in the Order Log

The buyer pays more than your order total when tax is added on top, so Stackless says so everywhere the total appears:

  • The FluentCart receipt and order email add a line such as: You paid $2.39 through Stripe: $1.99 for this order plus $0.40 sales tax or VAT, which Stripe collects as the merchant of record.
  • The order log records the same split under Stripe payment confirmed. The order keeps $1.99, which is what your store earns before Stripe’s fees. Stripe keeps the tax and files it.

So a $1.99 order that shows $2.39 in Stripe isn’t a mismatch. It’s your price plus the tax Stripe collected for the buyer’s location.

If the amount Stripe charged before tax doesn’t match the order total, or the currency differs, the payment is held instead of confirmed. The order log says Stripe payment held with both amounts. Check it in Stripe before you fulfill the order. A payment that arrives after the order was cancelled is held the same way.

Subscriptions

Stripe Billing runs the schedule for subscriptions bought this way:

  • One subscription per checkout. One-time items and a signup fee in the same cart are charged on the first invoice.
  • Free trials work. Nothing is charged until the trial ends.
  • Each renewal Stripe charges becomes a FluentCart renewal, with the Stripe invoice ID. If the amount differs from FluentCart’s, it’s still recorded and the subscription log notes the difference.
  • When a renewal charge fails, Stripe retries it on its own schedule. The subscription log notes each failed attempt.
  • Billing intervals from daily to yearly work. The longest schedule Stripe can bill is three years.

Stripe statuses map to FluentCart ones:

StripeFluentCart
active, trialingActive, Trialing
active with collection pausedPaused
past_dueExpiring
unpaidExpired
canceledCanceled (Expired when Stripe cancelled it for failed payments)

Cancelling from FluentCart cancels at Stripe too, at the end of the paid period unless you cancel immediately. Pausing pauses collection at Stripe, so invoices made while it’s paused aren’t charged, and resuming starts billing again.

Stripe keeps the card for these subscriptions. Customers update it in Stripe’s customer portal, linked from their FluentCart account. FluentCart’s own card form doesn’t apply.

Some things Stripe Billing can’t do here:

  • A first-payment discount. Stripe charges at least one full billing cycle on the first payment, so remove the discount or use another payment method.
  • Klarna, Afterpay and Bancontact take one-time payments only.
  • Subscriptions FluentCart bills itself (manual renewals) are paid one invoice at a time, each as its own Stripe payment.

Refunds and Disputes

Refund from the FluentCart order screen, in full or in part. Stripe refunds the tax it collected in proportion, so a full refund returns the tax too. Refunds made in the Stripe Dashboard are recorded on the order through the webhook, as Recorded refund … made in Stripe.

Stripe handles disputes as the merchant of record. When one opens, the order log notes the reason and the payment shows as disputed. Follow it in the Stripe Dashboard. A lost dispute is marked on the payment, and a won one returns it to a normal charge.

On a staging or local copy of your store, refunds and subscription changes aren’t sent to Stripe until an admin confirms the site is the live store.

Messages Buyers Can See

  • Stripe Managed Payments sells digital products only. The cart changed after checkout loaded, and it now holds a physical product or a service.
  • Stripe Managed Payments can bill one subscription per checkout. The cart holds two or more subscriptions.
  • Stripe needs an amount greater than zero to start a checkout. The order is free. Use another method for free orders.
  • Stripe Managed Payments is not available on this Stripe account yet. Stripe hasn’t approved the account for Managed Payments.
  • This payment was already submitted to Stripe and is being confirmed. The buyer went back after paying. They’re sent to their receipt.

Good to Know

  • Managed Payments always uses the main Stripe (Stackless) gateway’s account, never a gateway copy.
  • There’s no separate webhook URL. Everything goes to the Stripe (Stackless) webhook, and the settings warn when Stripe has no webhook for the current mode.
  • The Stripe API version is fixed by Stackless, so a newer default in your Stripe account doesn’t change behavior.

For Developers

These filters change how Managed Payments works. The full list is in the hooks reference.

HookWhat it does
gtfc_stripe_managed_tax_codeSet the tax code per order (txcd_ plus 8 digits).
gtfc_stripe_managed_is_digitalDecide which products count as digital.
gtfc_stripe_managed_cart_reasonChange why a cart is refused, or allow it.
gtfc_stripe_managed_billing_intervalsMap extra FluentCart billing intervals to Stripe.
gtfc_stripe_managed_session_argsChange the Stripe Checkout Session before it’s created.
gtfc_stripe_managed_pay_page_configChange the pay page settings, such as the accent color.
gtfc_stripe_managed_hiddenAction that runs when the method is hidden for a cart.
gtfc_stripe_managed_subscription_syncedAction that runs after a subscription syncs from Stripe.
Share

Was this helpful?

Still stuck? Open a support ticket