Stripe API version 2020-08-27

[snewcomer]

https://stripe.com/docs/upgrades#2020-08-27

• We have removed tax_percent from objects and requests in favor of tax rates.
• On subscription schedules, phases.plans has been renamed to phases.items. This applies for the subscription schedule object as well as create and update requests.
• Deprecate the payment_method.card_automatically_updated webhook in favor of payment_method.automatically_updated.
• Checkout Sessions no longer include the display_items property. Use the includable line_items property instead.
• The requirements hash on the Account and Capability objects, and the verification_fields hash on the Country Spec object have newly formatted strings for requirements that are related to key persons associated with an account:
• Fields that are required for persons with representative, owner, director, and executive roles will be prefixed with representative, owners, directors, and executives, respectively. Person requirements will be previewed as follows:
• When the representative’s phone number is required, it will appear as representative.phone instead of relationship.representative.
• When an owner’s full name is required, it will appear as owners.first_name and owners.last_name instead of relationship.owner.
• When an executive’s ID number is required, it will appear as executives.id_number instead of relationship.executive.
• When a director’s date of birth is required, it will appear as directors.dob.day, directors.dob.month, and directors.dob.year instead of relationship.director.
• The boolean values that indicate the associated owners, executives, or directors have been provided now appear as company.owners_provided, company.executives_provided, or company.directors_provided instead of relationship.owner, relationship.executive, or relationship.director, respectively.
• In the Accounts/Persons/Capabilities API, several new error codes have been introduced in the requirements.errors array. See Account requirements errors for more information. - [ ] These error codes are:
  verification_document_issue_or_expiry_date_missing
  verification_document_not_signed
  verification_failed_tax_id_not_issued
  verification_failed_tax_id_match
  invalid_address_po_boxes_disallowed
• The payment_method_details.card.three_d_secure fields on the Charge object have been updated. The succeeded and authenticated booleans have been removed; please use the result enum instead.
• The subscriptions property on Customers is no longer included by default. You can expand the list but for performance reasons we recommended against doing so unless needed.
• The tiers property on Plan is no longer included by default. You can expand the list but for performance reasons we recommended against doing so unless needed.
• The sources property on Customers is no longer included by default. You can expand the list but for performance reasons we recommended against doing so unless needed.
• The tax_ids property on Customers is no longer included by default. You can expand the list but for performance reasons we recommended against doing so unless needed.
• The prorate and subscription_prorate parameters are deprecated in favor of proration_behavior.

https://stripe.com/docs/upgrades#breaking-change