CHANGELOG.md

Version 0.12.3 (May 16, 2020)

Fixes

• Fix failing Invoice::upcoming by adding a is_none representation to InvoiceId (@bryanburgers)

Version 0.12.2 (May 15, 2020)

Features

• Enable RustTLS behind a feature flag (@kiljacken)

Fixes

• Add missing values to PaymentMethodType and PaymentIntentMethodType (@ThouCheese)

Version 0.12.1 (February 6, 2020)

Fixes

• Fixed deserialization of ChargeIds with py_ prefix in PaymentIntent event(s).

Version 0.12.0 (February 3, 2020)

Breaking Changes

• Updated to a newer version of the Stripe API.

• The PaymentIntent<___>Params structs have been renamed to be consistent with the autogenerated API

  e.g. PaymentIntentCreateParams has become CreatePaymentIntent

Features

• The app-info header can now be set/customized with the Client::set_app_info method.

Improvements

• New feature flags have been introduced to disable unused parts of the stripe APIs. This helps reduce binary bloat and compile time.

• The async client has been updated to use std::future::Future. The async feature flag is deprecated. Prefer { default-features = false, features = ["full"] } instead.

• Set default stripe api version to the latest version supported by the library. This is intended to avoid bugs where a later version of stripe is enabled by a customer.

Feature Flags

By default the full stripe api is enabled.

To reduce code size, disable default features and enable just the APIs you use:

# Example: Core-only (enough to create a `Charge` or `Card` or `Customer`)
stripe-rust = { version = "*", default-features = false, features = ["blocking"] }

# Example: Support for "Subscriptions" and "Invoices"
stripe-rust = { version = "*", default-features = false, features = ["blocking", "billing"] }

Refer to the Stripe API docs to determine which APIs are included as part of each feature flag.

Version 0.11.0 (September 11, 2019)

Features

• The stripe-version header can now be set/customized with the Client::with_headers method.

Improvements

• The Default trait is now derived for all structs that have only defaultable parameters.
• Webhook::construct_event takes payload, signature, and secret args by ref (&str) instead of value.
• The payment_method and confirmation_method fields were added to PaymentIntentCreateParams.
• The payment_method_details structure now supports the card data field.

Fixes

• Boolean fields that may be null, are now Option instead of serde(default).
• The Customer variant was added to the EventObject enum.
• The PaymentIntentCaptureParams are now correctly pub.
• Fixed parsing a negative customer account_balance.

Version 0.10.5 (July 25, 2019)

Breaking Changes

• The PaymentSourceParams struct was edit to only include a TokenId and SourceId as per improvements to the API.
• The charge.source field to create a Charge was fixed to accept the new struct ChargeSourceParams.

Version 0.10.4 (July 12, 2019)

Improvements

• Added id field to Event

Fixes

• Fixes a regression deriving Eq and PartialEq for PaymentIntent enums.

Version 0.10.3 (June 21, 2019)

Fixes

• Fixed deserialization of CheckoutSessionCompleted events.
• Added missing Invoice events.

Version 0.10.2 (June 13, 2019)

Fixes

• Fixed the InvoiceLineItemId type to correctly handle subscription items.

Version 0.10.0 / 0.10.1 (June 4, 2019)

This version uses code generation to generate the stripe API according to the openapi spec.

This contains major breaking changes from previous versions, both because many structures were out of date and because some changes were made to make things easier to generate.

New Features

• Many new APIs have now been implemented (mostly CRUD); some requests are still missing because not all requests are automatically implemented. All previously implemented requests are still implemented (even if they couldn't be code-generated).

• Many requests now take the expand parameter which controls whether more data should be returned for Expandable<T> fields. Previously these fields were just id types.

Improvements

• Fields and requests have descriptive documentation rather than just referring to the stripe API docs.
• Ids and fields are more strictly typed (newtypes vs raw strings).
• Ids no longer need to be allocated and are cheaply clonable (in almost all cases).
• Enum types now implement Display and AsRef<str>.

Version 0.9.2 (April 7, 2019)

Fixes / Improvements

• Add missing product to Plan.
• Add missing receipt_url to Charge.
• The deprecated closed field in Invoice is now optional.
• Fix allowing the description field in Payout to be optional.
• Fix allowing a SubscriptionItem quantity to be None (e.g. when using metered pricing API).
• Fix signature checking for received Webhooks.
• Allow the timestamp to be manually specified when verifying webhook signature.

Version 0.9.1 (Feb 4, 2019)

Fixes

• Detach source data structure is a new DetachedSource enum
• The object field was removed from PaymentIntent, Refund and Payout.
• Fields in PaymentIntent were updated to correctly be optional

Version 0.9.0 (Jan 17, 2019)

New Features

• Added an async feature flag which removes stripe::Client and adds stripe::async::Client.

Breaking Changes

• The stripe::Params typed was renamed to Headers to avoid confusion with other FooParams types and the params module.

Version 0.8.0 (Jan 15, 2019)

New Features

• Added verify_bank_account to Customer resource.
• Added BankAccount as a variant of PaymentSource.
• Add the PaymentIntents resources, apis and events.

Breaking Changes

• Minimum Rust version required is 1.31.1.
• Moved retrieve_source and detach_source to Customer resource from Source.
• The Error::Conversion enum variant has been replaced by Error::Serialize and Error::Deserialize.
• See also Fixes / Improvements.

Fixes / Improvements

• TokenId has become an enum to account for different Token options
• Updated fields on BankAccount resource so all are correct.
• The Payout and Refund types now use enums instead of Strings.
• The WebhookError type is now externally public.

Version 0.7.2

Fixes

• Fix sending metadata (and other nested params) as part of a POST request; e.g. Customer::create, Customer::update, etc.

Version 0.7.0 and 0.7.1

Fixes

• The type of Customer.default_source has changed from SourceId to PaymentSourceId.
• The type of Customer.sources has changed from List<Source> to List<PaymentSource>.

Version 0.6.0

New Features / Improvements

• The List<T> type has new next and get_all methods for pagination.
• Struct types more consistently implement Clone.
• Enum types more consistently implement Copy, Eq, and Hash.
• More source details (e.g. ach_credit_transfer, etc) were added to Source.
• The blocking api is now backed by reqwest instead of hyper:0.10 so that the library is no longer pinned to outdated dependencies.
• Added the "webhooks" feature flag for processing events (enabled by default) to convert hmac and sha2 to optional dependencies.

Breaking Changes

• (Mostly from 0.5.x series) Charge, Card, and Source have been updated to use new enum values rather than String.
• The SourceType enum used by ChargeListParams has been renamed to SourceFilterType to remove a conflict with the SourceType enum used by the type field of Source.

Fixes

• All Address fields have been updated to be optional.
• The Client-Id param has been added to params to make support for impersonating Connect Accounts compatible with newer stripe api versions.

Version 0.5.3

Changes

• Updated Charge to use enum types rather than &str where possible.

Version 0.5.2

Changes

• Fixed many issues with the Source object.
• Updated Card to use enum types rather than &str where possible.
• Added many new fields to Card.

Version 0.5.1

Changes

• Bumped dependency versions

Version 0.5.0 (Sep 26, 2018)

New Features

• Implemented the sources resource and added the Source type .

Breaking Changes

• The CustomerSourceParams struct was renamed to PaymentSourceParams.
• The Source enum was renamed to PaymentSource (there is a new Source struct).
• Source and token fields (like token: &str) now use source: SourceId or token: TokenId instead.

General Improvements

• Added missing default_source field to Customer.
• The Deserialize and Serialize traits have now been implemented for all param and resource structs.
• The Copy, Clone, Eq, PartialEq, and Hash traits have been derived for flat enum types.

Version 0.4.7 (Jun 11, 2018)

Changes

• Fix, adds all missing error code variants to stripe::error::ErrorCode.

Version 0.4.6 (Jun 9, 2018)

Changes

• Fixed field nickname of Plan can be null.

Version 0.4.5 (Feb 20, 2018)

Changes

• Fixed field nickname of Plan should be name

Version 0.4.4 (Jan 4, 2018)

Breaking Changes

• The balance_transaction field of Charge is now Option<_>.

Version 0.4.2 (August 20, 2017)

Changes

• Added basic crate documentation
• Added the invoice.upcoming event

Version 0.4.1 (August 8, 2017)

Changes

• Add RangeQuery struct for created/date filters in list requests
• Implement Customer::list request (ie. "GET /customers"); Thanks @pocket7878
• Add missing params to InvoiceListParams for Invoice::list

Version 0.4.0 (August 2, 2017)

Breaking Changes

• Upgrade Serde to v1.0

Version 0.3.3 (August 1, 2017)

Changes

• Add support for authentication using the Stripe-Account header
• Implement Event struct for implementing a Stripe Webhook (only some events)
• Implement Invoice::update request (ie. POST "/invoices/{invoice_id}")
• Implement InvoiceItem::create request (ie. POST "/invoiceitems")
• Fix Subscription::cancel request (previously used wrong method/path)

Version 0.3.2 (June 17, 2017)

Changes

• Implemented the Invoice::list API (ie. "/invoices")
• Fixed a request encoding error for Invoice::pay (ie. "/invoices/{invoice_id}/pay")
• Fixed fields on Subscription that could be null but were missing Optional<..>
• Added missing last4 field to Card resource
• Changed the repository URL

Version 0.3.1 (Mar 31, 2017)

Changes

• Made rust docs slightly easier to read
• Fixed incorrect method name for Plan resource
• Use native-tls by default and add feature-flag supporting openssl

Version 0.3.0 (Mar 28, 2017)

New Features

• Implemented the charges resource and added the Charge type.

Breaking Changes

• The Resource::get requests have been renamed to Resource::retrieve.
• The Subscription::cancel request now expects CancelParams instead of expecting a one-off function argument.
• Removed the blame method and Blame type from errors.
• The Error::Decode and Error::Encode variants have been combined into a single Error::Conversion variant.

General Improvements

• The Error type now has easier to read error messages and will parses JSON errors returned by Stripe into a structured error type (RequestError).
• Added Travis CI for automated testing on GitHub.
• Added reference documentation to implemented resources (but still no docs at crate/module level nor a "Getting started" guide)

Version 0.2.0 (Mar 17, 2017)

New Features

• Added Client which is created once with a stripe private key and is intended to be re-used for multiple requests. It implements Sync so you can share it among multiple threads.
• Added new strongly-typed Currency type following the example of https://github.com/stripe/stripe-go.
• Customer::create/CustomerParams now support using CardParams as a source instead of just tokens.
• Implemented the sources API in the Source type.

Breaking Changes

• All Params types now use &str fields instead of Strings.
• Requests used to require a stripe_key: &str as their final argument but now use a &Client as the first argument instead.
• Stripe tokens used to be directly used as a source in CustomerParams but now must be used with CustomerSourceParams::Token("tok_xyzABC123").

General Improvements

• Added remaining fields to Params types after switching from serde_urlencoded to serde_qs to support nested params.
• Added the create_customer example
• Types that implement Deserialize now also implement Debug.
• Types that implement Serialize now also implement Default.