Changelog

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 and can’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