![]() The subscription moves from free to paid, or paid to free.The billing interval is changed (for example, from monthly to yearly).Switching prices does not normally change the billing date or generate an immediate charge unless: We also prorate when you make quantity changes. Similarly, a downgrade generates a credit that is applied to the next invoice. If on May 15 they switch to a 200 USD price, then on June 1 they’ll be billed 250 USD (200 USD for a renewal of her subscription, plus a 50 USD prorating adjustment for half of the previous month’s 100 USD difference). For example, if a customer signs up on May 1 for a 100 USD price, they’ll be billed 100 USD immediately. To preview how the proration is calculated, use the upcoming invoice endpoint.īy default, we prorate subscription changes. ![]() When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes. Updates an existing subscription to match the specified parameters. Subscriptions with collection_method=send_invoice are automatically activated regardless of the first invoice status. ![]() Pending_if_incomplete is only used with updates and cannot be passed when creating a subscription. This was the default behavior for API versions prior to. ![]() For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not create a subscription and returns an error instead. Use error_if_incomplete if you want Stripe to return an HTTP 402 status code if a subscription’s first invoice cannot be paid. If the payment intent is not confirmed within 23 hours subscriptions transition to status=incomplete_expired, which is a terminal state. Such as failed payments, SCA regulation, or collecting a mandate for a bank debit payment method. This allows simpler management of scenarios where additional user actions are needed to pay a subscription’s invoice. Subscriptions transition to status=active when successfully confirming the payment intent on the first invoice. Use default_incomplete to create Subscriptions with status=incomplete when the first invoice requires payment, otherwise start as active. See the SCA Migration Guide for Billing to learn more. For example, SCA regulation may require 3DS authentication to complete payment. Creating subscriptions with this status allows you to manage scenarios where additional user actions are needed to pay a subscription’s invoice. Use allow_incomplete to create subscriptions with status=incomplete if the first invoice cannot be paid. Only applies to subscriptions with collection_method=charge_automatically. After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices. Note that when a subscription has a status of unpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). If subscription collection_method=send_invoice it becomes past_due when its invoice is not paid by the due date, and canceled or unpaid if it is still not paid by an additional deadline after that. Once Stripe has exhausted all payment retry attempts, the subscription will become canceled or unpaid (depending on your subscriptions settings). If subscription collection_method=charge_automatically, it becomes past_due when payment is required but cannot be paid (due to failed payment or awaiting additional user actions). ![]() This is a terminal state, the open invoice will be voided and no further invoices will be generated.Ī subscription that is currently in a trial period is trialing and moves to active when the trial period is over. If the first invoice is not paid within 23 hours, the subscription transitions to incomplete_expired. Once the first invoice is paid, the subscription moves into an active state. A subscription in this state can only have metadata and default_source updated. Possible values are incomplete, incomplete_expired, trialing, active, past_due, canceled, or unpaid.įor collection_method=charge_automatically a subscription moves into incomplete if the initial payment attempt fails. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |