{
  "slug": "stripe-checkout-sessions-update-accepts-pending-invoice-item-interval-442093e8c23a",
  "title": "Stripe Checkout Sessions update accepts pending invoice item interval",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-25T00:00:00.000Z",
  "announced_at": "2026-03-25T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When updating a subscription-based Checkout Session and setting a pending invoice item billing frequency, send `subscription_data[pending_invoice_item_interval][interval]` as `day`, `week`, `month`, or `year`. This lets pending items use a schedule different from the subscription cycle without a later Subscription update.",
    "examples": [
      "curl https://api.stripe.com/v1/checkout/sessions/<SESSION_ID> -u \"<SECRET_KEY>\" -H \"Stripe-Version: 2026-03-25.preview\" -d \"subscription_data[pending_invoice_item_interval][interval]=month\""
    ],
    "gotchas": [
      "subscription_data: Subscription-related parameters for Checkout Session updates.",
      "subscription_data[pending_invoice_item_interval][interval] (required): Billing interval. Allowed values: `day`, `week`, `month`, `year`.",
      "subscription_data[pending_invoice_item_interval][interval_count]: Multiplier for the interval. The official Stripe PHP parameter definition lists this sub-key as optional; the changelog does not describe its behavior.",
      "Prerequisite: For REST API requests, use API version `2026-03-25.preview` in the `Stripe-Version` header to use this release’s feature.",
      "Prerequisite: A Stripe secret key is used for authentication in the documented update request.",
      "Applies to pending invoice items when using Checkout with subscriptions."
    ]
  },
  "why_it_matters": "When updating a subscription-based Checkout Session, set a billing schedule for pending invoice items that differs from the subscription cycle.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions-update",
    "https://docs.stripe.com/api/checkout/sessions/update?api-version=2026-03-25.preview",
    "https://github.com/stripe/stripe-php/blob/master/lib/Checkout/Session.php"
  ],
  "rank": 0.97019,
  "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-b30376fdcf57b40f-0:gate",
    "evidence_hash": "44d9e9b40ae3cb7dcfa3c2cff3a46c9809f7a914664c6eaabd55da6386dedb35"
  },
  "review": {
    "draft_hash": "316046dc91b01c962bde2f6d74c606b564be740ba86c5882819bed0e4398c2a7",
    "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.69 (>= 0.6 needed)."
  }
}