Changelog
Acacia2024Learn what's changing in Acacia | ||
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 | Tax+ 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 | Tax+ 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 | |
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 |