Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
    Overview
    How subscriptions work
    Quickstart
    Use cases
    Build your integration
    Subscription features
      Subscription invoices
      Subscription schedules
      Subscription pricing
      Recurring pricing models
      Embed a pricing table
      Start subscriptions
      Set quantities
      Set billing cycles
      Backdate subscriptions
      Subscribe to multiple items
      Set trial periods
      Apply coupons
      Migrate subscriptions to Stripe
      How credit prorations are calculated
      Subscription payments
      Subscription payment methods
      Integrate with third-party payment processing
      Collection methods
      Strong Customer Authentication (SCA)
      Manage subscriptions
      Modify subscriptions
      Manage pending updates
    Entitlements
    Analytics
Invoicing
Usage-based billing
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Test your integration
Tax
Overview
Use Stripe tax
Manage compliance
Reporting
Overview
Select a report
Configure reports
Reports API
Reports for multiple accounts
Revenue recognition
Data
OverviewSchema
Custom reports
Data Pipeline
Data management
HomeRevenueSubscriptionsSubscription features

Billing collection methods

Configure your preferred method to collect on invoices and subscriptions.

You can set your preferred payment collection method when creating invoices and subscriptions using either the Dashboard or API.

Automatic charging versus manual payments

The collection method determines how Stripe processes the payment for both products. To collect payments for invoices and subscriptions, you can select from these methods:

  • Automatic charging
  • Manual payments

Note

Manual payment methods, such as wire transfers, have more rigorous tracking and reconciliation processes, which enterprise clients often require for high transaction volumes. Some payment methods, such as bank transfers, only support send_invoice and can’t be charged automatically.

Set a collection method for an invoice

To set a collection method for an invoice through the Invoicing API, use the collection_method attribute.

  • charge_automatically: Lets you automatically charge a customer’s default payment method to pay invoices.
  • send_invoice: Sends an invoice for manual payment. Unlike automatic charging which requires immediate payment, you can give the customer an adjustable payment window. You can use the Hosted Invoice Page and set up email notifications and reminders to facilitate payment.

Set a collection method for a subscription

To set a collection method for a subscription through the Subscriptions API, use the collection_method attribute. If you change the collection method for a subscription, only subsequently created subscription invoices use the new collection method.

  • charge_automatically: Tells Stripe to automatically charge your customer’s default payment method to pay the invoice generated for each subscription period.
  • send_invoice: Generates an invoice for each billing period, and requires manual payment. Unlike automatic charging which requires immediate payment, you can give the customer an adjustable payment window.

Automatic charge for free trials without payment method

You can create a free trial for subscription without collecting payment method from your customers and still set the collection_method attribute as charge_automatically. During the trial period, customers can add their payment details using the Customer portal. Once the trial ends, customer’s default payment method will be automatically charged. You can also configure your subscription to pause/cancel if the trial ends without a payment method. Learn more about creating free trials without collecting payment method.

Collection methods and failed payments

Depending on the collection method, failed payments generate different subscription statuses and invoice statuses.

Failed subscription payments

Creating a subscription with a payment_behavior of allow_incomplete, and the collection_method set to charge_automatically, immediately attempts payment and marks the subscription status as incomplete if the initial payment attempt doesn’t succeed.

Passing a payment_behavior of default_incomplete will always initialize subscriptions with an incomplete status if the first invoice requires payment. The resulting PaymentIntent must be confirmed in a separate request to attempt payment.

For both allow_incomplete and default_incomplete, the subscription becomes active after the first invoice is paid. Subscriptions that do not require payment upon creation (like those that are trialing) will immediately have a status of active. If the first invoice remains unpaid after 23 hours, the subscription is set to incomplete_expired. This status is final and irreversible, voiding the open invoice and preventing future invoices.

Failed incomplete subscriptions

When a subscription has a status of incomplete, you can only update attributes that won’t result in the creation of an invoice or invoice item, such as its metadata, save_default_payment_method, and description.

If a payment to renew the subscription fails when you’ve set it to charge automatically, the subscription transitions to past_due and Stripe may mark it as canceled or unpaid (depending on your subscriptions settings) after Stripe exhausts all payment retry attempts.

On the other hand, if the subscription’s collection_method is set to send_invoice, it becomes past_due when its invoice remains unpaid by the due date. If the customer still hasn’t paid the invoice after you extend the deadline, Stripe may mark the subscription as canceled or unpaid, which again depends on your subscription settings.

When a subscription has a status of unpaid, Stripe creates future invoices but leaves them as drafts. In this case, you have the option to resend the past due invoice and any created draft invoices to collect payment. Use this feature if you’re trying to collect payment for unpaid months (such as when you continue to provide the goods or services related to an unpaid subscription) or leave them closed and unpaid when you stop providing goods or services.

Failed invoicing payments

Invoices not associated with subscriptions that have their collection_method set to charge_automatically and auto-advancement disabled, remain open if an initial payment attempt fails. Because auto-advancement is disabled, Stripe doesn’t automatically close the invoices, retry them, or transition them to a different status. Learn more about failed payment notifications and managing invoices sent to customers.

If auto-advancement is enabled for the invoice, Stripe may automatically mark the invoice as uncollectible (depending on your invoice status settings) after Stripe exhausts all payment retry attempts.

When the collection method is set to send_invoice, the invoice requires manual payment. If the invoice remains unpaid past the due date, the status becomes past_due, indicating an overdue invoice. If you extend the payment deadline and the customer still hasn’t paid, you can leave the invoice as past_due or transition it to uncollectible or void.

Enterprise clients and wire transfers

For enterprise clients, manual payment methods, such as wire transfers, offer some advantages. These payment methods often involve more rigorous tracking and reconciliation processes compared to automated methods, which is crucial for enterprises that deal with high transaction volumes. By setting the collection_method to send_invoice, you can generate clear and well-documented invoices that enterprise clients can pay using wire transfers—a commonly preferred payment method for this type of client.

See also

  • Automatic collection
  • Automatic charging
  • Subscription invoices
  • Status transitions and finalization
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc