recurly 3.4.1 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7773f48a4f735c65edee8232a5f87182b0d624ef25814275835c2f4c0061c64
-  data.tar.gz: c45ccebad3e7bd510e245b3c5e23a233eebf3e65bd7c715113a6e51e65f1cdf6
+  metadata.gz: 8cb7459191e21c44fd4796091c9aba791fbc079c446aad569513bc3df26e5f10
+  data.tar.gz: 632a9ff4168fbdeeff508dc643920bf2290d225eaed28d5c7d0d92897495a26a
 SHA512:
-  metadata.gz: 56b7d44c97ff4b758c4abe4fe5135f532c27a618dfd6b0365e04c7b589ee238c72e9dc6958c8c2ff7a11919fc67fc2e64c58a34073fe6b632cde70e9cdf86f4a
-  data.tar.gz: d4363dfdec86652a7b9f21207334cde68575034167bd91e49342f71175d44314fae090b02038d46a6d613104474010d0ee02806ad770f4084f565831ec136b97
+  metadata.gz: 7981c548326df5a65652e8184410a959927ad0b0630c1da6f286965389bb27a71a3da51e7e9804589b3564a94a4e266fc54f686eca3cd6d1b0aa6af779c73694
+  data.tar.gz: 10b42ef5247e4ecad7112c8b9ca9f2e8cbee81bacc4c55a773e1e4d1bcdec42cf4f01847a83c6975f46f9d5c86bba9bdd97d4f0b10710f891be1be0f2c2ab437

data/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.4.1
+current_version = 3.5.0
 parse = (?P<major>\d+)
 	\.(?P<minor>\d+)
 	\.(?P<patch>\d+)

data/.github/workflows/docs.yml

@@ -0,0 +1,28 @@
+on:
+  release:
+    types:
+      - published
+name: Documentation
+jobs:
+  build:
+    name: Publish
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '2.6'
+
+    - name: Build Library and Docs
+      run: ./scripts/build
+
+    - name: Deploy
+      if: success()
+      uses: crazy-max/ghaction-github-pages@v1
+      with:
+        target_branch: gh-pages
+        build_dir: ./doc
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

data/.travis.yml

@@ -4,6 +4,7 @@ rvm:
   - 2.4
   - 2.5
   - 2.6
+  - 2.7
 bundler_args: --binstubs
 before_install:
   - gem update --system

data/CHANGELOG.md

@@ -1,6 +1,40 @@
-# Change Log
+# Changelog
+
+## [3.5.0](https://github.com/recurly/recurly-client-ruby/tree/HEAD)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.4.1...HEAD)
+
+**Implemented enhancements:**
+
+- Tue Apr 14 20:21:21 UTC 2020 Upgrade API version v2019-10-10 [\#585](https://github.com/recurly/recurly-client-ruby/pull/585) ([bhelx](https://github.com/bhelx))
+- Set an Idempotency-Key header, retry GET requests after 5xx errors [\#579](https://github.com/recurly/recurly-client-ruby/pull/579) ([isaachall](https://github.com/isaachall))
+- Adding \#first and \#count methods to Pager [\#560](https://github.com/recurly/recurly-client-ruby/pull/560) ([douglasmiller](https://github.com/douglasmiller))
+
+**Fixed bugs:**
+
+- Fixing the omission of query params [\#581](https://github.com/recurly/recurly-client-ruby/pull/581) ([douglasmiller](https://github.com/douglasmiller))
+
+**Merged pull requests:**
+
+- Release 3.5.0 [\#586](https://github.com/recurly/recurly-client-ruby/pull/586) ([douglasmiller](https://github.com/douglasmiller))
+- Included the to-be released changes in the changelog [\#584](https://github.com/recurly/recurly-client-ruby/pull/584) ([douglasmiller](https://github.com/douglasmiller))
+- Add 2.7 to test matrix [\#582](https://github.com/recurly/recurly-client-ruby/pull/582) ([bhelx](https://github.com/bhelx))
+- Use github pages for docs [\#580](https://github.com/recurly/recurly-client-ruby/pull/580) ([bhelx](https://github.com/bhelx))
+- Add project metadata to the gemspec [\#578](https://github.com/recurly/recurly-client-ruby/pull/578) ([orien](https://github.com/orien))
+- Updating release script to be uniform across all clients [\#577](https://github.com/recurly/recurly-client-ruby/pull/577) ([douglasmiller](https://github.com/douglasmiller))
+- Thu Mar 26 20:41:10 UTC 2020 Upgrade API version v2019-10-10 [\#573](https://github.com/recurly/recurly-client-ruby/pull/573) ([bhelx](https://github.com/bhelx))
+
+## [3.4.1](https://github.com/recurly/recurly-client-ruby/tree/3.4.1) (2020-03-26)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.4.0...3.4.1)
+
+**Merged pull requests:**
+
+- Release 3.4.1 [\#571](https://github.com/recurly/recurly-client-ruby/pull/571) ([bhelx](https://github.com/bhelx))
+- Follow up bug fixes for \#568 [\#570](https://github.com/recurly/recurly-client-ruby/pull/570) ([bhelx](https://github.com/bhelx))
 
 ## [3.4.0](https://github.com/recurly/recurly-client-ruby/tree/3.4.0) (2020-03-23)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.3.1...3.4.0)
 
 **Implemented enhancements:**
@@ -12,6 +46,7 @@
 - Release 3.4.0 [\#569](https://github.com/recurly/recurly-client-ruby/pull/569) ([bhelx](https://github.com/bhelx))
 
 ## [3.3.1](https://github.com/recurly/recurly-client-ruby/tree/3.3.1) (2020-03-20)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.3.0...3.3.1)
 
 **Merged pull requests:**
@@ -23,6 +58,7 @@
 - Add request for stack trace in issue report [\#558](https://github.com/recurly/recurly-client-ruby/pull/558) ([bhelx](https://github.com/bhelx))
 
 ## [3.3.0](https://github.com/recurly/recurly-client-ruby/tree/3.3.0) (2020-02-20)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.2.2...3.3.0)
 
 **Merged pull requests:**
@@ -33,6 +69,7 @@
 - Latest v2019-10-10 Changes [\#552](https://github.com/recurly/recurly-client-ruby/pull/552) ([bhelx](https://github.com/bhelx))
 
 ## [3.2.2](https://github.com/recurly/recurly-client-ruby/tree/3.2.2) (2020-02-03)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.2.1...3.2.2)
 
 **Merged pull requests:**
@@ -41,6 +78,7 @@
 - Loosen version restriction on faraday [\#549](https://github.com/recurly/recurly-client-ruby/pull/549) ([bhelx](https://github.com/bhelx))
 
 ## [3.2.1](https://github.com/recurly/recurly-client-ruby/tree/3.2.1) (2019-12-10)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.2.0...3.2.1)
 
 **Fixed bugs:**
@@ -48,6 +86,7 @@
 - Convert Array params to CSV strings [\#545](https://github.com/recurly/recurly-client-ruby/pull/545) ([douglasmiller](https://github.com/douglasmiller))
 
 ## [3.2.0](https://github.com/recurly/recurly-client-ruby/tree/3.2.0) (2019-12-03)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.1.3...3.2.0)
 
 **Fixed bugs:**
@@ -61,6 +100,7 @@
 - Allow object attributes through [\#542](https://github.com/recurly/recurly-client-ruby/pull/542) ([bhelx](https://github.com/bhelx))
 
 ## [3.1.3](https://github.com/recurly/recurly-client-ruby/tree/3.1.3) (2019-12-02)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.1.2...3.1.3)
 
 **Fixed bugs:**
@@ -69,6 +109,7 @@
 - Issue 540 error may have transaction [\#541](https://github.com/recurly/recurly-client-ruby/pull/541) ([bhelx](https://github.com/bhelx))
 
 ## [3.1.2](https://github.com/recurly/recurly-client-ruby/tree/3.1.2) (2019-12-02)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.1.1...3.1.2)
 
 **Fixed bugs:**
@@ -76,6 +117,7 @@
 - Skip request property type validation for nil values [\#539](https://github.com/recurly/recurly-client-ruby/pull/539) ([bhelx](https://github.com/bhelx))
 
 ## [3.1.1](https://github.com/recurly/recurly-client-ruby/tree/3.1.1) (2019-11-27)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.1.0...3.1.1)
 
 **Fixed bugs:**
@@ -84,6 +126,7 @@
 - Disable searching ancestors when looking up constants [\#537](https://github.com/recurly/recurly-client-ruby/pull/537) ([douglasmiller](https://github.com/douglasmiller))
 
 ## [3.1.0](https://github.com/recurly/recurly-client-ruby/tree/3.1.0) (2019-11-18)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0...3.1.0)
 
 **Merged pull requests:**
@@ -93,6 +136,7 @@
 - Generated Updates for API version v2019-10-10 [\#528](https://github.com/recurly/recurly-client-ruby/pull/528) ([bhelx](https://github.com/bhelx))
 
 ## [3.0.0](https://github.com/recurly/recurly-client-ruby/tree/3.0.0) (2019-10-09)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0.beta.5...3.0.0)
 
 **Merged pull requests:**
@@ -116,6 +160,7 @@
 -  Latest v2018-08-09 Changes [\#484](https://github.com/recurly/recurly-client-ruby/pull/484) ([bhelx](https://github.com/bhelx))
 
 ## [3.0.0.beta.5](https://github.com/recurly/recurly-client-ruby/tree/3.0.0.beta.5) (2019-06-28)
+
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0.beta.4...3.0.0.beta.5)
 
 **Merged pull requests:**
@@ -128,28 +173,20 @@
 - Add strict mode for json deserializer [\#469](https://github.com/recurly/recurly-client-ruby/pull/469) ([bhelx](https://github.com/bhelx))
 
 ## [3.0.0.beta.4](https://github.com/recurly/recurly-client-ruby/tree/3.0.0.beta.4) (2019-04-04)
-[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0.beta.3...3.0.0.beta.4)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0.beta.1...3.0.0.beta.4)
 
 **Merged pull requests:**
 
 - V3 Update v2018-08-09 [\#460](https://github.com/recurly/recurly-client-ruby/pull/460) ([aaron-suarez](https://github.com/aaron-suarez))
 - Small fixes for private beta [\#458](https://github.com/recurly/recurly-client-ruby/pull/458) ([bhelx](https://github.com/bhelx))
 - Use Net-http-persistent for persistent connection [\#408](https://github.com/recurly/recurly-client-ruby/pull/408) ([bhelx](https://github.com/bhelx))
-
-## [3.0.0.beta.3](https://github.com/recurly/recurly-client-ruby/tree/3.0.0.beta.3) (2018-08-27)
-[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0.beta.2...3.0.0.beta.3)
-
-**Merged pull requests:**
-
 - Update to API 2018-06-06 [\#407](https://github.com/recurly/recurly-client-ruby/pull/407) ([bhelx](https://github.com/bhelx))
 - Regenerating the client [\#406](https://github.com/recurly/recurly-client-ruby/pull/406) ([drewish](https://github.com/drewish))
 - V3 Pager can error [\#401](https://github.com/recurly/recurly-client-ruby/pull/401) ([drewish](https://github.com/drewish))
 - \[V3\] Test more versions of ruby [\#397](https://github.com/recurly/recurly-client-ruby/pull/397) ([drewish](https://github.com/drewish))
 - Allow faraday 0.12 for compatibility with oauth2 gem [\#396](https://github.com/recurly/recurly-client-ruby/pull/396) ([drewish](https://github.com/drewish))
 
-## [3.0.0.beta.2](https://github.com/recurly/recurly-client-ruby/tree/3.0.0.beta.2) (2018-07-17)
-[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/3.0.0.beta.1...3.0.0.beta.2)
-
 
 
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/README.md

@@ -7,7 +7,7 @@ This repository houses the official ruby client for Recurly's V3 API.
 
 ## Reference Documentation
 
-Getting Started Guide and reference documentation can be found on [rubydoc.info](https://www.rubydoc.info/github/recurly/recurly-client-ruby/).
+Getting Started Guide and reference documentation can be found on [Github Pages](https://recurly.github.io/recurly-client-ruby/).
 
 ## Contributing
 

data/lib/recurly/client.rb

@@ -2,6 +2,7 @@ require "logger"
 require "erb"
 require "net/https"
 require "base64"
+require "securerandom"
 require_relative "./schema/json_parser"
 require_relative "./schema/file_parser"
 
@@ -18,6 +19,8 @@ module Recurly
     JSON_CONTENT_TYPE = "application/json"
     MAX_RETRIES = 3
 
+    BASE36_ALPHABET = ("0".."9").to_a + ("a".."z").to_a
+
     # Initialize a client. It requires an API key.
     #
     # @example
@@ -53,18 +56,12 @@ module Recurly
       yield(self) if block_given?
     end
 
-    def next_page(pager)
-      path = extract_path(pager.next)
-      request = Net::HTTP::Get.new path
-      set_headers(request)
-      http_response = run_request(request)
-      handle_response! request, http_response
-    end
-
     protected
 
+    # Used by the operations.rb file to interpolate paths
+    attr_reader :site_id
+
     def pager(path, **options)
-      path = scope_by_site(path, **options)
       Pager.new(
         client: self,
         path: path,
@@ -72,9 +69,15 @@ module Recurly
       )
     end
 
+    def head(path, **options)
+      request = Net::HTTP::Head.new build_url(path, options)
+      set_headers(request, options[:headers])
+      http_response = run_request(request, options)
+      handle_response! request, http_response
+    end
+
     def get(path, **options)
-      path = scope_by_site(path, **options)
-      request = Net::HTTP::Get.new path
+      request = Net::HTTP::Get.new build_url(path, options)
       set_headers(request, options[:headers])
       http_response = run_request(request, options)
       handle_response! request, http_response
@@ -82,8 +85,7 @@ module Recurly
 
     def post(path, request_data, request_class, **options)
       request_class.new(request_data).validate!
-      path = scope_by_site(path, **options)
-      request = Net::HTTP::Post.new path
+      request = Net::HTTP::Post.new build_url(path, options)
       request.set_content_type(JSON_CONTENT_TYPE)
       set_headers(request, options[:headers])
       request.body = JSON.dump(request_data)
@@ -92,8 +94,7 @@ module Recurly
     end
 
     def put(path, request_data = nil, request_class = nil, **options)
-      path = scope_by_site(path, **options)
-      request = Net::HTTP::Put.new path
+      request = Net::HTTP::Put.new build_url(path, options)
       request.set_content_type(JSON_CONTENT_TYPE)
       set_headers(request, options[:headers])
       if request_data
@@ -107,18 +108,12 @@ module Recurly
     end
 
     def delete(path, **options)
-      path = scope_by_site(path, **options)
-      request = Net::HTTP::Delete.new path
+      request = Net::HTTP::Delete.new build_url(path, options)
       set_headers(request, options[:headers])
       http_response = run_request(request, options)
       handle_response! request, http_response
     end
 
-    protected
-
-    # Used by the operations.rb file to interpolate paths
-    attr_reader :site_id
-
     private
 
     # @return [Logger]
@@ -139,7 +134,15 @@ module Recurly
 
         begin
           http.start unless http.started?
-          http.request(request)
+          response = http.request(request)
+
+          # GETs are safe to retry after a server error, requests with an Idempotency-Key will return the prior response
+          if response.kind_of?(Net::HTTPServerError) && request.is_a?(Net::HTTP::Get)
+            retries += 1
+            response = http.request(request) if retries < MAX_RETRIES
+          end
+
+          response
         rescue Errno::ECONNREFUSED, Errno::ECONNRESET, Errno::EHOSTUNREACH, Errno::ECONNABORTED,
                Errno::EPIPE, Errno::ETIMEDOUT, Net::OpenTimeout, EOFError, SocketError => ex
           retries += 1
@@ -167,10 +170,23 @@ module Recurly
       request["Authorization"] = "Basic #{Base64.encode64(@api_key)}".chomp
       request["User-Agent"] = "Recurly/#{VERSION}; #{RUBY_DESCRIPTION}"
 
+      unless request.is_a?(Net::HTTP::Get) || request.is_a?(Net::HTTP::Head)
+        request["Idempotency-Key"] ||= generate_idempotency_key
+      end
+
       # TODO this is undocumented until we finalize it
       additional_headers.each { |header, v| request[header] = v } if additional_headers
     end
 
+    # from https://github.com/rails/rails/blob/6-0-stable/activesupport/lib/active_support/core_ext/securerandom.rb
+    def generate_idempotency_key(n = 16)
+      SecureRandom.random_bytes(n).unpack("C*").map do |byte|
+        idx = byte % 64
+        idx = SecureRandom.random_number(36) if idx >= 36
+        BASE36_ALPHABET[idx]
+      end.join
+    end
+
     def set_http_options(http, options)
       http.open_timeout = options[:open_timeout] || 20
       http.read_timeout = options[:read_timeout] || 60
@@ -251,18 +267,23 @@ module Recurly
       @api_key = api_key
     end
 
-    def scope_by_site(path, **options)
-      if site = site_id || options[:site_id]
-        "/sites/#{site}#{path}"
+    def build_url(path, options)
+      path = scope_by_site(path, options)
+      if options.any?
+        "#{path}?#{URI.encode_www_form(options)}"
       else
         path
       end
     end
 
-    # Returns just the path and parameters so we can safely reuse the connection
-    def extract_path(uri_or_path)
-      uri = URI(uri_or_path)
-      uri.kind_of?(URI::HTTP) ? uri.request_uri : uri_or_path
+    def scope_by_site(path, **options)
+      if site = site_id || options[:site_id]
+        # Ensure that we are only including the site_id once because the Pager operations
+        # will use the cursor returned from the API which may already have these components
+        path.start_with?("/sites/#{site}") ? path : "/sites/#{site}#{path}"
+      else
+        path
+      end
     end
 
     def set_options(options)

data/lib/recurly/client/operations.rb

@@ -1235,6 +1235,18 @@ module Recurly
       put(path, body, Requests::CouponUpdate, **options)
     end
 
+    # Expire a coupon
+    #
+    # {https://developers.recurly.com/api/v2019-10-10#operation/deactivate_coupon deactivate_coupon api documenation}
+    #
+    # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
+    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @return [Resources::Coupon] The expired Coupon
+    def deactivate_coupon(coupon_id:, **options)
+      path = interpolate_path("/coupons/{coupon_id}", coupon_id: coupon_id)
+      delete(path, **options)
+    end
+
     # List unique coupon codes associated with a bulk coupon
     #
     # {https://developers.recurly.com/api/v2019-10-10#operation/list_unique_coupon_codes list_unique_coupon_codes api documenation}

data/lib/recurly/http.rb

@@ -4,7 +4,7 @@ module Recurly
       attr_accessor :status, :body, :request,
         :request_id, :rate_limit, :rate_limit_remaining,
         :rate_limit_reset, :date, :proxy_metadata,
-        :content_type
+        :content_type, :total_records
 
       def initialize(resp, request)
         @request = Request.new(request.method, request.path, request.body)
@@ -13,6 +13,7 @@ module Recurly
         @rate_limit = resp["x-ratelimit-limit"].to_i
         @rate_limit_remaining = resp["x-ratelimit-remaining"].to_i
         @rate_limit_reset = Time.at(resp["x-ratelimit-reset"].to_i).to_datetime
+        @total_records = resp["recurly-total-records"]&.to_i
         if resp["content-type"]
           @content_type = resp["content-type"].split(";").first
         else

data/lib/recurly/pager.rb

@@ -7,7 +7,25 @@ module Recurly
       @client = client
       @path = path
       @options = map_array_params(options)
-      @next = build_path(@path, @options)
+      rewind!
+    end
+
+    # Performs a request with the pager `limit` set to 1 and only returns the first
+    # result in the response.
+    def first
+      # Modify the @next url to set the :limit to 1
+      original_next = @next
+      @next = @path
+      fetch_next!(@options.merge(limit: 1))
+      # Restore the @next url to the original
+      @next = original_next
+      @data.first
+    end
+
+    # Makes a HEAD request to the API to determine how many total records exist.
+    def count
+      resource = @client.send(:head, self.next, @options)
+      resource.get_response.total_records
     end
 
     # Enumerates each "page" from the server.
@@ -84,7 +102,9 @@ module Recurly
     def page_enumerator
       Enumerator.new do |yielder|
         loop do
-          fetch_next!
+          # Pass in @options when requesting the first page (@data.empty?)
+          next_options = @data.empty? ? @options : {}
+          fetch_next!(next_options)
           yielder << data
           unless has_more?
             rewind!
@@ -94,8 +114,9 @@ module Recurly
       end
     end
 
-    def fetch_next!
-      page = @client.next_page(self)
+    def fetch_next!(options)
+      path = extract_path(self.next)
+      page = @client.send(:get, path, options)
       @data = page.data.map { |d| JSONParser.from_json(d) }
       @has_more = page.has_more
       @next = page.next
@@ -103,15 +124,13 @@ module Recurly
 
     def rewind!
       @data = []
-      @next = build_path(@path, @options)
+      @next = @path
     end
 
-    def build_path(path, options)
-      if options.empty?
-        path
-      else
-        "#{path}?#{URI.encode_www_form(options)}"
-      end
+    # Returns just the path and parameters so we can safely reuse the connection
+    def extract_path(uri_or_path)
+      uri = URI(uri_or_path)
+      uri.kind_of?(URI::HTTP) ? uri.request_uri : uri_or_path
     end
 
     # Converts array parameters to CSV strings to maintain consistency with
@@ -121,7 +140,7 @@ module Recurly
       @options = params.map do |key, param|
         new_param = param.is_a?(Array) ? param.join(",") : param
         [key, new_param]
-      end
+      end.to_h
     end
   end
 end

data/lib/recurly/requests/add_on_create.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :code, String
 
       # @!attribute currencies
-      #   @return [Array[AddOnPricing]] If `item_code`/`item_id` is part of the request and the item has a default currency then `currencies` is optional. If the item does not have a default currency, then `currencies` is required. If `item_code`/`item_id` is not present `currencies` is required.
+      #   @return [Array[AddOnPricing]] * If `item_code`/`item_id` is part of the request and the item has a default currency then `currencies` is optional. If the item does not have a default currency, then `currencies` is required. If `item_code`/`item_id` is not present `currencies` is required. * If the add-on's `tier_type` is `tiered`, `volume`, or `stairstep`, then `currencies` must be absent.
       define_attribute :currencies, Array, { :item_type => :AddOnPricing }
 
       # @!attribute default_quantity
@@ -38,6 +38,10 @@ module Recurly
       #   @return [String] Describes your add-on and will appear in subscribers' invoices. If `item_code`/`item_id` is part of the request then `name` must be absent. If `item_code`/`item_id` is not present `name` is required.
       define_attribute :name, String
 
+      # @!attribute optional
+      #   @return [Boolean] Whether the add-on is optional for the customer to include in their purchase on the hosted payment page. If false, the add-on will be included when a subscription is created through the Recurly UI. However, the add-on will not be included when a subscription is created through the API.
+      define_attribute :optional, :Boolean
+
       # @!attribute plan_id
       #   @return [String] Plan ID
       define_attribute :plan_id, String
@@ -49,6 +53,14 @@ module Recurly
       # @!attribute tax_code
       #   @return [String] Optional field used by Avalara, Vertex, and Recurly's EU VAT tax feature to determine taxation rules. If you have your own AvaTax or Vertex account configured, use their tax codes to assign specific tax rules. If you are using Recurly's EU VAT feature, you can use values of `unknown`, `physical`, or `digital`. If `item_code`/`item_id` is part of the request then `tax_code` must be absent.
       define_attribute :tax_code, String
+
+      # @!attribute tier_type
+      #   @return [String] The type of tiering used by the Add-on.
+      define_attribute :tier_type, String
+
+      # @!attribute tiers
+      #   @return [Array[Tier]] At least one tier is required if `tier_type` is not 'flat'.
+      define_attribute :tiers, Array, { :item_type => :Tier }
     end
   end
 end

data/lib/recurly/requests/add_on_update.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :code, String
 
       # @!attribute currencies
-      #   @return [Array[AddOnPricing]] Add-on pricing
+      #   @return [Array[AddOnPricing]] If the add-on's `tier_type` is `tiered`, `volume` or `stairstep`, then `currencies` must be absent.
       define_attribute :currencies, Array, { :item_type => :AddOnPricing }
 
       # @!attribute default_quantity
@@ -34,6 +34,10 @@ module Recurly
       #   @return [String] Describes your add-on and will appear in subscribers' invoices. If an `Item` is associated to the `AddOn` then `name` must be absent.
       define_attribute :name, String
 
+      # @!attribute optional
+      #   @return [Boolean] Whether the add-on is optional for the customer to include in their purchase on the hosted payment page. If false, the add-on will be included when a subscription is created through the Recurly UI. However, the add-on will not be included when a subscription is created through the API.
+      define_attribute :optional, :Boolean
+
       # @!attribute revenue_schedule_type
       #   @return [String] When this add-on is invoiced, the line item will use this revenue schedule. If an `Item` is associated to the `AddOn` then `revenue_schedule_type` must be absent in the request as the value will be set from the item.
       define_attribute :revenue_schedule_type, String
@@ -41,6 +45,10 @@ module Recurly
       # @!attribute tax_code
       #   @return [String] Optional field used by Avalara, Vertex, and Recurly's EU VAT tax feature to determine taxation rules. If you have your own AvaTax or Vertex account configured, use their tax codes to assign specific tax rules. If you are using Recurly's EU VAT feature, you can use values of `unknown`, `physical`, or `digital`. If an `Item` is associated to the `AddOn` then `tax code` must be absent.
       define_attribute :tax_code, String
+
+      # @!attribute tiers
+      #   @return [Array[Tier]] If tiers are provided in the request, all existing tiers on the Add-on will be removed and replaced by the tiers in the request.
+      define_attribute :tiers, Array, { :item_type => :Tier }
     end
   end
 end

data/lib/recurly/requests/billing_info_create.rb

@@ -6,6 +6,14 @@ module Recurly
   module Requests
     class BillingInfoCreate < Request
 
+      # @!attribute account_number
+      #   @return [String] The bank account number. (ACH only)
+      define_attribute :account_number, String
+
+      # @!attribute account_type
+      #   @return [String] The bank account type. (ACH only)
+      define_attribute :account_type, String
+
       # @!attribute address
       #   @return [Address]
       define_attribute :address, :Address
@@ -39,7 +47,7 @@ module Recurly
       define_attribute :gateway_token, String
 
       # @!attribute iban
-      #   @return [String] The International Bank Account Number, up to 34 alphanumeric characters comprising a country code; two check digits; and a number that includes the domestic bank account number, branch identifier, and potential routing information
+      #   @return [String] The International Bank Account Number, up to 34 alphanumeric characters comprising a country code; two check digits; and a number that includes the domestic bank account number, branch identifier, and potential routing information. (SEPA only)
       define_attribute :iban, String
 
       # @!attribute ip_address
@@ -54,6 +62,10 @@ module Recurly
       #   @return [String] Expiration month
       define_attribute :month, String
 
+      # @!attribute name_on_account
+      #   @return [String] The name associated with the bank account.
+      define_attribute :name_on_account, String
+
       # @!attribute number
       #   @return [String] Credit card number, spaces and dashes are accepted.
       define_attribute :number, String
@@ -62,6 +74,10 @@ module Recurly
       #   @return [String] PayPal billing agreement ID
       define_attribute :paypal_billing_agreement_id, String
 
+      # @!attribute routing_number
+      #   @return [String] The bank's rounting number. (ACH only)
+      define_attribute :routing_number, String
+
       # @!attribute three_d_secure_action_result_token_id
       #   @return [String] A token generated by Recurly.js after completing a 3-D Secure device fingerprinting or authentication challenge.
       define_attribute :three_d_secure_action_result_token_id, String

data/lib/recurly/requests/subscription_add_on_create.rb

@@ -18,8 +18,12 @@ module Recurly
       #   @return [String] Revenue schedule type
       define_attribute :revenue_schedule_type, String
 
+      # @!attribute tiers
+      #   @return [Array[SubscriptionAddOnTier]] If the plan add-on's `tier_type` is `flat`, then `tiers` must be absent.
+      define_attribute :tiers, Array, { :item_type => :SubscriptionAddOnTier }
+
       # @!attribute unit_amount
-      #   @return [Float] Optionally, override the add-on's default unit amount.
+      #   @return [Float] * Optionally, override the add-on's default unit amount. * If the plan add-on's `tier_type` is `tiered`, `volume`, or `stairstep`, then `unit_amount` must be absent.
       define_attribute :unit_amount, Float
     end
   end

data/lib/recurly/requests/subscription_add_on_tier.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Requests
+    class SubscriptionAddOnTier < Request
+
+      # @!attribute ending_quantity
+      #   @return [Integer] Ending quantity
+      define_attribute :ending_quantity, Integer
+
+      # @!attribute unit_amount
+      #   @return [Float] Unit amount
+      define_attribute :unit_amount, Float
+    end
+  end
+end

data/lib/recurly/requests/subscription_add_on_update.rb

@@ -22,6 +22,10 @@ module Recurly
       #   @return [String] Revenue schedule type
       define_attribute :revenue_schedule_type, String
 
+      # @!attribute tiers
+      #   @return [Array[SubscriptionAddOnTier]] If the plan add-on's `tier_type` is `flat`, then `tiers` must be absent.
+      define_attribute :tiers, Array, { :item_type => :SubscriptionAddOnTier }
+
       # @!attribute unit_amount
       #   @return [Float] Optionally, override the add-on's default unit amount.
       define_attribute :unit_amount, Float

data/lib/recurly/requests/tier.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Requests
+    class Tier < Request
+
+      # @!attribute currencies
+      #   @return [Array[Pricing]] Tier pricing
+      define_attribute :currencies, Array, { :item_type => :Pricing }
+
+      # @!attribute ending_quantity
+      #   @return [Integer] Ending quantity
+      define_attribute :ending_quantity, Integer
+    end
+  end
+end

data/lib/recurly/resources/add_on.rb

@@ -74,6 +74,14 @@ module Recurly
       #   @return [String] Used by Avalara, Vertex, and Recurly’s EU VAT tax feature. The tax code values are specific to each tax system. If you are using Recurly’s EU VAT feature you can use `unknown`, `physical`, or `digital`.
       define_attribute :tax_code, String
 
+      # @!attribute tier_type
+      #   @return [String] The type of tiering used by the Add-on.
+      define_attribute :tier_type, String
+
+      # @!attribute tiers
+      #   @return [Array[Tier]] Tiers
+      define_attribute :tiers, Array, { :item_type => :Tier }
+
       # @!attribute updated_at
       #   @return [DateTime] Last updated at
       define_attribute :updated_at, DateTime

data/lib/recurly/resources/subscription_add_on.rb

@@ -34,6 +34,14 @@ module Recurly
       #   @return [String] Subscription ID
       define_attribute :subscription_id, String
 
+      # @!attribute tier_type
+      #   @return [String] The type of tiering used by the Add-on.
+      define_attribute :tier_type, String
+
+      # @!attribute tiers
+      #   @return [Array[SubscriptionAddOnTier]] Empty unless `tier_type` is `tiered`, `volume`, or `stairstep`.
+      define_attribute :tiers, Array, { :item_type => :SubscriptionAddOnTier }
+
       # @!attribute unit_amount
       #   @return [Float] This is priced in the subscription's currency.
       define_attribute :unit_amount, Float

data/lib/recurly/resources/subscription_add_on_tier.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class SubscriptionAddOnTier < Resource
+
+      # @!attribute ending_quantity
+      #   @return [Integer] Ending quantity
+      define_attribute :ending_quantity, Integer
+
+      # @!attribute unit_amount
+      #   @return [Float] Unit amount
+      define_attribute :unit_amount, Float
+    end
+  end
+end

data/lib/recurly/resources/tier.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class Tier < Resource
+
+      # @!attribute currencies
+      #   @return [Array[Pricing]] Tier pricing
+      define_attribute :currencies, Array, { :item_type => :Pricing }
+
+      # @!attribute ending_quantity
+      #   @return [Integer] Ending quantity
+      define_attribute :ending_quantity, Integer
+    end
+  end
+end

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "3.4.1"
+  VERSION = "3.5.0"
 end

data/openapi/api.yaml

@@ -3998,6 +3998,11 @@ paths:
           foreach($account_subscriptions as $sub) {
               echo 'Account subscription: ' . $sub->getUuid() . PHP_EOL;
           }
+      - lang: Python
+        source: |
+          subscriptions = client.list_account_subscriptions(account.id, limit=200).items()
+          for subscription in subscriptions:
+              print(subscription.uuid)
   "/sites/{site_id}/accounts/{account_id}/transactions":
     get:
       tags:
@@ -4582,6 +4587,35 @@ paths:
               // probably re-raise and let our web framework and logger handle it
               var_dump($e);
           }
+    delete:
+      tags:
+      - coupon
+      operationId: deactivate_coupon
+      summary: Expire a coupon
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/coupon_id"
+      description: Mark an existing Coupon as expired
+      responses:
+        '200':
+          description: The expired Coupon
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Coupon"
+        '404':
+          description: Incorrect site or coupon ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
   "/sites/{site_id}/coupons/{coupon_id}/generate":
     post:
       tags:
@@ -12168,6 +12202,21 @@ components:
         item:
           "$ref": "#/components/schemas/ItemMini"
           readOnly: true
+        tier_type:
+          type: string
+          title: Tier type
+          description: The type of tiering used by the Add-on.
+          default: flat
+          enum:
+          - flat
+          - tiered
+          - stairstep
+          - volume
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/Tier"
         external_sku:
           type: string
           title: External SKU
@@ -12263,6 +12312,14 @@ components:
           title: Default quantity
           description: Default quantity for the hosted pages.
           default: 1
+        optional:
+          type: boolean
+          title: Optional
+          description: Whether the add-on is optional for the customer to include
+            in their purchase on the hosted payment page. If false, the add-on will
+            be included when a subscription is created through the Recurly UI. However,
+            the add-on will not be included when a subscription is created through
+            the API.
         tax_code:
           type: string
           title: Tax code
@@ -12279,10 +12336,29 @@ components:
           items:
             "$ref": "#/components/schemas/AddOnPricing"
           minItems: 1
-          description: If `item_code`/`item_id` is part of the request and the item
+          description: |
+            * If `item_code`/`item_id` is part of the request and the item
             has a default currency then `currencies` is optional. If the item does
             not have a default currency, then `currencies` is required. If `item_code`/`item_id`
             is not present `currencies` is required.
+            * If the add-on's `tier_type` is `tiered`, `volume`, or `stairstep`,
+            then `currencies` must be absent.
+        tier_type:
+          type: string
+          title: Tier type
+          description: The type of tiering used by the Add-on.
+          default: flat
+          enum:
+          - flat
+          - tiered
+          - stairstep
+          - volume
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/Tier"
+          description: At least one tier is required if `tier_type` is not 'flat'.
       required:
       - code
       - name
@@ -12349,12 +12425,31 @@ components:
           title: Default quantity
           description: Default quantity for the hosted pages.
           default: 1
+        optional:
+          type: boolean
+          title: Optional
+          description: Whether the add-on is optional for the customer to include
+            in their purchase on the hosted payment page. If false, the add-on will
+            be included when a subscription is created through the Recurly UI. However,
+            the add-on will not be included when a subscription is created through
+            the API.
         currencies:
           type: array
           title: Add-on pricing
           items:
             "$ref": "#/components/schemas/AddOnPricing"
           minItems: 1
+          description: |
+            If the add-on's `tier_type` is `tiered`, `volume` or `stairstep`,
+            then `currencies` must be absent.
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/Tier"
+          description: |
+            If tiers are provided in the request, all existing tiers on the Add-on will be
+            removed and replaced by the tiers in the request.
     BillingInfo:
       type: object
       properties:
@@ -12519,11 +12614,29 @@ components:
           maxLength: 22
         iban:
           type: string
-          maxLengh: 34
+          maxLength: 34
           description: The International Bank Account Number, up to 34 alphanumeric
             characters comprising a country code; two check digits; and a number that
             includes the domestic bank account number, branch identifier, and potential
-            routing information
+            routing information. (SEPA only)
+        name_on_account:
+          type: string
+          maxLength: 255
+          description: The name associated with the bank account.
+        account_number:
+          type: string
+          maxLength: 255
+          description: The bank account number. (ACH only)
+        routing_number:
+          type: string
+          maxLength: 15
+          description: The bank's rounting number. (ACH only)
+        account_type:
+          type: string
+          enum:
+          - checking
+          - savings
+          description: The bank account type. (ACH only)
     Coupon:
       type: object
       properties:
@@ -14885,6 +14998,23 @@ components:
       required:
       - currency
       - unit_amount
+    Tier:
+      type: object
+      properties:
+        ending_quantity:
+          type: integer
+          title: Ending quantity
+          minimum: 1
+          maximum: 999999999
+          default: 999999999
+        currencies:
+          type: array
+          title: Tier pricing
+          items:
+            "$ref": "#/components/schemas/Pricing"
+          minItems: 1
+      required:
+      - currencies
     Settings:
       type: object
       properties:
@@ -15486,6 +15616,23 @@ components:
           format: float
           title: Add-on unit price
           description: This is priced in the subscription's currency.
+        tier_type:
+          type: string
+          title: Tier type
+          description: The type of tiering used by the Add-on.
+          default: flat
+          enum:
+          - flat
+          - tiered
+          - stairstep
+          - volume
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/SubscriptionAddOnTier"
+          minItems: 1
+          description: Empty unless `tier_type` is `tiered`, `volume`, or `stairstep`.
         created_at:
           type: string
           format: date-time
@@ -15514,8 +15661,18 @@ components:
           type: number
           format: float
           title: Unit amount
-          description: Optionally, override the add-on's default unit amount.
+          description: |
+            * Optionally, override the add-on's default unit amount.
+            * If the plan add-on's `tier_type` is `tiered`, `volume`, or `stairstep`, then `unit_amount` must be absent.
           minimum: 0
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/SubscriptionAddOnTier"
+          minItems: 1
+          description: If the plan add-on's `tier_type` is `flat`, then `tiers` must
+            be absent.
         revenue_schedule_type:
           type: string
           title: Revenue schedule type
@@ -15548,6 +15705,14 @@ components:
           title: Unit amount
           description: Optionally, override the add-on's default unit amount.
           minimum: 0
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/SubscriptionAddOnTier"
+          minItems: 1
+          description: If the plan add-on's `tier_type` is `flat`, then `tiers` must
+            be absent.
         revenue_schedule_type:
           type: string
           title: Revenue schedule type
@@ -15556,6 +15721,20 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+    SubscriptionAddOnTier:
+      type: object
+      properties:
+        ending_quantity:
+          type: integer
+          title: Ending quantity
+          minimum: 1
+          maximum: 999999999
+          default: 999999999
+        unit_amount:
+          type: number
+          format: float
+          title: Unit amount
+          minimum: 0
     SubscriptionCancel:
       type: object
       properties:
@@ -16674,6 +16853,7 @@ components:
           - Maestro
           - MasterCard
           - Test Card
+          - Union Pay
           - Unknown
           - Visa
         first_six:

data/recurly.gemspec

@@ -14,6 +14,14 @@ Gem::Specification.new do |spec|
   spec.homepage = "https://github.com/recurly/recurly-client-ruby"
   spec.license = "MIT"
 
+  spec.metadata = {
+    "bug_tracker_uri" => "#{spec.homepage}/issues",
+    "changelog_uri" => "#{spec.homepage}/blob/master/CHANGELOG.md",
+    "documentation_uri" => "https://dev.recurly.com/docs",
+    "homepage_uri" => spec.homepage,
+    "source_code_uri" => "#{spec.homepage}/tree/#{spec.version}",
+  }
+
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end

data/scripts/changelog

@@ -6,6 +6,8 @@ if [ -z "$GITHUB_TOKEN" ]; then
 else
   if [ "$1" == "--pending" ]; then
     github_changelog_generator -t $GITHUB_TOKEN --unreleased-only -o "$2"
+  elif [ "$1" == "--release-tag" ]; then
+    github_changelog_generator -t $GITHUB_TOKEN --unreleased true --unreleased-label "$2"
   else
     github_changelog_generator -t $GITHUB_TOKEN
   fi

data/scripts/release

@@ -5,8 +5,8 @@ set -e
 RELEASED_LOG="/tmp/ruby-pending-changes.md"
 THIS_VERSION=$(./scripts/bump --this-version)
 
-# Finally need to update the full changelog
-./scripts/changelog
+# Generate the changelog with changes in this release
+./scripts/changelog --release-tag "$THIS_VERSION"
 git add CHANGELOG.md
 git commit -m "Update Changelog for Release $THIS_VERSION"
 git push origin master
@@ -27,4 +27,6 @@ echo ":ruby: Ruby $THIS_VERSION Released :ruby:"
 echo ":rubygems: Rubygems:  https://rubygems.org/gems/recurly/versions/$THIS_VERSION"
 echo "Release: https://github.com/recurly/recurly-client-ruby/releases/tag/$THIS_VERSION"
 echo "Changelog:"
-cat "$RELEASED_LOG"
+echo "\`\`\`"
+cat "$RELEASED_LOG"
+echo "\`\`\`"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 3.4.1
+  version: 3.5.0
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-26 00:00:00.000000000 Z
+date: 2020-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -118,6 +118,7 @@ files:
 - ".bumpversion.cfg"
 - ".github/ISSUE_TEMPLATE/bug-report.md"
 - ".github/ISSUE_TEMPLATE/question-or-other.md"
+- ".github/workflows/docs.yml"
 - ".github_changelog_generator"
 - ".gitignore"
 - ".rspec"
@@ -180,6 +181,7 @@ files:
 - lib/recurly/requests/shipping_fee_create.rb
 - lib/recurly/requests/shipping_purchase.rb
 - lib/recurly/requests/subscription_add_on_create.rb
+- lib/recurly/requests/subscription_add_on_tier.rb
 - lib/recurly/requests/subscription_add_on_update.rb
 - lib/recurly/requests/subscription_cancel.rb
 - lib/recurly/requests/subscription_change_create.rb
@@ -191,6 +193,7 @@ files:
 - lib/recurly/requests/subscription_shipping_purchase.rb
 - lib/recurly/requests/subscription_shipping_update.rb
 - lib/recurly/requests/subscription_update.rb
+- lib/recurly/requests/tier.rb
 - lib/recurly/resource.rb
 - lib/recurly/resources.rb
 - lib/recurly/resources/account.rb
@@ -241,9 +244,11 @@ files:
 - lib/recurly/resources/site.rb
 - lib/recurly/resources/subscription.rb
 - lib/recurly/resources/subscription_add_on.rb
+- lib/recurly/resources/subscription_add_on_tier.rb
 - lib/recurly/resources/subscription_change.rb
 - lib/recurly/resources/subscription_shipping.rb
 - lib/recurly/resources/tax_info.rb
+- lib/recurly/resources/tier.rb
 - lib/recurly/resources/transaction.rb
 - lib/recurly/resources/transaction_error.rb
 - lib/recurly/resources/transaction_payment_gateway.rb
@@ -270,7 +275,12 @@ files:
 homepage: https://github.com/recurly/recurly-client-ruby
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/recurly/recurly-client-ruby/issues
+  changelog_uri: https://github.com/recurly/recurly-client-ruby/blob/master/CHANGELOG.md
+  documentation_uri: https://dev.recurly.com/docs
+  homepage_uri: https://github.com/recurly/recurly-client-ruby
+  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/3.5.0
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -286,7 +296,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: The ruby client for Recurly's V3 API