Skip to content

docs(billing): add stablecoin payments documentation#31019

Open
tpikovskaia wants to merge 1 commit into
cloudflare:productionfrom
tpikovskaia:billing/stablecoin-payments-docs
Open

docs(billing): add stablecoin payments documentation#31019
tpikovskaia wants to merge 1 commit into
cloudflare:productionfrom
tpikovskaia:billing/stablecoin-payments-docs

Conversation

@tpikovskaia
Copy link
Copy Markdown
Contributor

@tpikovskaia tpikovskaia commented May 22, 2026

Summary

Adds a new payment-methods page covering stablecoin (USDC) payments via Unified Checkout.

What this covers

  • On-session wallet connection flow via the Stripe-hosted page at crypto.stripe.com
  • Supported stablecoins: USDC on Base and Polygon
  • Supported wallets: MetaMask, Phantom, Coinbase Wallet, 400+ via WalletConnect
  • Recurring billing via smart contract permit
  • Payment failure handling (insufficient funds, approval revoked, wallet screening)
  • Fallback to card on file (links to existing auto-retry doc)
  • USD-only refund behaviour
  • FAQ in noun-phrase format (per concept content type)

Style compliance

  • No gerunds, questions, or CTAs in headings
  • Description colons in numbered steps
  • description at top level of frontmatter
  • products: [billing] set
  • No internal metrics, gate names, or config IDs

Related

@tpikovskaia tpikovskaia requested review from a team as code owners May 22, 2026 11:59
@tpikovskaia tpikovskaia force-pushed the billing/stablecoin-payments-docs branch from 6891eda to 8a3857f Compare May 22, 2026 13:51
@tpikovskaia
Copy link
Copy Markdown
Contributor Author

Force-pushed to remove settlement and payment-processor mechanism language from customer-facing content. Customers don't need to know how Cloudflare receives or settles payments. The visible Stripe-hosted wallet page reference is retained because the redirect URL appears at checkout.

Adds a new payment-methods page covering stablecoin (USDC) payments via
Unified Checkout. Documents the on-session wallet connection flow,
recurring billing behaviour, supported stablecoins (USDC on Base and
Polygon), supported wallets, payment failure handling, and refund
behaviour.

Related:
- Internal wiki: https://wiki.cfdata.org/spaces/BILL/pages/1410575361
- SHIP-13563
- PCX-21819
@tpikovskaia tpikovskaia force-pushed the billing/stablecoin-payments-docs branch from 8a3857f to ac462f3 Compare May 22, 2026 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant