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 Authorisation

Adds enum values for disabled reasons

Deprecates the bank_transfer_payments capability type in favour 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

Standardises 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 finalised alongside other status transitions

Changes statement descriptor behaviours 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 behaviour 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 cancelling 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 cancelled 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 cancelled 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 cancelled 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