docs: add top-level Global Accounts tab

[jklein24]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ready	Preview, Comment	Apr 28, 2026 7:07am

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Grid	🟢 Ready	View Preview	Apr 28, 2026, 6:32 AM

[jklein24]

• docs: add top-level Global Accounts tab #410 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Summary

This PR adds a new top-level Global Accounts documentation tab to the Mintlify site — a new landing page (global-accounts/index.mdx), four account-security pages, three platform-tools pages, and new shared snippets (concepts.mdx and walkthrough.mdx) extracted from the old overview.mdx. The four cross-product overview pages (global-p2p, payouts-and-b2b, ramps, rewards) are updated to import the two split snippets instead of the monolithic one.

• The relative href values in walkthrough.mdx's bottom CardGroup (./client-keys, ./authentication, ./managing-sessions, ./exporting-wallet) and the inline <a> anchors in steps 3 and 7, along with the ../onboarding/configuring-customers link on line 52, still break when this snippet is embedded in the cross-tab overview pages — this was flagged in a prior review and remains unresolved.

Confidence Score: 4/5

Safe to merge for the new Global Accounts tab itself; the outstanding relative-link breakage in walkthrough.mdx affects the cross-tab overview pages and was flagged in a prior review cycle.

The new top-level tab, landing page, wrapper pages, and sandbox guide are all clean. The unresolved P1s (relative hrefs in walkthrough.mdx that 404 on cross-tab overview pages) were already flagged before this revision and remain unaddressed, capping the score at 4.

mintlify/snippets/global-accounts/walkthrough.mdx — relative hrefs in the bottom CardGroup and inline anchors break when embedded in global-p2p, payouts-and-b2b, ramps, and rewards overview pages.

Important Files Changed

Filename	Overview
mintlify/docs.json	Adds new "Global Accounts" top-level tab with three groups (Overview, Account security, Platform tools); all referenced page paths correspond to new files in this PR.
mintlify/global-accounts/index.mdx	New landing page for the Global Accounts tab; includes hero image (consistent with other tab index pages), feature cards, and nav cards pointing to absolute internal paths.
mintlify/snippets/global-accounts/walkthrough.mdx	Renamed from overview.mdx; contains relative hrefs in the bottom CardGroup (./client-keys, ./authentication, etc.) and inline anchors in steps 3/7, plus a ../onboarding/configuring-customers link — all of which break when this snippet is embedded in the cross-tab overview pages (flagged in prior review).
mintlify/snippets/global-accounts/concepts.mdx	New snippet containing concept prose (architecture tables, payment flow, auth key types); no relative links — cleanly extracted from the old overview.mdx.
mintlify/global-accounts/platform-tools/sandbox-testing.mdx	New sandbox testing guide with valid snippet import, well-structured steps, absolute internal links, and proper language tags on code blocks.
mintlify/global-p2p/global-accounts/overview.mdx	Updated to import the two new split snippets (concepts + walkthrough); inherits the relative-link issues from walkthrough.mdx when both snippets are embedded here.
mintlify/global-accounts/implementation-overview.mdx	Thin wrapper importing the walkthrough snippet; relative links in the snippet resolve correctly from this page's path (global-accounts/).

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[snippets/global-accounts/concepts.mdx] --> B[global-accounts/index.mdx]
    A --> C[global-p2p/global-accounts/overview.mdx]
    A --> D[payouts-and-b2b/global-accounts/overview.mdx]
    A --> E[ramps/global-accounts/overview.mdx]
    A --> F[rewards/global-accounts/overview.mdx]

    G[snippets/global-accounts/walkthrough.mdx] --> H[global-accounts/implementation-overview.mdx]
    G --> C
    G --> D
    G --> E
    G --> F

    G -- "relative links OK on this page" --> H
    G -- "relative links break here" --> C
    G -- "relative links break here" --> D
    G -- "relative links break here" --> E
    G -- "relative links break here" --> F

Loading

_{Reviews (3): Last reviewed commit:} "docs: add top-level Global Accounts tab" | Re-trigger Greptile

[jklein24]

@greptile review

[patcapulong]

lgtm tysm

[jklein24]

@greptile review

[patcapulong]

lgtm tysm