Changelog
Keep track of changes and upgrades to the Stripe API.
2024-11-20.acacia
Support for new tax types
Adds support for Service Tax type | Tax | |
Adds tax ID support for Liechtenstein VAT | Tax |
Issuing enhancements
Adds support for merchant amount and currency for test mode authorizations | Issuing | |
Adds support for issuing fraud challenges | Issuing |
Additional payment flexibility
Adds support for enabling Adaptive Pricing per Checkout Session | Checkout | |
Customize the submit button recurring Payment Links and Checkout Sessions | Checkout+ 1 more | |
Adds support for advanced card features on Checkout Sessions | Checkout | |
Allows Link card-only integrations to accept non-card payments under Link card brand | Payments | |
Adds additional beneficiary information for bank transfer payments | Payments |
Payment method enhancements
Adds network decline code field for Swish and BLIK refunds | Payments | |
Adds support for SEPA Direct Debit and Bacs Direct Debit mandate reference prefixes in Checkout Sessions | Checkout | |
Specifying an originating payment method for Inbound Transfers is now optional | Treasury | |
Use configurable capture methods and set up future usage for South Korean payment methods | Checkout |
Additional updates
Trace payouts with a unique identifier | Payouts | |
Converts properties on the Account object from a String to an enum | Connect | |
Adds indicator for connected accounts that must log in before using embedded components | Connect | |
Adds support for authorizers to Person API | Connect |
2024-10-28.acacia
Billing credit grants
Adds Credit Grant APIs and resources | Billing+ 1 more | |
Adds support for pre-tax credit amount information to invoices | Billing+ 1 more | |
Adds support for pre-tax credit amount information to credit notes | Billing+ 1 more |
New payment methods
Adds support for new South Korean payment methods | Billing+ 5 more | |
Adds support for Alma in France | Checkout+ 3 more |
Event destinations and event types
Adds Event Destinations v2 API endpoint | ||
Adds event type for updated receipt data in Issuing transactions | Issuing |
Payment method enhancements
Adds a metadata field to the Vault and Forward API | Payments | |
Adds Polish PLN currency support to Terminal tipping configuration | Terminal | |
Supports domain registration for Amazon Pay | Elements |
Additional tax registration options
Adds support for new countries to the Tax Registration API | Tax | |
Adds support for tax ID types in several new countries | Tax | |
Adds support for collecting retail delivery fees | Tax | |
Adds option to automatically validate customer tax location during an update | Tax |
Additional updates
Adds support for disabling Stripe user authentication for certain embedded components | Connect | |
Adds a test helper that updates the shipping status for physical cards | Issuing | |
Adds created, updated, and failed events for all refund types | Payments | |
Adds pricing groups to the Accounts API | Connect+ 1 more | |
Adds scheduled subscription downgrades in the customer portal | Billing | |
Makes business profile optional for customer portal configuration | Billing | |
Uses Visa’s Compelling Evidence 3.0 to respond to qualifying disputes | ||
Adds support for scheduling invoice finalization | Invoicing |
2024-09-30.acacia
Breaking changes
Add alerts, monitoring, and reporting to usage-based billing
Adds contextual filters to billing alerts | Billing | |
Adds an Alerts API for usage-based billing | Billing | |
Adds an event for triggered billing alerts | Billing | |
Adds support for listening to triggered billing alerts | Billing | |
Adds billing alert resources and endpoints | Billing | |
Adds support for subscriptions and subscription items to billing alerts | Billing+ 1 more | |
Adds Meter Event v2 API endpoints | Billing |
Enhancements for Terminal readers and integrations
Updates consent modeling for saving cards with Terminal | Terminal | |
Adds support for configuring the reboot time setting | Terminal | |
Adds the Stripe S700 reader as a valid device type | Terminal | |
Adds details about offline collection on card_ PaymentMethod objects | Terminal |
Payment method enhancements
Adds option to retrieve CVC tokens on Confirmation Tokens | Elements | |
Adds customer ID to payment method preview on a confirmation token | Elements | |
Adds support for identifying the unique payer for the BLIK payment method | Payments | |
Adds support for Affirm transaction IDs | Payments | |
Adds support for in-person payment methods, including Interac cards | Terminal | |
Displays authorization_ for Charges | Payments | |
Adds wallet details for card_ Charges and Payment Methods | Terminal | |
Adds country field for Charges that use Klarna | Payments | |
Displays Amazon Pay dispute type on Disputes | Payments |
Add support for new payment methods
Adds support for three new payment methods: Multibanco, Twint, and Zip | Payment Links | |
Adds support for using the Multibanco payment method with billing | Billing | |
Adds Twint to the PaymentMethodConfiguration API | Payments | |
Adds Girocard as a PaymentMethod brand and network | Payments |
Add tax IDs for Switzerland and Croatia, and optional tax ID requirement
Adds Switzerland UID as a supported customer tax ID | Invoicing+ 1 more | |
Adds Croatian Personal Identification Number to supported Tax IDs | Billing+ 2 more | |
Adds support for requiring a customer tax ID on Checkout and Payment Links | Checkout+ 1 more |
Add filtering support for Financial Connections
Adds support for filtering by account subcategories on Financial Connections | Financial Connections | |
Expands filtering support for Financial Connections Sessions | Financial Connections |
New error codes for more robust testing
Adds error code for exceeded transaction limits | Invoicing+ 1 more | |
Adds new error code for invalid mandate prefixes to Bacs Direct Debit and SEPA Direct Debit payments | Payments |
Add new Invoice Rendering Template resource
Adds Invoice Rendering Templates for Invoices | Invoicing | |
Adds retrieve and archive methods for Invoice Rendering Templates | Invoicing | |
Adds support for templates to Invoices and Customers | Invoicing | |
Adds version support for Invoice Rendering Templates | Invoicing |
Improve address validation and dispute and regulatory management for Issuing
Updates the default value for shipping address validation | Issuing | |
Adds address validation for physical cards | Issuing | |
Adds a new webhook event for when funds are deducted as part of a dispute | Issuing |
Streamline invoice processing
Adds support for bulk invoice line item operations | Invoicing | |
Adds webhook events for when an invoice is due or overdue | Billing | |
Adds option to automatically finalize invoices | Invoicing |
Tax enhancements
Adds support for posting time on tax transaction creation | Tax | |
Adds support for tax settings and registrations for Embedded Components | Connect+ 1 more | |
Adds new method to retrieve a Tax Calculation | Tax | |
Adds support for specifying US state sales tax elections while creating tax registrations | Tax |
Additional updates
Adds risk verification details for connected accounts | Connect | |
Adds support for email types to Credit Notes | Invoicing | |
Adds support for the Payment Element on a Customer Session | Elements | |
Adds support for identifying the case type for card disputes | Payments | |
Adds a method to update the metadata for Checkout Sessions | Checkout | |
Adds parameter to link Verification Sessions to Customers | Identity | |
Displays CHIPS tracking details for outbound wire payments and transfers | Treasury | |
Adds additional reasonable defaulting to the Account Link API v1 | Connect | |
Makes LineItem. optional | Checkout | |
Adds target_ for advancing test_ objects | Billing | |
Makes status details for Test Clock test helpers required | Billing | |
Adds a new enum value representing a ReceivedDebit failure due to an international transaction | Treasury | |
Makes it optional to update the products and prices of a subscription | Billing | |
Add support for custom_ during product creation | Checkout+ 1 more | |
Adds support for retrieving thin events | Billing |
2024
2024-06-20
Breaking changes
Renames a fuel attribute of the Authorization object | ||
Renames a purchase_ attribute of the Transaction object | ||
Removes undocumented fuel fields | ||
Removes undocumented fleet fields | ||
Adds enum values for fuel units | ||
Deprecates alphanumeric_ for Issuing Authorization | ||
Adds enum values for disabled reasons | ||
Deprecates the bank_ capability type in favor of newer capability types | ||
Adds new enum values for request history reasons |
2024-04-10
Breaking changes
Makes automatic sync the default capture method for PaymentIntents when not specified | ||
Renames the rendering_ attribute for invoices to rendering | ||
Renames the features attribute of the Product object |
2023
2023-10-16
Breaking changes
Adds new account requirement error codes to the Accounts API | ||
Auto-populates the statement descriptor and prefix in the Accounts API |
2023-08-16
Breaking changes
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 |
2022
2022-11-15
Breaking changes
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 |
2022-08-01
Breaking changes
Removes the include_ value when creating invoices | ||
Default customer creation in Checkout Session payment mode changed to if_ | ||
Deferred PaymentIntent creation in Checkout Session payment mode | ||
Removes the setup_ 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_ as a possible cancellation reason for issued cards | ||
Removes the default_ attribute from the Customer object |
2020
2020-08-27
Breaking changes
Removes the tax_ attribute | ||
Renames phases attributes in subscription schedules | ||
Renames event type that triggers on automatic updates | ||
Removes the display_ 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_ parameters |
2020-03-02
Breaking changes
Invoices can now be numbered sequentially across your account |
2019
2019-12-03
Breaking changes
Standardizes invoice line item IDs | ||
New requirement for out_ when creating post-payment credit notes | ||
Customer balances are now returned when voiding invoices | ||
Removes deprecated tax information fields from the Customer object |
2019-11-05
Breaking changes
Adds requirement for requested_ on custom account creation | ||
Nested subscription schedule settings under default_ |
2019-10-17
Breaking changes
Renames and updates subscription schedule renewal properties | ||
Replaces the subscription start field with start_ | ||
Renames billing to collection_ on invoices, subscriptions, and subscription schedules | ||
The due_ property is always null on auto-billed invoices | ||
Renames account_ to balance on Customer object |
2019-10-08
Breaking changes
Renames a Person object relationship attribute |
2019-09-09
Breaking changes
Accounts in many countries now require specifying capabilities at creation time | ||
Adds new details_ values to person document verification |
2019-08-14
Breaking changes
Renames the platform_ capability for accounts to card_ , requiring the manual specification of the added transfers capability | ||
Configuring a person as an account opener no longer automatically sets them as an executive |
2019-05-16
Breaking changes
Bank pull payments no longer expose internal system refunds on failure |
2019-03-14
Breaking changes
Renames application_ on invoices to application_ | ||
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 |
2019-02-19
Breaking changes
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_ 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_ for an account’s legal entity to business_ |
2019-02-11
Breaking changes
Renames several statuses for PaymentIntents | ||
Renames the save_ field for sources to save_ | ||
Renames the allowed_ field for sources to payment_ | ||
Renames the next_ field for Payment Intents to next_ | ||
Renames the authorize_ field for Payment Intents to redirect_ |
2018
2018-11-08
Breaking changes
Invoices now specify their automatic collection behavior using the auto_ 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_ | ||
Includes several changes for users of the Payment Intents API private beta |
2018-10-31
Breaking changes
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_ of the first invoice of a subscription is now subscription_ |
2018-09-24
Breaking changes
Renames the FileUpload object to Files , which now require secret keys to download files |
2018-09-06
Breaking changes
SKU values no longer need to be unique |
2018-08-23
Breaking changes
A subscription’s ending period can no longer be configured while canceling it | ||
Customers now provide a tax_ object with their tax ID details | ||
Renames the amount field for plan tiers to unit_ |
2018-07-27
Breaking changes
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_ | ||
Stripe now validates email addresses when creating or updating customers |
2018-05-21
Breaking changes
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 |
2018-02-28
Breaking changes
Updating a canceled subscription on a future date no longer resets its status |
2018-02-06
Breaking changes
Sources now provide a recommended value when the issuer advises using 3D Secure |
2018-02-05
Breaking changes
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 |
2018-01-23
Breaking changes
Connect platforms can identify reused card or bank accounts across connected accounts as they now will share the same fingerprint |
2017
2017-12-14
Breaking changes
Invoice line items now must always set a description | ||
Invoice payment failures now return a card_ when a charge is declined |
2017-08-15
Breaking changes
Sources can now specify that an authentication redirect isn’t required |
2017-06-05
Breaking changes
Accounts can now specify why an account isn’t enabled with the new reason under_ |
2017-05-25
Breaking changes
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_ field now render the complete affected sub-array | ||
Accounts must now specify one of three types (Standard, Express, or Custom) |
2017-04-06
Breaking changes
Transfers are now split into payouts and transfers |
2017-02-14
Breaking changes
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 |
2017-01-27
Breaking changes
Balance transactions no longer include the sourced_ field |
2016
2016-10-19
Breaking changes
Using insufficient permissions to make API requests now throws an HTTP 403 error |
2016-07-06
Breaking changes
Filter lists of subscriptions for canceled subscriptions |
2016-06-15
Breaking changes
Deactivating a product no longer automatically deactivates its SKUs |
2016-03-07
Breaking changes
Supported currencies are defined on the country spec for an account’s country |
2016-02-29
Breaking changes
Creating or updating an account now validates the postal code for its legal entity |
2016-02-23
Breaking changes
Orders that are paid or fulfilled, and then become canceled or returned, now automatically refund associated charges |
2016-02-22
Breaking changes
You can no longer add more than 250 invoice items to an invoice |
2016-02-19
Breaking changes
Renames the name field on Bank Accounts to account_ |
2016-02-03
Breaking changes
Accounts now only show country-specific subfields for the legal_ field |
2015
2015-10-16
Breaking changes
Creating or updating customers must now include a plan if a tax percentage is specified |
2015-10-12
Breaking changes
Using invalid parameters to create cards or bank accounts for tokens, sources, or external bank accounts now throws an HTTP 400 error |
2015-10-01
Breaking changes
Bank account information renamed to external accounts on user profiles | ||
Accounts now include an external_ field |
2015-09-23
Breaking changes
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 |
2015-09-08
Breaking changes
Rate-limited requests now return an HTTP 429 error, no longer including the rate_ field |
2015-09-03
Breaking changes
Requests that reuse idempotency tokens but alter request parameters now throw an error |
2015-08-19
Breaking changes
Balance transactions with refunds or disputes now specify the corresponding ID in the source field |
2015-08-07
Breaking changes
Stripe now ensures the tos_ field on accounts is a valid timestamp |
2015-07-28
Breaking changes
Transfers that are immediately processed now trigger the balance. event |
2015-07-13
Breaking changes
Accounts now include the verification[disabled_ field to describe why theycan’t make transfers or charges |
2015-07-07
Breaking changes
Transfers submitted to the bank that haven’t arrived now provide an in_ status |
2015-06-15
Breaking changes
Accounts on manual payout schedules now throw a new error |
2015-04-07
Breaking changes
Updates how ending periods are calculated on prorated invoice line items | ||
Changes the sorting order of lines for invoices |
2015-03-24
Breaking changes
By default, coupons no longer apply to invoice items with negative amounts |
2015-02-18
Breaking changes
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 |
2015-02-16
Breaking changes
Renames the transfer. event type to transfer. |
2015-02-10
Breaking changes
Dispute statuses now include the warning_ value | ||
Transfers now require a sufficient account balance in test mode to better simulate live mode |
2015-01-26
Breaking changes
Events with the previous_ 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_ field |
2015-01-11
Breaking changes
File uploads describe their file type with the simpler type field and format |
2014
2014-12-22
Breaking changes
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 |
2014-12-17
Breaking changes
Introduces the statement_ 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 |
2014-12-08
Breaking changes
Disputes now include an evidence_ object for evidence documentation |
2014-11-20
Breaking changes
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 |
2014-11-05
Breaking changes
Account activation status terms updated for payments and transfers |
2014-10-07
Breaking changes
You can no longer retrieve tokens with publishable keys | ||
Creating a Card or Bank Account with a publishable key omits fingerprints in API responses |
2014-09-08
Breaking changes
Bank Accounts now include a status enum that replace multiple fields |
2014-08-20
Breaking changes
Disputes now provide several new statuses | ||
Disputes now include multiple balance transactions |
2014-08-04
Breaking changes
You can now retrieve balance histories rather than relying on Transfer fields |
2014-07-26
Breaking changes
Application fees now include a sublist of refunds through the refunds field |
2014-07-22
Breaking changes
Invoice line items now include subscription plans and quantities |
2014-06-17
Breaking changes
Invoices now include a sublist of refunds through the refunds field |
2014-06-13
Breaking changes
Renames the type field on cards to brand |
2014-05-19
Breaking changes
Replaces the account field on transfers |
2014-03-28
Breaking changes
Lists no longer include the count field |
2014-03-13
Breaking changes
Renames the statement descriptor field |
2014-01-31
Breaking changes
Customers now support multiple subscriptions | ||
Trial end dates are no longer computed for canceled subscriptions |
2013
2013-12-03
Breaking changes
Application fees now provide an expandable account field to obtain user details | ||
Application fee refunds are now proportional to the charged amount |
2013-10-29
Breaking changes
Coupons only apply to an invoice’s total balance, no longer applying to zero-cost invoices |
2013-08-13
Breaking changes
Fee details have moved from charges to their corresponding balance transactions | ||
Fee details have moved from transfers to their corresponding balance transactions |
2013-08-12
Breaking changes
Lets the description and email fields be null on several objects |
2013-07-05
Breaking changes
Customers now include a cards sublist and default_ field |
2013-02-13
Breaking changes
Disputes on charges are now tracked through the stripe_ field and included in the fee total |
2013-02-11
Breaking changes
Failed invoice payments now return an HTTP error |
2012
2012-11-07
Breaking changes
Renames the disputed field for Charges to dispute |
2012-10-26
Breaking changes
Invoices now include a sublist of invoice line items |
2012-09-24
Breaking changes
Discounts no longer include an extraneous id field |
2012-07-09
Breaking changes
Customers no longer include the uncaptured field |
2012-06-18
Breaking changes
Tokens no longer include the amount and currency properties |
2012-03-25
Breaking changes
Customers no longer include a next_ field |
2012-02-23
Breaking changes
Fields with null values are now included in API responses |
2011
2011-09-15
Breaking changes
Cards validate differently when creating tokens |
2011-08-01
Breaking changes
Lists now provide a total count of items and a data field |
2011-06-28
Breaking changes
Plans no longer include the identifier field |
2011-06-21
Breaking changes
Errors now produce exceptions for unrecognized API parameters |