Changelog

Adds contextual filters to billing alerts

Adds an Alerts API for usage-based billing

Adds an event for triggered billing alerts

Adds support for listening to triggered billing alerts

Adds billing alert resources and endpoints

Adds support for subscriptions and subscription items to billing alerts

Adds Meter Event v2 API endpoints

Updates consent modeling for saving cards with Terminal

Adds support for configuring the reboot time setting

Adds the Stripe S700 reader as a valid device type

Adds details about offline collection on card_present PaymentMethod objects

Adds option to retrieve CVC tokens on Confirmation Tokens

Adds customer ID to payment method preview on a confirmation token

Adds support for identifying the unique payer for the BLIK payment method

Adds support for Affirm transaction IDs

Adds support for in-person payment methods, including Interac cards

Displays authorization_code for Charges

Adds wallet details for card_present Charges and Payment Methods

Adds country field for Charges that use Klarna

Displays Amazon Pay dispute type on Disputes

Adds support for three new payment methods: Multibanco, Twint, and Zip

Adds support for using the Multibanco payment method with billing

Adds Twint to the PaymentMethodConfiguration API

Adds Girocard as a PaymentMethod brand and network

Adds Switzerland UID as a supported customer tax ID

Adds Croatian Personal Identification Number to supported Tax IDs

Adds support for requiring a customer tax ID on Checkout and Payment Links

Adds support for filtering by account subcategories on Financial Connections

Expands filtering support for Financial Connections Sessions

Adds error code for exceeded transaction limits

Adds new error code for invalid mandate prefixes to Bacs Direct Debit and SEPA Direct Debit payments

Adds Invoice Rendering Templates for Invoices

Adds retrieve and archive methods for Invoice Rendering Templates

Adds support for templates to Invoices and Customers

Adds version support for Invoice Rendering Templates

Updates the default value for shipping address validation

Adds address validation for physical cards

Adds a new webhook event for when funds are deducted as part of a dispute

Adds support for bulk invoice line item operations

Adds webhook events for when an invoice is due or overdue

Adds option to automatically finalize invoices

Adds support for posting time on tax transaction creation

Adds support for tax settings and registrations for Embedded Components

Adds new method to retrieve a Tax Calculation

Adds support for specifying US state sales tax elections while creating tax registrations

Adds risk verification details for connected accounts

Adds support for email types to Credit Notes

Adds support for the Payment Element on a Customer Session

Adds support for identifying the case type for card disputes

Adds a method to update the metadata for Checkout Sessions

Adds parameter to link Verification Sessions to Customers

Displays CHIPS tracking details for outbound wire payments and transfers

Adds additional reasonable defaulting to the Account Link API v1

Makes LineItem.description optional

Adds target_frozen_time for advancing test_helpers.test_clock objects

Makes status details for Test Clock test helpers required

Adds a new enum value representing a ReceivedDebit failure due to an international transaction

Makes it optional to update the products and prices of a subscription

Add support for custom_unit_amount during product creation

Renames a fuel attribute of the Authorization object

Renames a purchase_details attribute of the Transaction object

Removes undocumented fuel fields

Removes undocumented fleet fields

Adds enum values for fuel units

Deprecates alphanumeric_id for Issuing Authorization

Adds enum values for disabled reasons

Deprecates the bank_transfer_payments capability type in favor of newer capability types

Adds new enum values for request history reasons

Makes automatic sync the default capture method for PaymentIntents when not specified

Renames the rendering_options attribute for invoices to rendering

Renames the features attribute of the Product object

Adds new account requirement error codes to the Accounts API

Auto-populates the statement descriptor and prefix in the Accounts API

Enables automatic payment methods by default for PaymentIntents and SetupIntents

One-time payments in Checkout Sessions support no-cost orders

Platform-scope rendering for select PaymentMethod fingerprints

Adds specific error codes for failed Klarna payments

Adds new director verification error codes to the Accounts API

The Charges object no longer auto-expands refunds by default

Removes the charges attribute from the PaymentIntent object

Adds new decline codes to the PaymentIntent and PaymentMethod APIs

Adds new decline codes to the SetupIntent API

Adds a new structure error code to the Accounts API

Removes the include_and_require value when creating invoices

Default customer creation in Checkout Session payment mode changed to if_required

Deferred PaymentIntent creation in Checkout Session payment mode

Removes the setup_intent property from Checkout Sessions in subscription mode

Replaces line item parameters from the Create Checkout Session endpoint

Removes the subscription data parameter from the Create Checkout Session endpoint

Removes the shipping rate parameter from Create Checkout Session endpoint

Updates Checkout Session shipping properties

Adds 3D Secure exemption status to card charges

New error code for invalid terms of service acceptance in Accounts API

New endpoints for managing a physical card’s shipping status in test mode

Adds design_rejected as a possible cancellation reason for issued cards

Removes the default_currency attribute from the Customer object

Removes the tax_percent attribute

Renames phases attributes in subscription schedules

Renames event type that triggers on automatic updates

Removes the display_items property from Checkout Sessions

Formats requirements for key persons associated with accounts

Adds new error codes to the Accounts, Persons, and Capabilities APIs

Updates to 3D Secure details in Charge object

Customer subscriptions are no longer auto-expanded by default

Plan tiers are no longer auto-expanded by default

Customer sources are no longer auto-expanded by default

Tax IDs are no longer auto-expanded on the Customer object

Deprecates subscription prorate and subscription_prorate parameters

Invoices can now be numbered sequentially across your account

Standardizes invoice line item IDs

New requirement for out_of_band_amount when creating post-payment credit notes

Customer balances are now returned when voiding invoices

Removes deprecated tax information fields from the Customer object

Adds requirement for requested_capabilities on custom account creation

Nested subscription schedule settings under default_settings

Renames and updates subscription schedule renewal properties

Replaces the subscription start field with start_date

Renames billing to collection_method on invoices, subscriptions, and subscription schedules

The due_date property is always null on auto-billed invoices

Renames account_balance to balance on Customer object

Renames a Person object relationship attribute

Accounts in many countries now require specifying capabilities at creation time

Adds new details_code values to person document verification

Renames the platform_payments capability for accounts to card_payments, requiring the manual specification of the added transfers capability

Configuring a person as an account opener no longer automatically sets them as an executive

Bank pull payments no longer expose internal system refunds on failure

Renames application_fee on invoices to application_fee_amount

Subscriptions are now successfully created even if the first payment fails

Invoices now provide timestamps for each state transition

Renames the date field for invoices to created

Invoices now specify when they’re finalized alongside other status transitions

Changes statement descriptor behaviors for card payments created with Charges

Several account fields have been refactored to better describe legal entity, verification status and requirements, and configurable settings

Several fields describing an account’s business details have moved to the business_profile subhash

Verification of accounts or persons now supports uploading both front and back sides

Accounts no longer provide a keys field. Platforms should use their own API key to authenticate as their connected accounts

Accounts in the US now require specifying capabilities at creation time

Renames the business_id_number for an account’s legal entity to business_registration_number

Renames several statuses for PaymentIntents

Renames the save_source_to_customer field for sources to save_payment_method

Renames the allowed_source_types field for sources to payment_method_types

Renames the next_source_action field for Payment Intents to next_action

Renames the authorize_with_url field for Payment Intents to redirect_to_url

Invoices now specify their automatic collection behavior using the auto_advance field

One-off Invoices no longer automatically collect payment by default

Replaces the forgiven field with a new uncollectible status for invoices

Renames an invoice error code to invoice_already_finalized

Includes several changes for users of the Payment Intents API private beta

Descriptions for customers now have a character limit

Product names now have a character limit

Descriptions for invoice line items now have a character limit

The billing_reason of the first invoice of a subscription is now subscription_create

Renames the FileUpload object to Files, which now require secret keys to download files

SKU values no longer need to be unique

A subscription’s ending period can no longer be configured while canceling it

Customers now provide a tax_info object with their tax ID details

Renames the amount field for plan tiers to unit_amount

Subscriptions no longer support modifying the source parameter directly

Ending a subscription trial now uses the timestamp of that API request

Coupons now use floats rather than integers to specify percent_off

Stripe now validates email addresses when creating or updating customers

Products no longer embed lists of SKUs

Invoice line items now have unique IDs andcan’t be used in place of a subscription

Coupons, SKUs, customers, products, and plans now limit the valid characters for IDs

Subscriptions now default to not defining their trial periods depending on a plan

Changing a subscription to a new plan with a trial now extends the trial period

Updating a canceled subscription on a future date no longer resets its status

Sources now provide a recommended value when the issuer advises using 3D Secure

Free plans with prorations now produce zero-dollar invoices

Subscriptions can now delay the first full invoice to a future date (and optionally include a free trial)

Plans now link to individual products, with several fields moving to the product resource

Products now require a type field, differentiating their use with order SKUs or subscriptions and plans

Connect platforms can identify reused card or bank accounts across connected accounts as they now will share the same fingerprint

Invoice line items now must always set a description

Invoice payment failures now return a card_error when a charge is declined

Sources can now specify that an authentication redirect isn’t required

Accounts can now specify why an account isn’t enabled with the new reason under_review

Events for Connect now specify the originating connected account using the account field

The request field of the Events object now specifies both the request ID and idempotency key

Events with the previous_attributes field now render the complete affected sub-array

Accounts must now specify one of three types (Standard, Express, or Custom)

Transfers are now split into payouts and transfers

Charges now specify the ID for the rule blocking a transaction, which can be expanded

Charges now specify the ID for the dispute associated with a transaction, which can be expanded

Balance transactions no longer include the sourced_transfers field

Using insufficient permissions to make API requests now throws an HTTP 403 error

Filter lists of subscriptions for canceled subscriptions

Deactivating a product no longer automatically deactivates its SKUs

Supported currencies are defined on the country spec for an account’s country

Creating or updating an account now validates the postal code for its legal entity

Orders that are paid or fulfilled, and then become canceled or returned, now automatically refund associated charges

You can no longer add more than 250 invoice items to an invoice

Renames the name field on Bank Accounts to account_holder_name

Accounts now only show country-specific subfields for the legal_entity field

Creating or updating customers must now include a plan if a tax percentage is specified

Using invalid parameters to create cards or bank accounts for tokens, sources, or external bank accounts now throws an HTTP 400 error

Bank account information renamed to external accounts on user profiles

Accounts now include an external_accounts field

The charge field now always reflects the latest charge on invoices

Invoices no longer include the payment property

Listing all charges now includes payments from all funding sources

Charges only support an offset for list pagination when filtering by source

Rate-limited requests now return an HTTP 429 error, no longer including the rate_limit field

Requests that reuse idempotency tokens but alter request parameters now throw an error

Balance transactions with refunds or disputes now specify the corresponding ID in the source field

Stripe now ensures the tos_acceptance[date] field on accounts is a valid timestamp

Transfers that are immediately processed now trigger the balance.available event

Accounts now include the verification[disabled_reason] field to describe why theycan’t make transfers or charges

Transfers submitted to the bank that haven’t arrived now provide an in_transit status

Accounts on manual payout schedules now throw a new error

Updates how ending periods are calculated on prorated invoice line items

Changes the sorting order of lines for invoices

By default, coupons no longer apply to invoice items with negative amounts

Charges that succeed now have a succeeded status

Charges now have a source field that accepts a source or card

Customers now have a source field that accepts a source or card, and updates related event types

Renames the transfer.canceled event type to transfer.reversed

Dispute statuses now include the warning_closed value

Transfers now require a sufficient account balance in test mode to better simulate live mode

Events with the previous_attributes field now only render the differences to objects across updates

Subscriptions now only report the timestamp for API or invoice payment failures for the canceled_at field

File uploads describe their file type with the simpler type field and format

Cards now use both the unchecked and unavailable values to describe address and CVC checks by issuing banks

Tokens with cards no longer include the customer field

Introduces the statement_description field and logic for how charges, invoices, plans, and transfers render statement descriptors

Creating accounts using the API requires the 2014-12-17 version or newer

Disputes now include an evidence_details object for evidence documentation

Disputes are now reported as won even if the charge is refunded

Invoice items now reflect the metadata for their associated subscription, rather than plan

Account activation status terms updated for payments and transfers

You can no longer retrieve tokens with publishable keys

Creating a Card or Bank Account with a publishable key omits fingerprints in API responses

Bank Accounts now include a status enum that replace multiple fields

Disputes now provide several new statuses

Disputes now include multiple balance transactions

You can now retrieve balance histories rather than relying on Transfer fields

Application fees now include a sublist of refunds through the refunds field

Invoice line items now include subscription plans and quantities

Invoices now include a sublist of refunds through the refunds field

Renames the type field on cards to brand

Replaces the account field on transfers

Lists no longer include the count field

Renames the statement descriptor field

Customers now support multiple subscriptions

Trial end dates are no longer computed for canceled subscriptions

Application fees now provide an expandable account field to obtain user details

Application fee refunds are now proportional to the charged amount

Coupons only apply to an invoice’s total balance, no longer applying to zero-cost invoices

Fee details have moved from charges to their corresponding balance transactions

Fee details have moved from transfers to their corresponding balance transactions

Lets the description and email fields be null on several objects

Customers now include a cards sublist and default_card field

Disputes on charges are now tracked through the stripe_fee field and included in the fee total

Failed invoice payments now return an HTTP error

Renames the disputed field for Charges to dispute

Invoices now include a sublist of invoice line items

Discounts no longer include an extraneous id field

Customers no longer include the uncaptured field

Tokens no longer include the amount and currency properties

Customers no longer include a next_recurring_charge field

Fields with null values are now included in API responses

Cards validate differently when creating tokens

Lists now provide a total count of items and a data field

Plans no longer include the identifier field

Errors now produce exceptions for unrecognized API parameters