README.md in stripe-10.11.0.pre.beta.1 vs README.md in stripe-10.11.0
- old
+ new
@@ -21,11 +21,10 @@
See the [Ruby API docs](https://stripe.com/docs/api?lang=ruby).
See [video demonstrations][youtube-playlist] covering how to use the library.
-
## Installation
You don't need this source code unless you want to modify the gem. If you just
want to use the package, just run:
@@ -334,24 +333,13 @@
> **Note**
> There can be breaking changes between beta versions. Therefore we recommend pinning the package version to a specific beta version in your Gemfile. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest beta version.
We highly recommend keeping an eye on when the beta feature you are interested in goes from beta to stable so that you can move from using a beta version of the SDK to the stable version.
-If your beta feature requires a `Stripe-Version` header to be sent, use the `Stripe.api_version` field to set it:
+If your beta feature requires a `Stripe-Version` header to be sent, set the `Stripe.api_version` field using `Stripe.add_beta_version`:
```python
-Stripe.api_version += "; feature_beta=v3"
-```
-
-### Custom requests
-
-If you would like to send a request to an undocumented API (for example you are in a private beta), or if you prefer to bypass the method definitions in the library and specify your request details directly, you can use the `raw_request` method on `Stripe`.
-
-```ruby
-resp = Stripe.raw_request(:post, "/v1/beta_endpoint", {param: 123}, {stripe_version: "2022-11-15; feature_beta=v3"})
-
-# (Optional) resp is a StripeResponse. You can use `Stripe.deserialize` to get a StripeObject.
-deserialized_resp = Stripe.deserialize(resp.http_body)
+Stripe.add_beta_version("feature_beta", "v3")
```
## Support
New features and bug fixes are released on the latest major version of the Stripe Ruby library. If you are on an older major version, we recommend that you upgrade to the latest in order to use the new features and bug fixes including those for security vulnerabilities. Older major versions of the package will continue to be available for use, but will not be receiving any updates.