docs: add merchant migrations design doc#12454
Closed
psincraian wants to merge 9 commits into
Closed
Conversation
Engineering design document (RFC) for migrating merchants from Stripe, Lemon Squeezy, and Paddle to Polar, plus its handbook nav entry. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
… our integration SEPA PaymentMethods and ACH are copyable (only Bacs / legacy SEPA sources aren't); subscription period now lives on the item (Basil API); anchor is day-of-month; single discount per sub; sub marker stored in user_metadata. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Propagate the SEPA/ACH-copyable correction into the body and Appendix A; reconcile the org-status gate (REVIEW or ACTIVE); describe the cleanup phase; consistent phase/owner wording; cross-reference the appendices and the precheck engine. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…eider-765c1a # Conflicts: # handbook/docs.json
…a' into psincraian/elastic-greider-765c1a # Conflicts: # handbook/docs.json
5 tasks
Contributor
Author
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
1 participant
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.
Summary
Adds an engineering design document (RFC) for migrating merchants to Polar from Stripe, Lemon Squeezy, and Paddle, and registers it in the handbook navigation.
The design it's generic, but for now it's more focused from Stripe to Polar.
Why
Gives the team a single, reviewable plan for merchant migrations before implementation starts.
Checklist
uv run task lint && uv run task lint_types)🤖 Generated with Claude Code
Summary by cubic
Adds an engineering design doc for migrating merchants from Stripe, Lemon Squeezy, and Paddle to Polar with a guided process for catalog import, PAN Copy/Import, per-subscription cutover, and cleanup. Adds a testing and rollout plan.
user_metadata.pm_…ids.migration_billing_paused; SEPA/ACH guidance aligned across the body and Appendix A; live-only testing plan added (start with a small PAN Copy on live, then a friendly merchant, behind a feature flag); page registered in the handbook navigation.Written for commit 44b01ca. Summary will update on new commits.