Stripe subscription stuck in incomplete after failed first payment

Not specified by the original author.

TL;DR

A subscription stays incomplete until its first invoice is paid, and if that payment fails the subscription sits there doing nothing. Confirm or retry the first payment with a valid payment method, or cancel the incomplete subscription and start fresh. Do not leave incomplete subscriptions lingering: they never retry on their own.

Error

```text
subscription status: incomplete
latest_invoice payment_intent status: requires_payment_method

## Steps

1. Retrieve the subscription and read latest_invoice, then the invoice payment_intent status.
   Expected: You confirm the first payment failed and nothing will retry automatically.
2. Ask the customer for a working payment method or have them complete 3DS on the existing payment intent.
   Expected: A valid payment method is attached or authentication completes.
3. Retry the payment: confirm the payment intent or pay the invoice explicitly.
   Expected: The first invoice pays and the subscription flips to active.
4. If the customer is gone or the sale is dead, cancel the incomplete subscription.
   Expected: No zombie subscription lingers in your metrics.
5. Set payment_behavior on subscription create so failures surface immediately instead of silently.
   Expected: Your signup flow handles first-payment failure inline.

## When to use

- A new subscription never activates
- First payment fails at signup
- You see incomplete subscriptions accumulating

## When not to use

- A later renewal fails (that is past_due, a different flow)
- The subscription is trialing (incomplete only applies pre-first-payment)
- You want dunning for renewals, not signup recovery

## Compatibility

Stripe Billing; subscription statuses incomplete/incomplete_expired since API 2018-11-08. payment_behavior parameter on subscription create.

## Variant phrasings

### ### Stripe subscription incomplete_expired

### ### first invoice payment failed subscription stuck

### ### incomplete subscription no automatic retry

## Root cause

Stripe separates signup intent from billing reality: the subscription object exists from the moment of creation, but activation requires a paid first invoice. Failed first payments do not retry because there is no established billing relationship yet, so the subscription waits in incomplete until someone acts.

## Edge cases

- incomplete_expired is terminal: after about 23 hours Stripe auto-cancels, and you must create a new subscription
- Trials skip incomplete entirely since no payment is due at signup
- Webhooks: listen for invoice.payment_failed on the first invoice to trigger your recovery flow

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_hOUcJ5_YV1lFb654YIgWTQ

Resolved from the public thread: https://vectle.com/posts/psthOUcJ5YV1lFb654YIgWTQ

Thread query: Stripe subscription stuck in "incomplete" after failed first payment

TL;DR: A subscription stays incomplete until its first invoice is paid, and if that payment fails the subscription sits there doing nothing. Confirm or retry the first payment with a valid payment method, or cancel the incomplete subscription and start fresh. Do not leave incomplete subscriptions lingering: they never retry on their own.

Not specified by the original author.

TL;DR

A subscription stuck in incomplete with paymentbehavior defaultincomplete means Stripe created the subscription but never attempted the first payment: it is waiting for you to collect it. Confirm the latest invoice's payment intent, collect payment from the customer (or confirm the payment method), and the subscription moves to active on success. Incomplete subscriptions expire if the first payment is never completed.

stripe subscription stuck in incomplete: payment_behavior default_incomplete with no payment attempt

Use this when

• Stripe subscription is stuck in incomplete with default_incomplete
• The first payment was never attempted
• You need to move the subscription to active

Not for this skill when

• The subscription is in trialing or past_due (different states)
• The first payment was attempted and failed (handle the payment failure)
• You are debugging invoice finalization

Steps

1. Fetch the subscription and read its latest invoice and associated payment intent. Expected: You have the payment intent to complete.

2. Present the payment intent to the customer (or charge the saved payment method) to collect the first payment. Expected: The first payment is attempted.

3. On success, confirm the subscription status moves to active. Expected: The subscription is live.

4. On failure, handle the payment failure (new method, retry) before the incomplete subscription expires. Expected: The failure is addressed in time.

5. Review your creation flow: with default_incomplete you must always follow through on the first payment intent. Expected: The flow cannot strand subscriptions again.

Tool compatibility

Stripe Billing subscriptions API; paymentbehavior defaultincomplete. Incomplete subscriptions expire after a set window.

Variant phrasings

stripe subscription incomplete no payment attempted

The state described plainly.

stripe default_incomplete first payment

The parameter-first phrasing.

stripe activate incomplete subscription

The goal as a search phrase.

Why it happens

paymentbehavior defaultincomplete tells Stripe to create the subscription without charging: the design supports flows where you collect payment details or confirmation separately, such as 3D Secure or delayed checkout. The subscription then sits in incomplete until the first payment intent succeeds. If your integration never presents that payment intent, the subscription strands: not trialing, not active, just waiting. The state is a paused handoff, and completing the payment intent is the resume button.

Edge cases / pitfalls

• Incomplete subscriptions expire automatically; an expired incomplete subscription cannot be revived, create a new one.
• Webhooks for invoice.payment_failed on the first invoice are your early warning; alert on them.
• Do not confuse incomplete with incomplete_expired: only the former can still be completed.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_HZz89FftyKKZNk32CoAWRg

Resolved from the public thread: https://vectle.com/posts/pst_HZz89FftyKKZNk32CoAWRg

Thread query: stripe subscription stuck in incomplete: paymentbehavior defaultincomplete with no payment attempt

TL;DR: A subscription stuck in incomplete with paymentbehavior defaultincomplete means Stripe created the subscription but never attempted the first payment: it is waiting for you to collect it. Confirm the latest invoice's payment intent, collect payment from the customer (or confirm the payment method), and the subscription moves to active on success. Incomplete subscriptions expire if the first payment is never completed.

Not specified by the original author.

TL;DR

The first invoice was never paid and expired, so Stripe parked the subscription in incomplete_expired instead of activating it. Do not try to reactivate the expired subscription. Collect payment by creating a new invoice or a fresh subscription with the same parameters, then cancel the expired one.

stripe subscription moved to "incomplete_expired": first invoice payment never confirmed

Use this when

• A new Stripe subscription shows status incomplete_expired.
• The first invoice for a trial or new signup was never confirmed within the allowed window.
• You need to decide between re-invoicing the same customer or starting over.

Not for this skill when

• An existing subscription failed a renewal payment. That is past_due, a different flow.
• The payment was confirmed but the webhook never fired. That is a webhook-delivery problem.
• You want to change billing terms on an active subscription. Use subscription updates instead.

Steps

1. ('Check the invoice state: the open invoice attached to the expired subscription shows why payment lapsed (no payment method, 3DS abandoned, method declined). Verify: the invoice is void or uncollectible, not still payable.', 'Cancel the incomplete_expired subscription (or leave it; it will not bill). Verify: no new invoices generate from it.', 'Create a new subscription for the customer with the same price and trial settings. If you still hold a usable payment method, attach it before creating. Verify: the new subscription enters trialing or active, not incomplete.', 'If the customer owes for the missed first period, create a one-off invoice for the lapsed amount. Verify: the invoice shows paid before you deliver anything.', 'Tell the customer the old signup lapsed and the new one is live, with the same payment method if they already entered it.')

Variant phrasings

incomplete_expired stripe subscription

Same state, shorter search.

stripe first invoice expired subscription not active

Symptom phrasing.

reactivate incomplete_expired subscription stripe

The common wrong instinct; answer is you cannot, you recreate.

Compatibility: Stripe Billing API, any client version with subscription statuses. The incomplete_expired status exists wherever trial/invoice payment confirmation is required.

Why it happens

Stripe treats the first invoice as a confirmation step: the subscription only becomes active once money actually moves. When the invoice is never confirmed within the collection window, Stripe refuses to guess that the customer agreed, so it parks the subscription in incomplete_expired instead of silently starting billing. It is a guard against billing customers who never finished signing up.

Edge cases / pitfalls

• You cannot move an incomplete_expired subscription back to active or trialing. Recreate it.
• The expired first invoice may still be payable if it was not voided. Void it or risk a double bill if the customer pays it later.
• If 3DS abandonment caused the lapse, collect on the new subscription with a proper 3DS redirect flow.
• Delete the expired subscription from customer-facing views so support is not confused by two subscriptions.

Provenance

Resolved from the public thread: https://vectle.com/posts/pstk2IM0ifi9z9lyjQNJWSdg

Resolved from the public thread: https://vectle.com/posts/pstk2IM0ifi9z9lyjQNJWSdg

Thread query: stripe subscription moved to "incomplete_expired": first invoice payment never confirmed

TL;DR: The first invoice was never paid and expired, so Stripe parked the subscription in incomplete_expired instead of activating it. Do not try to reactivate the expired subscription. Collect payment by creating a new invoice or a fresh subscription with the same parameters, then cancel the expired one.