Skip to content

Migration guide for v13

Jump to bottom
anniel-stripe edited this page Aug 21, 2023 · 8 revisions

Changes in 13.0.0 - 2023-8-16

"⚠️" symbol highlights breaking changes. This release includes breaking changes resulting from moving to use the new API version "2023-08-16". To learn more about these changes to Stripe products, see https://stripe.com/docs/upgrades#2023-08-16

⚠️ Changed

⚠️ Removed

  • Remove deprecated del method on Subcriptions. Please use the cancel method instead, which was introduced in v9.14.0:
// Before
stripe.subscriptions.del('sub_123');

// After
stripe.subscriptions.cancel('sub_123');
  • Remove support for values custom_account_update and custom_account_verification from enum AccountLinkCreateParams.type
    • These values are not fully operational. Please use account_update and account_onboarding instead (see API reference).
  • Remove support for available_on on BalanceTransactionListParams
    • Use of this parameter is discouraged. You may use .AddExtraParam if sending the parameter is still required.
  • Remove support for alternate_statement_descriptors and dispute on Charge
    • Use of these fields is discouraged.
  • Remove support for destination on Charge
    • Please use transfer_data or on_behalf_of instead.
  • Remove support for shipping_rates on Checkout.SessionCreateParams
    • Please use shipping_options instead.
  • Remove support for coupon and trial_from_plan on Checkout.SessionCreateParams.subscription_data
    • Please migrate to the Prices API, or suppress the Typescript error with // @ts-ignore or any if sending the parameter is still required.
  • Remove support for value card_present from enums CustomerListPaymentMethodsParams.type and PaymentMethodListParams.type
    • This value was not fully operational.
  • Remove support for value charge_refunded from enum Dispute.status
    • This value was not fully operational.
  • Remove support for blik on Mandate.payment_method_details, PaymentMethodUpdateParams, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
    • These fields were mistakenly released.
  • Remove support for acss_debit, affirm, au_becs_debit, bacs_debit, cashapp, sepa_debit, and zip on PaymentMethodUpdateParams * These fields are empty.
  • Remove support for country on PaymentMethod.link * This field was not fully operational.
  • Remove support for recurring on PriceUpdateParams * This property should be set on create only.
  • Remove support for attributes, caption, and deactivate_on on ProductCreateParams, ProductUpdateParams, and Product
    • These fields are not fully operational.

Added

  • Add support for new values verification_directors_mismatch, verification_document_directors_mismatch, verification_extraneous_directors, and verification_missing_directors on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].code
  • Add support for new value 2023-08-16 on enum WebhookEndpointCreateParams.api_version
Clone this wiki locally