# Changelog

## [4.48.1](https://github.com/recurly/recurly-client-ruby/tree/4.48.1) (2024-04-02)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.48.0...4.48.1)


**Merged Pull Requests**

- fix: Allow Resource to be compare to other object [#890](https://github.com/recurly/recurly-client-ruby/pull/890) ([malbert](https://github.com/malbert))



## [4.48.0](https://github.com/recurly/recurly-client-ruby/tree/4.48.0) (2024-03-19)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.47.0...4.48.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#894](https://github.com/recurly/recurly-client-ruby/pull/894) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.47.0](https://github.com/recurly/recurly-client-ruby/tree/4.47.0) (2024-02-20)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.46.0...4.47.0)


**Merged Pull Requests**

- Add invoice state param for v2021-02-25 [#887](https://github.com/recurly/recurly-client-ruby/pull/887) ([recurly-integrations](https://github.com/recurly-integrations))
- Remove internal wiki link. [#882](https://github.com/recurly/recurly-client-ruby/pull/882) ([recurly-bearley](https://github.com/recurly-bearley))



## [4.46.0](https://github.com/recurly/recurly-client-ruby/tree/4.46.0) (2024-01-24)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.45.0...4.46.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#877](https://github.com/recurly/recurly-client-ruby/pull/877) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.45.0](https://github.com/recurly/recurly-client-ruby/tree/4.45.0) (2024-01-18)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.44.0...4.45.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#872](https://github.com/recurly/recurly-client-ruby/pull/872) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.44.0](https://github.com/recurly/recurly-client-ruby/tree/4.44.0) (2023-12-06)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.43.0...4.44.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (External Payment Phases) [#869](https://github.com/recurly/recurly-client-ruby/pull/869) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.43.0](https://github.com/recurly/recurly-client-ruby/tree/4.43.0) (2023-11-07)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.42.0...4.43.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#867](https://github.com/recurly/recurly-client-ruby/pull/867) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.42.0](https://github.com/recurly/recurly-client-ruby/tree/4.42.0) (2023-08-29)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.41.0...4.42.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (`VATNumber`, `LifecycleDecline`) [#865](https://github.com/recurly/recurly-client-ruby/pull/865) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.41.0](https://github.com/recurly/recurly-client-ruby/tree/4.41.0) (2023-08-10)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.40.0...4.41.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (action_result) [#864](https://github.com/recurly/recurly-client-ruby/pull/864) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.40.0](https://github.com/recurly/recurly-client-ruby/tree/4.40.0) (2023-07-27)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.38.0...4.40.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Ramp Dates, Net Terms, Invoice Business Entity) [#860](https://github.com/recurly/recurly-client-ruby/pull/860) ([recurly-integrations](https://github.com/recurly-integrations))
- Generated Latest Changes for v2021-02-25 (App Management - External Subscriptions) [#859](https://github.com/recurly/recurly-client-ruby/pull/859) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.38.0](https://github.com/recurly/recurly-client-ruby/tree/4.38.0) (2023-06-01)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.37.0...4.38.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Multiple Business Entities) [#850](https://github.com/recurly/recurly-client-ruby/pull/850) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.37.0](https://github.com/recurly/recurly-client-ruby/tree/4.37.0) (2023-05-24)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.36.0...4.37.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (External Products & References) [#848](https://github.com/recurly/recurly-client-ruby/pull/848) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.36.0](https://github.com/recurly/recurly-client-ruby/tree/4.36.0) (2023-05-23)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.35.0...4.36.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (gateway_attributes on PaymentMethod) [#846](https://github.com/recurly/recurly-client-ruby/pull/846) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.35.0](https://github.com/recurly/recurly-client-ruby/tree/4.35.0) (2023-05-03)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.34.0...4.35.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#843](https://github.com/recurly/recurly-client-ruby/pull/843) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.34.0](https://github.com/recurly/recurly-client-ruby/tree/4.34.0) (2023-04-26)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.33.0...4.34.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (used_tax_service on Invoice) [#839](https://github.com/recurly/recurly-client-ruby/pull/839) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.33.0](https://github.com/recurly/recurly-client-ruby/tree/4.33.0) (2023-04-13)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.32.0...4.33.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (External Accounts) [#836](https://github.com/recurly/recurly-client-ruby/pull/836) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.32.0](https://github.com/recurly/recurly-client-ruby/tree/4.32.0) (2023-04-05)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.31.0...4.32.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#833](https://github.com/recurly/recurly-client-ruby/pull/833) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.31.0](https://github.com/recurly/recurly-client-ruby/tree/4.31.0) (2023-03-29)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.30.0...4.31.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (External Invoices) [#831](https://github.com/recurly/recurly-client-ruby/pull/831) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.30.0](https://github.com/recurly/recurly-client-ruby/tree/4.30.0) (2023-02-22)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.29.0...4.30.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#829](https://github.com/recurly/recurly-client-ruby/pull/829) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.29.0](https://github.com/recurly/recurly-client-ruby/tree/4.29.0) (2023-02-07)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.28.0...4.29.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (GiftCard endpoints and new transaction error support) [#827](https://github.com/recurly/recurly-client-ruby/pull/827) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.28.0](https://github.com/recurly/recurly-client-ruby/tree/4.28.0) (2023-01-19)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.27.0...4.28.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Custom Fields on Line Items) [#821](https://github.com/recurly/recurly-client-ruby/pull/821) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.27.0](https://github.com/recurly/recurly-client-ruby/tree/4.27.0) (2023-01-11)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.26.0...4.27.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Account Preferred Time Zone) [#816](https://github.com/recurly/recurly-client-ruby/pull/816) ([douglasmiller](https://github.com/douglasmiller))



## [4.26.0](https://github.com/recurly/recurly-client-ruby/tree/4.26.0) (2022-11-17)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.25.0...4.26.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Apply Credit Balance feature) [#811](https://github.com/recurly/recurly-client-ruby/pull/811) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.25.0](https://github.com/recurly/recurly-client-ruby/tree/4.25.0) (2022-11-15)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.24.0...4.25.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (External Subscriptions feature) [#809](https://github.com/recurly/recurly-client-ruby/pull/809) ([recurly-integrations](https://github.com/recurly-integrations))
- Generated Latest Changes for v2021-02-25 [#807](https://github.com/recurly/recurly-client-ruby/pull/807) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.24.0](https://github.com/recurly/recurly-client-ruby/tree/4.24.0) (2022-11-03)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.23.0...4.24.0)


**Merged Pull Requests**

- Add Webhooks::verify_signature [#794](https://github.com/recurly/recurly-client-ruby/pull/794) ([jguidry-recurly](https://github.com/jguidry-recurly))



## [4.23.0](https://github.com/recurly/recurly-client-ruby/tree/4.23.0) (2022-10-27)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.22.0...4.23.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Entitlements feature) [#804](https://github.com/recurly/recurly-client-ruby/pull/804) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.22.0](https://github.com/recurly/recurly-client-ruby/tree/4.22.0) (2022-10-21)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.21.1...4.22.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25(Decimal Usage and Quantities and DunningEvent new fields) [#801](https://github.com/recurly/recurly-client-ruby/pull/801) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.21.1](https://github.com/recurly/recurly-client-ruby/tree/4.21.1) (2022-09-08)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.21.0...4.21.1)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#792](https://github.com/recurly/recurly-client-ruby/pull/792) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.21.0](https://github.com/recurly/recurly-client-ruby/tree/4.21.0) (2022-09-07)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.20.0...4.21.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#790](https://github.com/recurly/recurly-client-ruby/pull/790) ([recurly-integrations](https://github.com/recurly-integrations))
- Fixes bug with put_dunning_campaign_bulk_update [#788](https://github.com/recurly/recurly-client-ruby/pull/788) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.20.0](https://github.com/recurly/recurly-client-ruby/tree/4.20.0) (2022-08-03)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.19.0...4.20.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#783](https://github.com/recurly/recurly-client-ruby/pull/783) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.19.0](https://github.com/recurly/recurly-client-ruby/tree/4.19.0) (2022-07-11)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.18.0...4.19.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#778](https://github.com/recurly/recurly-client-ruby/pull/778) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.18.0](https://github.com/recurly/recurly-client-ruby/tree/4.18.0) (2022-06-16)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.17.0...4.18.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#776](https://github.com/recurly/recurly-client-ruby/pull/776) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.17.0](https://github.com/recurly/recurly-client-ruby/tree/4.17.0) (2022-04-15)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.16.0...4.17.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#766](https://github.com/recurly/recurly-client-ruby/pull/766) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.16.0](https://github.com/recurly/recurly-client-ruby/tree/4.16.0) (2022-03-24)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.15.0...4.16.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Percentage tiers feature) [#762](https://github.com/recurly/recurly-client-ruby/pull/762) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.15.0](https://github.com/recurly/recurly-client-ruby/tree/4.15.0) (2022-03-14)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.14.0...4.15.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Percentage tiers feature) [#757](https://github.com/recurly/recurly-client-ruby/pull/757) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.14.0](https://github.com/recurly/recurly-client-ruby/tree/4.14.0) (2022-03-03)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.13.0...4.14.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#753](https://github.com/recurly/recurly-client-ruby/pull/753) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.13.0](https://github.com/recurly/recurly-client-ruby/tree/4.13.0) (2022-01-31)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.12.0...4.13.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#747](https://github.com/recurly/recurly-client-ruby/pull/747) ([recurly-integrations](https://github.com/recurly-integrations))
- Add region argument to client to connect in EU data center [#744](https://github.com/recurly/recurly-client-ruby/pull/744) ([FabricioCoutinho](https://github.com/FabricioCoutinho))



## [4.12.0](https://github.com/recurly/recurly-client-ruby/tree/4.12.0) (2022-01-28)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.11.0...4.12.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Invoice Customization) [#746](https://github.com/recurly/recurly-client-ruby/pull/746) ([recurly-integrations](https://github.com/recurly-integrations))
- Generated Latest Changes for v2021-02-25 [#743](https://github.com/recurly/recurly-client-ruby/pull/743) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.11.0](https://github.com/recurly/recurly-client-ruby/tree/4.11.0) (2021-12-29)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.10.0...4.11.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Tax Inclusive Pricing) [#741](https://github.com/recurly/recurly-client-ruby/pull/741) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.10.0](https://github.com/recurly/recurly-client-ruby/tree/4.10.0) (2021-11-22)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.9.0...4.10.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#739](https://github.com/recurly/recurly-client-ruby/pull/739) ([recurly-integrations](https://github.com/recurly-integrations))
- Generated Latest Changes for v2021-02-25 [#736](https://github.com/recurly/recurly-client-ruby/pull/736) ([recurly-integrations](https://github.com/recurly-integrations))
- Allow API base url configuration [#735](https://github.com/recurly/recurly-client-ruby/pull/735) ([cbarton](https://github.com/cbarton))
- Generated Latest Changes for v2021-02-25 [#734](https://github.com/recurly/recurly-client-ruby/pull/734) ([recurly-integrations](https://github.com/recurly-integrations))
- Generated Latest Changes for v2021-02-25 [#728](https://github.com/recurly/recurly-client-ruby/pull/728) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.9.0](https://github.com/recurly/recurly-client-ruby/tree/4.9.0) (2021-09-16)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.8.0...4.9.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Support to new subscription fields and response) [#725](https://github.com/recurly/recurly-client-ruby/pull/725) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.8.0](https://github.com/recurly/recurly-client-ruby/tree/4.8.0) (2021-09-01)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.7.0...4.8.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Dunning Campaigns feature) [#724](https://github.com/recurly/recurly-client-ruby/pull/724) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.7.0](https://github.com/recurly/recurly-client-ruby/tree/4.7.0) (2021-08-19)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.6.0...4.7.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (get_preview_renewal) [#722](https://github.com/recurly/recurly-client-ruby/pull/722) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.6.0](https://github.com/recurly/recurly-client-ruby/tree/4.6.0) (2021-08-11)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.5.0...4.6.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#720](https://github.com/recurly/recurly-client-ruby/pull/720) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.5.0](https://github.com/recurly/recurly-client-ruby/tree/4.5.0) (2021-08-02)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.4.0...4.5.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#714](https://github.com/recurly/recurly-client-ruby/pull/714) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.4.0](https://github.com/recurly/recurly-client-ruby/tree/4.4.0) (2021-06-15)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.3.0...4.4.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#705](https://github.com/recurly/recurly-client-ruby/pull/705) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.3.0](https://github.com/recurly/recurly-client-ruby/tree/4.3.0) (2021-06-04)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.2.0...4.3.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#702](https://github.com/recurly/recurly-client-ruby/pull/702) ([recurly-integrations](https://github.com/recurly-integrations))
- Making #post allow a nil body [#699](https://github.com/recurly/recurly-client-ruby/pull/699) ([douglasmiller](https://github.com/douglasmiller))



## [4.2.0](https://github.com/recurly/recurly-client-ruby/tree/4.2.0) (2021-04-21)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.1.0...4.2.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 [#695](https://github.com/recurly/recurly-client-ruby/pull/695) ([recurly-integrations](https://github.com/recurly-integrations))



## [4.1.0](https://github.com/recurly/recurly-client-ruby/tree/4.1.0) (2021-04-14)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.0.1...4.1.0)


**Merged Pull Requests**

- Generated Latest Changes for v2021-02-25 (Backup Payment Method) [#691](https://github.com/recurly/recurly-client-ruby/pull/691) ([recurly-integrations](https://github.com/recurly-integrations))
- Generated Latest Changes for v2021-02-25 [#687](https://github.com/recurly/recurly-client-ruby/pull/687) ([recurly-integrations](https://github.com/recurly-integrations))
- Restoring NetworkError and it's derivatives [#685](https://github.com/recurly/recurly-client-ruby/pull/685) ([douglasmiller](https://github.com/douglasmiller))
- Generated Latest Changes for v2021-02-25 (Usage Percentage on Tiers) [#683](https://github.com/recurly/recurly-client-ruby/pull/683) ([recurly-integrations](https://github.com/recurly-integrations))
- Fixes TypeError caused by attempts to Base64 encode nil @api_key values [#672](https://github.com/recurly/recurly-client-ruby/pull/672) ([alexfulsome](https://github.com/alexfulsome))



## [4.0.1](https://github.com/recurly/recurly-client-ruby/tree/4.0.1) (2021-03-19)

[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.0.0...4.0.1)


**Merged Pull Requests**

- Release 4.0.1 [#682](https://github.com/recurly/recurly-client-ruby/pull/682) ([douglasmiller](https://github.com/douglasmiller))
- More ruby 3.0 [#680](https://github.com/recurly/recurly-client-ruby/pull/680) ([douglasmiller](https://github.com/douglasmiller))
- Generated Latest Changes for v2021-02-25 [#678](https://github.com/recurly/recurly-client-ruby/pull/678) ([recurly-integrations](https://github.com/recurly-integrations))
- Sync updates not ported from 3.x client [#671](https://github.com/recurly/recurly-client-ruby/pull/671) ([douglasmiller](https://github.com/douglasmiller))



## [4.0.0](https://github.com/recurly/recurly-client-ruby/tree/4.0.0) (2021-03-01)


# Major Version Release

The 4.x major version of the client pairs with the `v2021-02-25` API version. This version of the client and the API contain breaking changes that should be considered before upgrading your integration.

## Breaking Changes in the API
All changes to the core API are documented in the [Developer Portal changelog](https://developers.recurly.com/api/changelog.html#v2021-02-25---current-ga-version)

## Breaking Changes in Client

- Remove `site_id` and `subdomain` from client initializer.  [#624]
- Remove `set_site_id` method from client.  [#627]
- Classify unexpected error responses from Recurly API via an HTTP status code mapping provided in `Recurly::Errors::ERROR_MAP`.  [#616]
- Remove `NetworkError` class. All error classes now extend the `APIError`. This means that the order of multiple rescue blocks will need to be re-considered.  [#616]

    ### 3.x
    
    ```ruby
    rescue Recurly::Errors::ValidationError => ex
      # catch a validation error
    rescue Recurly::Errors::APIError => ex
      # catch a generic api error
    rescue Recurly::Errors::TimeoutError => ex
      # catch a specific network error
    ```
    
    ### 4.x
    
    ```ruby
    rescue Recurly::Errors::ValidationError => ex
      # catch a validation error
    rescue Recurly::Errors::TimeoutError => ex
      # catch a specific network error
    rescue Recurly::Errors::APIError => ex
      # catch a generic api error
    ```

- Rename `InvalidResponseError` to `InvalidContentTypeError`.  [#616]
- Rename `UnavailableError` to `ServiceUnavailableError`.  [#616]
- Reorganize top-level keys of the optional parameters hash to improve clarity and create space for additional options.  [#619]

    ### 3.x
    
    ```ruby
    options = {
      limit: 200,
      headers: {
        'Accept-Language' => 'fr'
      }
    }
    accounts = @client.list_accounts(options)
    ```
    
    ### 4.x
    
    ```ruby
    options = {
      params: {
          limit: 200
      }
      headers: {
        'Accept-Language' => 'fr'
      }
    }
    accounts = @client.list_accounts(options)
    ```