Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

stripe-php v11 release #1542

Merged
merged 7 commits into from
Aug 16, 2023
Merged

stripe-php v11 release #1542

merged 7 commits into from
Aug 16, 2023

Conversation

richardm-stripe
Copy link
Contributor

@richardm-stripe richardm-stripe commented Aug 1, 2023

Changelog

⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️

  • ⚠️ Pin API version to 2023-08-16
    In this release, Stripe API Version 2023-08-16 (the latest at time of release) will be sent by default on all requests.
    The previous default was to use your Stripe account's default API version.

    To successfully upgrade to stripe-php v11, you must either

    1. (Recommended) Upgrade your integration to be compatible with API Version 2023-08-16.

      Please read the API Changelog carefully for each API Version from 2023-08-16 back to your Stripe account's default API version. Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe Test Mode before deploying them to production.

      You can read the v11 migration guide for more detailed instructions.

    2. (Alternative option) Specify a version other than 2023-08-16 when initializing stripe-php.

      If you were previously initializing stripe-php without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your Stripe account's default API version. For example:

        // if using StripeClient
      - $stripe = new \Stripe\StripeClient('sk_test_xyz');
      + $stripe = new \Stripe\StripeClient([
      +   'api_key' => 'sk_test_xyz',
          'stripe_version' => '2020-08-27',
      + ]);
      
        // if using the global client
        Stripe.apiKey = "sk_test_xyz";
      + Stripe::setApiVersion('2020-08-27');

      If you were already initializing stripe-php with an explicit API Version, upgrading to v11 will not affect your integration.

      Read the v11 migration guide for more details.

    Going forward, each major release of this library will be pinned by default to the latest Stripe API Version at the time of release.

    That is, instead of upgrading stripe-php and separately upgrading your Stripe API Version through the Stripe Dashboard. whenever you upgrade major versions of stripe-php, you should also upgrade your integration to be compatible with the latest Stripe API version.

  • ⚠️ Remove Invoice.STATUS_DELETE

@richardm-stripe richardm-stripe marked this pull request as ready for review August 16, 2023 17:55
@richardm-stripe richardm-stripe merged commit 2f6758f into master Aug 16, 2023
42 checks passed
@remi-stripe remi-stripe deleted the sdk-release/next-major branch September 28, 2023 23:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants