{
  "slug": "stripe-checkout-sessions-create-adds-pending-invoice-item-interval-9415e6f35be0",
  "title": "Stripe Checkout Sessions create adds 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": "For a subscription Checkout Session, set `subscription_data[pending_invoice_item_interval]` to `day`, `week`, `month`, or `year` to set the billing frequency for pending invoice items. [Stripe changelog](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions)",
    "examples": [
      "curl https://api.stripe.com/v1/checkout/sessions -u \"<YOUR_SECRET_KEY>\" -H \"Stripe-Version: 2026-03-25.dahlia\" --data-urlencode \"success_url=https://example.com/success\" -d \"line_items[0][price]=<PRICE_ID>\" -d \"line_items[0][quantity]=1\" -d \"mode=subscription\" -d \"subscription_data[pending_invoice_item_interval][interval]=month\" -d \"subscription_data[pending_invoice_item_interval][interval_count]=1\""
    ],
    "gotchas": [
      "Version: 2026-03-25.dahlia",
      "mode (required): Set to `subscription` for a Checkout Session that includes at least one recurring item.",
      "line_items (required): Items being purchased; required for `subscription` mode.",
      "subscription_data: Optional subset of parameters passed to subscription creation for Checkout Sessions in `subscription` mode.",
      "subscription_data.pending_invoice_item_interval: Sets the billing frequency for pending invoice items; supported values: `day`, `week`, `month`, `year`. The docs do not state whether these values are mutually exclusive.",
      "subscription_data.pending_invoice_item_interval nested fields: Not found in accessible official reference; exact nested field names and any count parameter are undocumented in the pages read.",
      "Prerequisite: Use Checkout in `subscription` mode with at least one recurring item. The API reference lists `line_items` as required for subscription mode.",
      "Prerequisite: The API reference gives a prerequisite Price creation example using a recurring monthly Price.",
      "Applies when using Checkout with subscriptions.",
      "Supported intervals are `day`, `week`, `month`, and `year`."
    ]
  },
  "why_it_matters": "Configure a subscription Checkout Session to invoice pending items on a schedule different from the subscription cycle.",
  "before": "The changelog says the previous approach was to update the Subscription after the Checkout Session completed to configure the pending invoice item interval.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions",
    "https://docs.stripe.com/api/checkout/sessions/create?api-version=2026-03-25.dahlia"
  ],
  "rank": 0.96021,
  "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-54243e2f999714bb-0:gate",
    "evidence_hash": "9f9be08f3b31d88088d30706587db42d12ac7e8ee5082b17d1037f6a61eb7cb0"
  },
  "review": {
    "draft_hash": "e6f9e543cd98829e34f10d5a8fe0b6c4546cfc4776f53fd05564524777fe46c4",
    "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.96 >= 0.9; 2 needed) and Jev gave 0.74 (>= 0.6 needed)."
  }
}