{
  "slug": "stripe-checkout-sessions-and-payment-links-support-managed-payments-e12a19c8422f",
  "title": "Stripe Checkout Sessions and Payment Links support Managed Payments",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-22T00:00:00.000Z",
  "announced_at": "2026-04-22T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "For a repository selling eligible digital products through Checkout Sessions or Payment Links, enable Managed Payments with `managed_payments[enabled]=true` when creating the session or link. Remove parameters Stripe manages automatically; Checkout setup also requires Dashboard enablement, accepted terms, and eligible products.",
    "examples": [
      "curl https://api.stripe.com/v1/checkout/sessions -u \"<<YOUR_SECRET_KEY>>:\" -d \"line_items[0][price]={{PRICE_ID}}\" -d \"line_items[0][quantity]=1\" -d \"managed_payments[enabled]=true\" -d mode=payment --data-urlencode \"success_url=https://example.com/success\"",
      "curl https://api.stripe.com/v1/payment_links -u \"<<YOUR_SECRET_KEY>>\" -H \"Stripe-Version: 2026-04-22.dahlia\" -d \"line_items[0][price]={{PRICE_ID}}\" -d \"line_items[0][quantity]=1\" -d \"managed_payments[enabled]=true\""
    ],
    "gotchas": [
      "managed_payments (Checkout Sessions and Payment Links): Optional object with Managed Payments settings for the session or link and resulting objects.",
      "managed_payments[enabled]: Set to `true` to enable Managed Payments when creating a Checkout Session. The guide documents this parameter for Checkout Sessions.",
      "line_items (required): Payment Link items being sold; up to 20 line items.",
      "line_items (required): Required for Checkout Sessions in `payment` and `subscription` mode; passes one-time or recurring Prices.",
      "mode (required): Checkout Session mode; use `payment` for one-time payments or `subscription` for subscriptions.",
      "success_url: URL for customers after payment or setup completes; required conditionally, and unavailable with `embedded_page` or `elements` UI modes.",
      "Prerequisite: Checkout integration must create Checkout Sessions in `payment` or `subscription` mode; enable Managed Payments in Dashboard, accept its terms, ensure products meet eligibility requirements, and use API version `2025-03-31.basil` or later.",
      "Prerequisite: Set an eligible tax code on each product used with Managed Payments.",
      "Prerequisite: The API examples require a Price ID; the docs list creating a Price as a prerequisite.",
      "For selling digital products such as SaaS, software, and digital content or downloads.",
      "When Managed Payments is enabled, certain parameters related to Connect, tax configuration, and shipping are managed automatically and can't be manually specified.",
      "Indirect tax compliance coverage is described as more than 80 countries."
    ]
  },
  "why_it_matters": "For a repository integrating Stripe Checkout Sessions or Payment Links to sell digital products, enable Managed Payments when using Stripe’s merchant-of-record service.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-04-22/managed-payments",
    "https://docs.stripe.com/payments/managed-payments/update-checkout",
    "https://docs.stripe.com/api/payment-link/create?api-version=2026-04-22.dahlia",
    "https://docs.stripe.com/api/checkout/sessions/create?api-version=2026-04-22.dahlia"
  ],
  "rank": 0.97043,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-dadcfc17196fcfd3-0:gate",
    "evidence_hash": "2e4f5a0e87e4ccb2b50705a637bde68425c2c6ce406d370252558b97aecc6bdb"
  },
  "review": {
    "draft_hash": "13b327d550f02bc17eaf9c4c8d2b3debda02f688be60c5856c1133157ac30124",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.66 (>= 0.6 needed)."
  }
}