{
  "slug": "trial-offers-support-archiving-and-trial-end-settings-487620f4dbda",
  "title": "Trial Offers support archiving and trial end settings",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-30T00:00:00.000Z",
  "announced_at": "2026-09-30T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "To retire a trial offer, set `active=false` when creating or updating it. For subscription trial-end behavior, set `trial_settings` to configure the missing-payment-method action and billing-cycle anchor.",
    "examples": [
      "curl https://api.stripe.com/v1/product_catalog/trial_offers/<TRIAL_OFFER_ID> \\\n  -u \"<YOUR_SECRET_KEY>\" \\\n  -H \"Stripe-Version: 2026-09-30.preview\" \\\n  -d active=false",
      "curl https://api.stripe.com/v1/subscriptions \\\n  -u \"<YOUR_SECRET_KEY>\" \\\n  -H \"Stripe-Version: 2026-09-30.preview\" \\\n  -d customer=<CUSTOMER_ID> \\\n  -d \"items[0][price]=<PRICE_ID>\" \\\n  -d \"trial_settings[end_behavior][missing_payment_method]=pause\" \\\n  -d \"trial_settings[end_behavior][billing_cycle_anchor]=unchanged\""
    ],
    "gotchas": [
      "active: Boolean; whether the trial offer can be used for new purchases. Set to `false` to archive it.",
      "trial_settings.end_behavior.missing_payment_method: At trial end without a payment method, choose `create_invoice`, `pause`, or `cancel`.",
      "trial_settings.end_behavior.billing_cycle_anchor: The release note describes `unchanged` as preserving the existing billing cycle and creating a prorated post-trial period.",
      "end_behavior.type: Use this property to determine the trial offer’s end behavior.",
      "end_behavior.transition: Optional property; it is no longer returned on all responses.",
      "customer: Identifier of the customer to subscribe.",
      "items (required): List of up to 20 subscription items, each with an attached price.",
      "Prerequisite: The subscription-create reference lists prerequisite setup: create a payment method, create a customer and attach it, create a product, and create a price.",
      "Prerequisite: Requests use a Stripe secret key and the `2026-09-30.preview` API version.",
      "Archived offers can't be attached to new subscription items; existing subscriptions continue using the trial offer until their trial ends.",
      "Missing-payment-method settings apply when a trial ends naturally or when the trial is ended early by changing or removing the trialing item."
    ]
  },
  "why_it_matters": "Retire an outdated trial offer while preserving subscriptions already using it, or configure what happens when a trial ends.",
  "before": "For missing-payment-method behavior, use subscription-level free trials; trial offers did not support those options. The source doesn't state the prior archiving behavior or prior billing cycle anchor behavior.",
  "sources": [
    "https://docs.stripe.com/changelog/endive/2026-09-30/trial-offers-archiving-and-trial-end-behavior-settings",
    "https://docs.stripe.com/api/product-catalog/trial-offer/update?api-version=2026-09-30.preview",
    "https://docs.stripe.com/api/subscriptions/create?api-version=2026-09-30.preview"
  ],
  "rank": 0.91029,
  "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-ea82e07a32e48778-0:gate",
    "evidence_hash": "013bb1cbc30ef9f1b5310a1336c3bdc7f7e48ddc075976a8a08a557014fdde58"
  },
  "review": {
    "draft_hash": "81c58d709dafa5941f78de94f9dddd18dd6fe78a252f9b8e3b57b3c9d21f3c73",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.91 >= 0.9; 2 needed) and Jev gave 0.72 (>= 0.6 needed)."
  }
}