Update OpenAPI specification

openapi/spec3.beta.sdk.json

@@ -10140,7 +10140,7 @@
             }
           },
           "delinquent": {
-            "description": "If Stripe bills the customer's latest invoice by automatically charging and the latest charge fails, it sets `delinquent`` to `true``. If Stripe bills the invoice by sending it, and the invoice isn't paid by the due date, it also sets `delinquent`` to `true`.\n\nIf an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.",
+            "description": "Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`.\n\nIf an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.\n\nIf you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`.",
             "nullable": true,
             "type": "boolean"
           },

openapi/spec3.beta.sdk.yaml

@@ -9585,15 +9585,22 @@ components:
               - $ref: '#/components/schemas/payment_source'
         delinquent:
           description: >-
-            If Stripe bills the customer's latest invoice by automatically
-            charging and the latest charge fails, it sets `delinquent`` to
-            `true``. If Stripe bills the invoice by sending it, and the invoice
-            isn't paid by the due date, it also sets `delinquent`` to `true`.
+            Tracks the most recent state change on any invoice belonging to the
+            customer. Paying an invoice or marking it uncollectible via the API
+            will set this field to false. An automatic payment failure or
+            passing the `invoice.due_date` will set this field to `true`.
 
 
             If an invoice becomes uncollectible by
             [dunning](https://stripe.com/docs/billing/automatic-collection),
             `delinquent` doesn't reset to `false`.
+
+
+            If you care whether the customer has paid their most recent
+            subscription invoice, use `subscription.status` instead. Paying or
+            marking uncollectible any customer invoice regardless of whether it
+            is the latest invoice for a subscription will always set this field
+            to `false`.
           nullable: true
           type: boolean
         description:

openapi/spec3.json

@@ -6392,7 +6392,7 @@
             "x-stripeBypassValidation": true
           },
           "delinquent": {
-            "description": "If Stripe bills the customer's latest invoice by automatically charging and the latest charge fails, it sets `delinquent`` to `true``. If Stripe bills the invoice by sending it, and the invoice isn't paid by the due date, it also sets `delinquent`` to `true`.\n\nIf an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.",
+            "description": "Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`.\n\nIf an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.\n\nIf you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`.",
             "nullable": true,
             "type": "boolean"
           },

openapi/spec3.sdk.json

@@ -8385,7 +8385,7 @@
             }
           },
           "delinquent": {
-            "description": "If Stripe bills the customer's latest invoice by automatically charging and the latest charge fails, it sets `delinquent`` to `true``. If Stripe bills the invoice by sending it, and the invoice isn't paid by the due date, it also sets `delinquent`` to `true`.\n\nIf an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.",
+            "description": "Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`.\n\nIf an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.\n\nIf you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`.",
             "nullable": true,
             "type": "boolean"
           },

openapi/spec3.sdk.yaml

@@ -8052,15 +8052,22 @@ components:
               - $ref: '#/components/schemas/payment_source'
         delinquent:
           description: >-
-            If Stripe bills the customer's latest invoice by automatically
-            charging and the latest charge fails, it sets `delinquent`` to
-            `true``. If Stripe bills the invoice by sending it, and the invoice
-            isn't paid by the due date, it also sets `delinquent`` to `true`.
+            Tracks the most recent state change on any invoice belonging to the
+            customer. Paying an invoice or marking it uncollectible via the API
+            will set this field to false. An automatic payment failure or
+            passing the `invoice.due_date` will set this field to `true`.
 
 
             If an invoice becomes uncollectible by
             [dunning](https://stripe.com/docs/billing/automatic-collection),
             `delinquent` doesn't reset to `false`.
+
+
+            If you care whether the customer has paid their most recent
+            subscription invoice, use `subscription.status` instead. Paying or
+            marking uncollectible any customer invoice regardless of whether it
+            is the latest invoice for a subscription will always set this field
+            to `false`.
           nullable: true
           type: boolean
         description:

openapi/spec3.yaml

@@ -6493,15 +6493,22 @@ components:
           x-stripeBypassValidation: true
         delinquent:
           description: >-
-            If Stripe bills the customer's latest invoice by automatically
-            charging and the latest charge fails, it sets `delinquent`` to
-            `true``. If Stripe bills the invoice by sending it, and the invoice
-            isn't paid by the due date, it also sets `delinquent`` to `true`.
+            Tracks the most recent state change on any invoice belonging to the
+            customer. Paying an invoice or marking it uncollectible via the API
+            will set this field to false. An automatic payment failure or
+            passing the `invoice.due_date` will set this field to `true`.
 
 
             If an invoice becomes uncollectible by
             [dunning](https://stripe.com/docs/billing/automatic-collection),
             `delinquent` doesn't reset to `false`.
+
+
+            If you care whether the customer has paid their most recent
+            subscription invoice, use `subscription.status` instead. Paying or
+            marking uncollectible any customer invoice regardless of whether it
+            is the latest invoice for a subscription will always set this field
+            to `false`.
           nullable: true
           type: boolean
         description: