Skip to content
Gaurav TiwariDocs

Stripe Managed Payments

Version 1.0.0-beta.1 Updated November 8, 2026

You sell software, courses or digital files, 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, because 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. It’s a second gateway inside the Stripe module: buyers pay in Stripe Checkout on a page of your own store, and Stackless keeps EDD orders, renewals, refunds and cancellations in step through the Stripe webhook you already use.

When to Use It

Use it for digital downloads when you’d rather Stripe carry the tax work. Keep the regular Stripe gateway for everything else. Both can be on at once, and Managed Payments hides itself for carts it can’t take.

StripeStripe Managed Payments
Seller of recordYour businessStripe
Sales tax and VATYou, with EDD taxesStripe calculates, collects and remits it
What you can sellAny downloadDigital downloads, not services
Where buyers payPayment form on the EDD 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 turn it on. Stripe reviews each account before it can take payments this way. Stripe’s eligibility rules also require:

  • A business based in a country Stripe supports for Managed Payments, such as the US, Canada, most of Europe, Australia, Hong Kong, Japan or Singapore.
  • A direct Stripe account. Connect platforms and accounts controlled by a platform can’t use Managed Payments.

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 the Stripe module first: switch it on under Stackless → Dashboard and add your keys and webhook signing secrets under Stackless → Settings → Stripe. Managed Payments uses the same keys, webhook, test mode and debug log.
  2. Save the Stripe settings once, so the webhook also sends the Managed Payments events.
  3. Go to Downloads → Settings → Payments and switch on Stripe Managed Payments (Stackless) under Active Gateways. Save.

The Payments tab also gets a Stripe Managed Payments (Stackless) section with an Open Stripe settings button. The options live in the Stripe Managed Payments section of Stackless → Settings → Stripe:

  • Title: the payment method name shoppers see at checkout. Default “Card, Apple Pay, Google Pay or Link”.
  • Description: shown under the title. Default “You’ll pay securely with Stripe on the next step. Sales tax or VAT for your location is added before you pay.”
  • Stripe tax code and Prices and tax: see the next section.

The Status panel on the same screen has a Managed Payments row that says whether the gateway is enabled at checkout.

Connect the Webhook

Managed Payments shares the Stripe webhook, https://yoursite.com/wp-json/stackless-edd/v1/stripe/webhook. Besides the regular Stripe events, the endpoint needs these:

checkout.session.completed
checkout.session.async_payment_succeeded
checkout.session.async_payment_failed
checkout.session.expired
invoice.paid
invoice.payment_failed
customer.subscription.updated
customer.subscription.deleted
customer.subscription.paused
customer.subscription.resumed

When you save the Stripe settings with a signing secret entered, Stackless finds the endpoint for this URL in Stripe and adds any events it’s missing. If Stripe won’t let it, a warning asks you to add them in Stripe yourself.

The first payment also settles when the buyer comes back from Stripe. Renewals, refunds made in Stripe, pauses and cancellations only reach EDD through the webhook.

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 download in the order, 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 EDD 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 EDD Taxes

Stripe adds sales tax and VAT itself, so turn off taxes under Downloads → Settings → Taxes while you sell with Managed Payments. Otherwise buyers who pay this way are taxed twice.

While EDD taxes are on, the Status panel shows a warning with a Turn off EDD taxes link, and Billing Health lists it. An order that still carries EDD tax goes to Stripe as one line for the whole order instead of one line per download.

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 download in the cart is marked as a Service with Service Products
  • the cart holds subscriptions on more than one billing schedule
  • the store currency is one Stripe doesn’t support
  • the total is zero and there’s no subscription to start
  • the buyer is paying a renewal or plan switch order from its payment link
  • the Stripe keys for the selected mode are missing

Every other download counts as digital. Stripe’s rules leave out professional services, such as consulting or design work, and in-person events. Mark those downloads as a Service, or sell them through the regular Stripe gateway.

What Buyers See

The buyer picks Managed Payments at checkout and clicks Purchase. EDD creates the order, and the buyer goes to a pay page on your own store.

The pay page has your logo or store name with a Secure checkout badge, the order summary on one side and Stripe Checkout on the other. The summary lists the downloads and totals, the amount due today and, for subscriptions, the free trial end date and the renewal line, such as “Then $19 every month”. A note says Stripe is the merchant of record and emails the receipt.

The page follows the buyer’s light or dark setting, and on phones the summary folds away while the renewal line stays in view. Back to the store returns to checkout to pick another method. In test mode, the page asks for a Stripe test card and says no real payment will be taken.

Stripe Checkout collects the billing details, adds sales tax or VAT for the buyer’s location, and offers cards, Apple Pay, Google Pay, Link and the local payment methods Stripe picks for that buyer. Once Stripe confirms the payment, the buyer lands on the EDD receipt page.

  • A bank payment that’s still processing puts the order in Processing until the bank confirms it. If the bank declines it later, the order fails.
  • If the amount Stripe charged before tax doesn’t match the order total, the order goes on hold with a note to check it in Stripe before you deliver the files.
  • If the Stripe session expires before the buyer pays, opening the pay page again starts a fresh one for the same order.

Prices always come from EDD, and nothing is added to your Stripe product catalog.

Subscriptions on Managed Payments

Stripe Billing runs the schedule for subscriptions bought this way:

  • One subscription schedule per checkout. One-time downloads and a signup fee in the same cart are charged on the first invoice.
  • Free trials work. The trial is passed to Stripe in days, and nothing is charged until it ends.
  • Each renewal Stripe charges becomes a paid EDD renewal order, with the Stripe invoice ID in the order notes.
  • The next payment date follows Stripe.
  • When a renewal charge fails, Stripe retries it on its own schedule. The subscription gets a note with the decline code and goes On hold while Stripe reports it past due. Stackless runs no retries of its own.

Stripe statuses map to Stackless ones: past due and unpaid become On hold, canceled becomes Cancelled, a cancellation set for the end of the period becomes Pending cancellation, and paused collection becomes Paused.

Cancel, Pause and Update the Card

Cancelling from the subscription screen or the account page cancels at Stripe too, at the end of the paid period or straight away. If Stripe doesn’t confirm, the cancellation is refused.

Pausing the subscription pauses collection at Stripe. Invoices Stripe creates while it’s paused are voided, so the customer isn’t charged, and billing starts again when you resume it or on the resume date you set.

Stripe keeps the card for these subscriptions, so the subscription on the account page shows Update payment method, which opens Stripe’s customer portal. A cancellation made at Stripe reaches EDD through the webhook.

What Stripe Controls

Because Stripe runs billing, customers can’t renew early, skip a renewal or undo a pending cancellation, and you can’t change the next payment date. Changing the billing schedule on the subscription screen doesn’t change Stripe’s schedule.

A renewal order of one of these subscriptions can’t be paid from its payment link either. Stripe retries the charge itself, so a second payment would charge the customer twice. Checkout points them to their subscription instead.

A download with Renewal mode set to Manual only (customer pays each renewal invoice) isn’t billed by Stripe. Its first order goes through Managed Payments as a one-time payment, and the store emails each renewal invoice, which the customer pays with another payment method. The renewal mode of a subscription on Managed Payments can’t be changed after checkout.

Refunds and Disputes

Refund from the EDD order screen, in full or in part. The refund form gets the same Refund the charge in Stripe box as the Stripe gateway, ticked by default, and Stripe is called before EDD records the refund. The amount sent is the one you refund in EDD, so check the refund in the Stripe Dashboard to see how Stripe handled the tax it collected.

Refunds made in the Stripe Dashboard are recorded on the order through the webhook. So are refunds Stripe makes on its own: as the seller, Stripe can refund a buyer within 60 days of purchase in some cases, for example to head off a chargeback.

Stripe handles disputes as the merchant of record. When one opens, the order gets a note with the amount, reason and dispute ID, and a Completed or Partially Refunded order goes on hold through EDD’s dispute record, which pauses file access.

Good to Know

  • If Stripe refuses to start Managed Payments, the buyer sees “Stripe Managed Payments is not available on this Stripe account yet. Choose another payment method.” The order note has the reason. Check that Stripe approved the account.
  • Billing Health warns when the Stripe webhook may be missing the Managed Payments events, and lists Stripe webhook events that failed or never finished in the last 7 days.
  • Payment failure alerts in Extra Enhancements can watch Stripe Managed Payments on its own. If you saved Watch these gateways before, add it there.
  • Post-purchase offers don’t charge Managed Payments orders in one click. Accepting an offer sends the buyer to pay for the new order instead.
  • The transaction ID on the order screen links to the payment in the Stripe Dashboard.
  • Debug log in the Stripe settings covers Managed Payments too (stackless-edd-stripe_gateway).

Limits

  • Stripe must approve your account, and only direct accounts in the supported business countries qualify.
  • Digital downloads only, and one subscription schedule per checkout.
  • Stripe charges at least one full billing cycle on the first payment, so a first-payment discount outside a free trial can’t use Managed Payments. The longest billing interval is three years.
  • Only new subscriptions use it. Subscriptions started with another method keep renewing there, and the EDD Recurring migration can’t move subscriptions into Managed Payments.
  • Stripe picks the payment methods each buyer sees. Klarna, Afterpay and Bancontact take one-time payments only, so they don’t show for subscriptions.
  • Every download in an order uses the same Stripe tax code.
  • On a copy of your live store, cancelling, pausing or resuming a subscription that Stripe bills is refused, so a staging site never changes live billing.
  • Managed Payments can’t be duplicated with Payment Gateway Tools. It uses the one Stripe account of the Stripe module.

For Developers

Filters: stackless_edd_stripe_managed_tax_code (tax code per order), stackless_edd_stripe_managed_is_digital (which downloads count as digital), stackless_edd_stripe_managed_session_args (the Checkout Session request), stackless_edd_stripe_managed_pay_page_config (pay page settings, including accent) and stackless_edd_stripe_managed_api_version. The action stackless_edd_stripe_managed_subscription_synced fires after a subscription takes a new status from Stripe. To restyle the pay page, copy managed-pay-page.php to yourtheme/stackless-edd/stripe_gateway/managed-pay-page.php.

add_filter('stackless_edd_stripe_managed_tax_code', function ($code, $order) {
    // Business SaaS code for orders that include download 123.
    foreach ($order ? $order->get_items() : [] as $item) {
        if ((int) $item->product_id === 123) {
            return 'txcd_10103001';
        }
    }
    return $code;
}, 10, 2);

add_filter('stackless_edd_stripe_managed_pay_page_config', function ($config) {
    $config['accent'] = '#1a7f37';
    return $config;
});
Share

Was this helpful?

Still stuck? Open a support ticket