docs(billing): explain the final invoice after cancellation#12203
Open
jd wants to merge 1 commit into
Open
Conversation
Contributor
Merge Protections🔴 2 of 6 protections blocking · waiting on 👀 reviews
🔴 👀 Review RequirementsWaiting for
This rule is failing.
🔴 🔎 ReviewsWaiting for
This rule is failing.
Show 4 satisfied protections🟢 🤖 Continuous Integration
🟢 Enforce conventional commitMake sure that we follow https://www.conventionalcommits.org/en/v1.0.0/
🟢 📕 PR description
🟢 🚦 Auto-queueWhen all merge protections are satisfied, this pull request will be queued automatically. |
There was a problem hiding this comment.
Pull request overview
This PR updates the billing documentation to reduce confusion when customers cancel mid-period but still receive a final (true-up) invoice at the end of the paid billing period.
Changes:
- Adds cancellation mechanics to “Switching or Cancelling Plans”, including a warning about a possible last invoice on the final day.
- Adds a new “Final Invoice After Cancellation” subsection under “Understanding Your Invoice”.
- Adjusts the “Understanding Your Invoice” intro/outro to reflect the added subsection.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Customers who cancel mid-period are told their subscription stays active through the end of the period they already paid for. When their contributor count grew during that last period, Stripe collects the accrued prorations on the next invoice — which, for a cancelling subscription, is the final one, dated on the very last day. Customers read that as "I cancelled and got billed anyway" (see Plain T-4504). The billing page documented the two invoice sections but nothing about cancellation mechanics or this final true-up. This adds: - a paragraph in "Switching or Cancelling Plans" stating the subscription ends at period end without renewing, and warning that one last invoice may arrive on that final day; - a new "3. Final Invoice After Cancellation" subsection under "Understanding Your Invoice" explaining that this invoice is a proration true-up for the final period, not a renewal, and that nothing is charged after it. The "Understanding Your Invoice" intro and closing sentence are adjusted since the page no longer describes exactly two subsections. Change-Id: I51b3372e5ac0708699d181f4a5f09ffdc71618b4
jd
force-pushed
the
devs/jd/jd/billing-cancellation-invoice/explain-final-invoice-cancellation--51b3372e
branch
from
July 25, 2026 21:43
cefb6f3 to
40ccb0c
Compare
Member
Author
Revision history
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Customers who cancel mid-period are told their subscription stays active
through the end of the period they already paid for. When their contributor
count grew during that last period, Stripe collects the accrued prorations on
the next invoice — which, for a cancelling subscription, is the final one,
dated on the very last day. Customers read that as "I cancelled and got billed
anyway" (see Plain T-4504).
The billing page documented the two invoice sections but nothing about
cancellation mechanics or this final true-up. This adds:
at period end without renewing, and warning that one last invoice may arrive
on that final day;
Your Invoice" explaining that this invoice is a proration true-up for the
final period, not a renewal, and that nothing is charged after it.
The "Understanding Your Invoice" intro and closing sentence are adjusted since
the page no longer describes exactly two subsections.