Skip to content

A4A: Send WordPress.com purchases to the Needs setup page after BD checkout - #113353

Open
jkguidaven wants to merge 1 commit into
trunkfrom
improve/a4a/wpcom-purchase-and-creation-flow
Open

A4A: Send WordPress.com purchases to the Needs setup page after BD checkout#113353
jkguidaven wants to merge 1 commit into
trunkfrom
improve/a4a/wpcom-purchase-and-creation-flow

Conversation

@jkguidaven

@jkguidaven jkguidaven commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Related to https://linear.app/a8c/issue/A4A-3165/a4a-wpcom-flow-efficiency-improvements

Proposed Changes

  • Bring the Billing Dragon checkout to parity with the legacy purchase flow for WordPress.com purchases.
  • After buying a WordPress.com plan, agencies now land on the “Needs setup” page with the purchase confirmation banner, instead of the licenses list.
  • The mini-cart now clears on the “Needs setup” page too, so it still empties after a successful purchase.

Why are these changes being made?

  • The legacy flow already sent WordPress.com purchases straight to “Needs setup,” where agencies get a confirmation that the purchase went through and can immediately create their site. That behaviour was never carried over when checkout moved to Billing Dragon.
  • As a result, agencies buying a WordPress.com plan today are dropped on the licenses list with no confirmation and no obvious next step — they have to work out on their own that the site still needs to be created.
  • This restores the original, more guided experience rather than introducing anything new.

Testing Instructions

  • Add a WordPress.com plan to the cart in the marketplace and complete checkout.
  • Confirm you land on the “Needs setup” page and see the purchase confirmation banner.
Screenshot 2026-08-07 at 12 07 41 AM 2
  • Confirm the mini-cart is empty afterwards.
  • Repeat with a cart containing only non-WordPress.com products (e.g. a Jetpack license) and confirm you still land on the licenses list as before.

Pre-merge Checklist

  • Has the general commit checklist been followed? (PCYsg-hS-p2)
  • Have you written new tests for your changes?
  • Have you tested the feature in Simple (P9HQHe-k8-p2), Atomic (P9HQHe-jW-p2), and self-hosted Jetpack sites (PCYsg-g6b-p2)?
  • Have you checked for TypeScript, React or other console errors?
  • For UI changes, have you tested the affected components in dark mode?
  • Have you tested accessibility for your changes? Ensure the feature remains usable with various user agents (e.g., browsers), interfaces (e.g., keyboard navigation), and assistive technologies (e.g., screen readers) (PCYsg-S3g-p2).
  • Have you used memoizing on expensive computations? More info in Memoizing with create-selector and Using memoizing selectors and Our Approach to Data
  • Have we added the "[Status] String Freeze" label as soon as any new strings were ready for translation (p4TIVU-5Jq-p2)?
    • For UI changes, have we tested the change in various languages (for example, ES, PT, FR, or DE)? The length of text and words vary significantly between languages.
  • For changes affecting Jetpack: Have we added the "[Status] Needs Privacy Updates" label if this pull request changes what data or activity we track or use (p4TIVU-aUh-p2)?

The legacy issue-and-assign flow redirected any purchase containing a
WordPress.com plan to /sites/need-setup with a wpcom_creator_purchased
query arg, which the Needs setup page turns into a purchase confirmation
banner. That was never carried over to the Billing Dragon checkout, so
those purchases landed on the licenses list with no confirmation and no
prompt to provision the site.

Derive the purchased plan slug from the cart and build the success
redirect accordingly, keeping the receipt_id placeholder alongside it.
The Needs setup page now also clears the persisted mini-cart on success,
which previously only happened on the licenses page.
@jkguidaven jkguidaven self-assigned this Aug 6, 2026
@jkguidaven jkguidaven added the A4A label Aug 6, 2026
@jkguidaven
jkguidaven requested a review from a team August 6, 2026 16:12
@matticbot matticbot added the [Status] Needs Review The PR is ready for review. This also triggers e2e canary tests and wp-desktop tests automatically. label Aug 6, 2026
@jkguidaven jkguidaven changed the title A4A: Send WordPress.com purchases to the Needs setup page after checkout A4A: Send WordPress.com purchases to the Needs setup page after BD checkout Aug 6, 2026
@jkguidaven
jkguidaven marked this pull request as ready for review August 6, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A4A [Status] Needs Review The PR is ready for review. This also triggers e2e canary tests and wp-desktop tests automatically.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants