recurly 4.0.0 → 4.4.0

data/lib/recurly/errors.rb

@@ -47,4 +47,5 @@ module Recurly
   end
 
   require_relative "./errors/api_errors"
+  require_relative "./errors/network_errors"
 end

data/lib/recurly/errors/network_errors.rb

@@ -0,0 +1,7 @@
+module Recurly
+  module Errors
+    class NetworkError < APIError; end
+    class ConnectionFailedError < NetworkError; end
+    class SSLError < NetworkError; end
+  end
+end

data/lib/recurly/pager.rb

@@ -24,7 +24,7 @@ module Recurly
 
     # Makes a HEAD request to the API to determine how many total records exist.
     def count
-      resource = @client.send(:head, self.next, @options)
+      resource = @client.send(:head, self.next, **@options)
       resource.get_response.total_records
     end
 
@@ -116,7 +116,7 @@ module Recurly
 
     def fetch_next!(options)
       path = extract_path(self.next)
-      page = @client.send(:get, path, options)
+      page = @client.send(:get, path, **options)
       @data = page.data.map { |d| JSONParser.from_json(d) }
       @has_more = page.has_more
       @next = page.next

data/lib/recurly/requests/add_on_create.rb

@@ -79,11 +79,11 @@ module Recurly
       define_attribute :tier_type, String
 
       # @!attribute tiers
-      #   @return [Array[Tier]] If the tier_type is `flat`, then `tiers` must be absent. The `tiers` object must include one to many tiers with `ending_quantity` and `unit_amount` for the desired `currencies`. There must be one tier with an `ending_quantity` of 999999999 which is the default if not provided.
+      #   @return [Array[Tier]] If the tier_type is `flat`, then `tiers` must be absent. The `tiers` object must include one to many tiers with `ending_quantity` and `unit_amount` for the desired `currencies`, or alternatively, `usage_percentage` for usage percentage type usage add ons. There must be one tier with an `ending_quantity` of 999999999 which is the default if not provided.
       define_attribute :tiers, Array, { :item_type => :Tier }
 
       # @!attribute usage_percentage
-      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0. Required if `add_on_type` is usage and `usage_type` is percentage. Must be omitted otherwise. `usage_percentage` does not support tiers.
+      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0. Required if `add_on_type` is usage, `tier_type` is `flat` and `usage_type` is percentage. Must be omitted otherwise.
       define_attribute :usage_percentage, Float
 
       # @!attribute usage_type

data/lib/recurly/requests/add_on_update.rb

@@ -63,11 +63,11 @@ module Recurly
       define_attribute :tax_code, String
 
       # @!attribute tiers
-      #   @return [Array[Tier]] If the tier_type is `flat`, then `tiers` must be absent. The `tiers` object must include one to many tiers with `ending_quantity` and `unit_amount` for the desired `currencies`. There must be one tier with an `ending_quantity` of 999999999 which is the default if not provided.
+      #   @return [Array[Tier]] If the tier_type is `flat`, then `tiers` must be absent. The `tiers` object must include one to many tiers with `ending_quantity` and `unit_amount` for the desired `currencies`, or alternatively, `usage_percentage` for usage percentage type usage add ons. There must be one tier with an `ending_quantity` of 999999999 which is the default if not provided.
       define_attribute :tiers, Array, { :item_type => :Tier }
 
       # @!attribute usage_percentage
-      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0. Required if `add_on_type` is usage and `usage_type` is percentage. Must be omitted otherwise. `usage_percentage` does not support tiers.
+      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0. Required if `add_on_type` is usage, `tier_type` is `flat` and `usage_type` is percentage. Must be omitted otherwise.
       define_attribute :usage_percentage, Float
     end
   end

data/lib/recurly/requests/billing_info_create.rb

@@ -14,6 +14,10 @@ module Recurly
       #   @return [String] Amazon billing agreement ID
       define_attribute :amazon_billing_agreement_id, String
 
+      # @!attribute backup_payment_method
+      #   @return [Boolean] The `backup_payment_method` field is used to designate a billing info as a backup on the account that will be tried if the initial billing info used for an invoice is declined. All payment methods, including the billing info marked `primary_payment_method` can be set as a backup. An account can have a maximum of 1 backup, if a user sets a different payment method as a backup, the existing backup will no longer be marked as such.
+      define_attribute :backup_payment_method, :Boolean
+
       # @!attribute company
       #   @return [String] Company name
       define_attribute :company, String
@@ -63,7 +67,7 @@ module Recurly
       define_attribute :paypal_billing_agreement_id, String
 
       # @!attribute primary_payment_method
-      #   @return [Boolean] The `primary_payment_method` indicator is used to designate the primary billing info on the account. The first billing info created on an account will always become primary. Adding additional billing infos provides the flexibility to mark another billing info as primary, or adding additional non-primary billing infos. This can be accomplished by passing the `primary_payment_method` indicator. When adding billing infos via the billing_info and /accounts endpoints, this value is not permitted, and will return an error if provided.
+      #   @return [Boolean] The `primary_payment_method` field is used to designate the primary billing info on the account. The first billing info created on an account will always become primary. Adding additional billing infos provides the flexibility to mark another billing info as primary, or adding additional non-primary billing infos. This can be accomplished by passing the `primary_payment_method` with a value of `true`. When adding billing infos via the billing_info and /accounts endpoints, this value is not permitted, and will return an error if provided.
       define_attribute :primary_payment_method, :Boolean
 
       # @!attribute tax_identifier

data/lib/recurly/requests/billing_info_verify.rb

@@ -0,0 +1,14 @@
+# 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 BillingInfoVerify < Request
+
+      # @!attribute gateway_code
+      #   @return [String] An identifier for a specific payment gateway.
+      define_attribute :gateway_code, String
+    end
+  end
+end

data/lib/recurly/requests/subscription_add_on_tier.rb

@@ -11,12 +11,16 @@ module Recurly
       define_attribute :ending_quantity, Integer
 
       # @!attribute unit_amount
-      #   @return [Float] Allows up to 2 decimal places. Optionally, override the tiers' default unit amount.
+      #   @return [Float] Allows up to 2 decimal places. Optionally, override the tiers' default unit amount. If add-on's `add_on_type` is `usage` and `usage_type` is `percentage`, cannot be provided.
       define_attribute :unit_amount, Float
 
       # @!attribute unit_amount_decimal
-      #   @return [String] Allows up to 9 decimal places.  Optionally, override tiers' default unit amount. If `unit_amount_decimal` is provided, `unit_amount` cannot be provided.
+      #   @return [String] Allows up to 9 decimal places.  Optionally, override tiers' default unit amount. If `unit_amount_decimal` is provided, `unit_amount` cannot be provided. If add-on's `add_on_type` is `usage` and `usage_type` is `percentage`, cannot be provided.
       define_attribute :unit_amount_decimal, String
+
+      # @!attribute usage_percentage
+      #   @return [String] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places represented as a string. A value between 0.0 and 100.0. Optionally, override tiers' default usage percentage. Required if add-on's `add_on_type` is `usage` and `usage_type` is `percentage`. Must be omitted otherwise.
+      define_attribute :usage_percentage, String
     end
   end
 end

data/lib/recurly/requests/subscription_purchase.rb

@@ -59,7 +59,7 @@ module Recurly
       define_attribute :trial_ends_at, DateTime
 
       # @!attribute unit_amount
-      #   @return [Float] Override the unit amount of the subscription plan by setting this value in cents. If not provided, the subscription will inherit the price from the subscription plan for the provided currency.
+      #   @return [Float] Override the unit amount of the subscription plan by setting this value. If not provided, the subscription will inherit the price from the subscription plan for the provided currency.
       define_attribute :unit_amount, Float
     end
   end

data/lib/recurly/requests/tier.rb

@@ -11,8 +11,12 @@ module Recurly
       define_attribute :currencies, Array, { :item_type => :TierPricing }
 
       # @!attribute ending_quantity
-      #   @return [Integer] Ending quantity
+      #   @return [Integer] Ending quantity for the tier.  This represents a unit amount for unit-priced add ons, but for percentage type usage add ons, represents the site default currency in its minimum divisible unit.
       define_attribute :ending_quantity, Integer
+
+      # @!attribute usage_percentage
+      #   @return [String] Decimal usage percentage.
+      define_attribute :usage_percentage, String
     end
   end
 end

data/lib/recurly/resources/billing_info.rb

@@ -14,6 +14,10 @@ module Recurly
       #   @return [Address]
       define_attribute :address, :Address
 
+      # @!attribute backup_payment_method
+      #   @return [Boolean] The `backup_payment_method` field is used to indicate a billing info as a backup on the account that will be tried if the initial billing info used for an invoice is declined.
+      define_attribute :backup_payment_method, :Boolean
+
       # @!attribute company
       #   @return [String]
       define_attribute :company, String
@@ -47,7 +51,7 @@ module Recurly
       define_attribute :payment_method, :PaymentMethod
 
       # @!attribute primary_payment_method
-      #   @return [Boolean] The `primary_payment_method` indicator is used to designate the primary billing info on the account. The first billing info created on an account will always become primary. Adding additional billing infos provides the flexibility to mark another billing info as primary, or adding additional non-primary billing infos. This can be accomplished by passing the `primary_payment_method` indicator. When adding billing infos via the billing_info and /accounts endpoints, this value is not permitted, and will return an error if provided.
+      #   @return [Boolean] The `primary_payment_method` field is used to indicate the primary billing info on the account. The first billing info created on an account will always become primary. This payment method will be used
       define_attribute :primary_payment_method, :Boolean
 
       # @!attribute updated_at

data/lib/recurly/resources/invoice.rb

@@ -111,7 +111,7 @@ module Recurly
       define_attribute :subscription_ids, Array, { :item_type => String }
 
       # @!attribute subtotal
-      #   @return [Float] The summation of charges, discounts, and credits, before tax.
+      #   @return [Float] The summation of charges and credits, before discounts and taxes.
       define_attribute :subtotal, Float
 
       # @!attribute tax

data/lib/recurly/resources/subscription_add_on_tier.rb

@@ -11,12 +11,16 @@ module Recurly
       define_attribute :ending_quantity, Integer
 
       # @!attribute unit_amount
-      #   @return [Float] Allows up to 2 decimal places. Optionally, override the tiers' default unit amount.
+      #   @return [Float] Allows up to 2 decimal places. Optionally, override the tiers' default unit amount. If add-on's `add_on_type` is `usage` and `usage_type` is `percentage`, cannot be provided.
       define_attribute :unit_amount, Float
 
       # @!attribute unit_amount_decimal
-      #   @return [String] Allows up to 9 decimal places.  Optionally, override tiers' default unit amount. If `unit_amount_decimal` is provided, `unit_amount` cannot be provided.
+      #   @return [String] Allows up to 9 decimal places.  Optionally, override tiers' default unit amount. If `unit_amount_decimal` is provided, `unit_amount` cannot be provided. If add-on's `add_on_type` is `usage` and `usage_type` is `percentage`, cannot be provided.
       define_attribute :unit_amount_decimal, String
+
+      # @!attribute usage_percentage
+      #   @return [String] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places represented as a string. A value between 0.0 and 100.0. Optionally, override tiers' default usage percentage. Required if add-on's `add_on_type` is `usage` and `usage_type` is `percentage`. Must be omitted otherwise.
+      define_attribute :usage_percentage, String
     end
   end
 end

data/lib/recurly/resources/subscription_change.rb

@@ -18,6 +18,10 @@ module Recurly
       #   @return [Array[SubscriptionAddOn]] These add-ons will be used when the subscription renews.
       define_attribute :add_ons, Array, { :item_type => :SubscriptionAddOn }
 
+      # @!attribute billing_info
+      #   @return [SubscriptionChangeBillingInfo] Accept nested attributes for three_d_secure_action_result_token_id
+      define_attribute :billing_info, :SubscriptionChangeBillingInfo
+
       # @!attribute created_at
       #   @return [DateTime] Created at
       define_attribute :created_at, DateTime

data/lib/recurly/resources/subscription_change_billing_info.rb

@@ -0,0 +1,14 @@
+# 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 SubscriptionChangeBillingInfo < Resource
+
+      # @!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
+    end
+  end
+end

data/lib/recurly/resources/tax_detail.rb

@@ -0,0 +1,26 @@
+# 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 TaxDetail < Resource
+
+      # @!attribute rate
+      #   @return [Float] Provides the tax rate for the region.
+      define_attribute :rate, Float
+
+      # @!attribute region
+      #   @return [String] Provides the tax region applied on an invoice. For Canadian Sales Tax, this will be either the 2 letter province code or country code.
+      define_attribute :region, String
+
+      # @!attribute tax
+      #   @return [Float] The total tax applied for this tax type.
+      define_attribute :tax, Float
+
+      # @!attribute type
+      #   @return [String] Provides the tax type for the region. For Canadian Sales Tax, this will be GST, HST, QST or PST.
+      define_attribute :type, String
+    end
+  end
+end

data/lib/recurly/resources/tax_info.rb

@@ -14,6 +14,10 @@ module Recurly
       #   @return [String] Provides the tax region applied on an invoice. For U.S. Sales Tax, this will be the 2 letter state code. For EU VAT this will be the 2 letter country code. For all country level tax types, this will display the regional tax, like VAT, GST, or PST.
       define_attribute :region, String
 
+      # @!attribute tax_details
+      #   @return [Array[TaxDetail]]
+      define_attribute :tax_details, Array, { :item_type => :TaxDetail }
+
       # @!attribute type
       #   @return [String] Provides the tax type as "vat" for EU VAT, "usst" for U.S. Sales Tax, or the 2 letter country code for country level tax types like Canada, Australia, New Zealand, Israel, and all non-EU European countries.
       define_attribute :type, String

data/lib/recurly/resources/tier.rb

@@ -11,8 +11,12 @@ module Recurly
       define_attribute :currencies, Array, { :item_type => :TierPricing }
 
       # @!attribute ending_quantity
-      #   @return [Integer] Ending quantity
+      #   @return [Integer] Ending quantity for the tier.  This represents a unit amount for unit-priced add ons, but for percentage type usage add ons, represents the site default currency in its minimum divisible unit.
       define_attribute :ending_quantity, Integer
+
+      # @!attribute usage_percentage
+      #   @return [String] Decimal usage percentage.
+      define_attribute :usage_percentage, String
     end
   end
 end

data/lib/recurly/resources/transaction.rb

@@ -18,6 +18,10 @@ module Recurly
       #   @return [String] When processed, result from checking the overall AVS on the transaction.
       define_attribute :avs_check, String
 
+      # @!attribute backup_payment_method_used
+      #   @return [Boolean] Indicates if the transaction was completed using a backup payment
+      define_attribute :backup_payment_method_used, :Boolean
+
       # @!attribute billing_address
       #   @return [AddressWithName]
       define_attribute :billing_address, :AddressWithName

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "4.0.0"
+  VERSION = "4.4.0"
 end

data/openapi/api.yaml

@@ -24,6 +24,42 @@ info:
     Recurly-Version: recurly.v2021-02-25
     ```
 
+    Recurly's client libraries correspond with API versions as listed below.
+
+    <table>
+      <tr>
+        <th>API Version</th>
+        <th>Client Library Version</th>
+      </tr>
+      <tr>
+        <td>v2021-02-25</td>
+        <td>4.x</td>
+      </tr>
+      <tr>
+        <td>v2019-10-10</td>
+        <td>3.x</td>
+      </tr>
+    </table>
+
+    Client library releases:
+
+    * [Node.js](https://github.com/recurly/recurly-client-node/releases)
+    * [Python](https://github.com/recurly/recurly-client-python/releases)
+    * [.NET](https://github.com/recurly/recurly-client-dotnet/releases)
+    * [Ruby](https://github.com/recurly/recurly-client-ruby/releases)
+    * [Java](https://github.com/recurly/recurly-client-java/releases)
+    * [PHP](https://github.com/recurly/recurly-client-php/releases)
+    * [Go](https://github.com/recurly/recurly-client-go/releases)
+
+    Client libraries follow semantic versioning. For example, [Ruby client library
+    version 3.18.1](https://github.com/recurly/recurly-client-ruby/releases/tag/3.18.1)
+    represents major version `3`, minor version `18` with patch `1`.
+
+    We encourage you to update to the latest version of the API and corresponding client library,
+    as most recent versions are more performant than their predecessors. See the
+    [changelog](https://developers.recurly.com/api/changelog.html) for a comprehensive list of changes
+    introduced in the latest API version.
+
     ### Default Versions
     Specifying a version is required to get a successful response. If you wish to
     receive the latest version and are willing to accept the risk of breaking changes,
@@ -75,9 +111,11 @@ info:
     developers and those who are familiar with API technology. When using the
     API and passing error messages to target systems, be mindful that
     these messages may not make sense in the context of the target system.
-    Please consider changing these messages in target system to be better
+    Please consider changing these messages in the target system to be better
     suited to the audience of the system.
 
+    Please see [transaction error codes](https://developers.recurly.com/pages/api-transaction-errors.html) for more details.
+
     ## Pagination
     ### Response Schema
     Every GET listing endpoint returns a response with the same schema:
@@ -154,6 +192,7 @@ x-tagGroups:
   - note
   - account_acquisition
   - billing_info
+  - billing_infos
   - subscription
   - subscription_change
   - shipping_address
@@ -224,9 +263,15 @@ tags:
     to match this data with revenue and billing data events in Recurly.
 - name: billing_info
   x-displayName: Billing Info
-  description: An account can have one stored payment method at a time. This can be
-    a credit card, PayPal, or bank account. Billing info is usually filled out by
-    the customer upon purchase or when they update their information.
+  description: Without the premium Wallet feature, an account can only have one stored
+    payment method at a time. Examples include credit cards, PayPal, or bank accounts.
+    Billing info is filled out by the customer upon purchase or when they update their
+    information.
+- name: billing_infos
+  x-displayName: Billing Infos
+  description: If the premium Wallet feature is enabled, an account can have multiple
+    payment methods stored. Examples include credit cards, PayPal, or bank accounts.
+    Primary or backup billing infos can be designated from these endpoints.
 - name: subscription
   x-displayName: Subscription
   description: Subscriptions are created when your customers subscribe to one of your
@@ -511,7 +556,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -614,8 +658,6 @@ paths:
       - account
       operationId: create_account
       summary: Create an account
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -863,7 +905,6 @@ paths:
           %s\", account.Id)"
   "/accounts/{account_id}":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/account_id"
     get:
       tags:
@@ -1252,11 +1293,9 @@ paths:
           Account: %s\", account.Id)"
   "/accounts/{account_id}/acquisition":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/account_id"
     get:
       tags:
-      - account
       - account_acquisition
       operationId: get_account_acquisition
       summary: Fetch an account's acquisition data
@@ -1365,7 +1404,6 @@ paths:
           Acquisition: %v\", accountAcq.Id)"
     put:
       tags:
-      - account
       - account_acquisition
       operationId: update_account_acquisition
       summary: Update an account's acquisition data
@@ -1533,7 +1571,6 @@ paths:
           Acquisition: %s\", account.Id)"
     delete:
       tags:
-      - account
       - account_acquisition
       operationId: remove_account_acquisition
       summary: Remove an account's acquisition data
@@ -1635,7 +1672,6 @@ paths:
           Acquisition: %s\", accountAcquisition.Id)"
   "/accounts/{account_id}/reactivate":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/account_id"
     put:
       tags:
@@ -1759,7 +1795,6 @@ paths:
           Account: %s\", account.Id)"
   "/accounts/{account_id}/balance":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/account_id"
     get:
       tags:
@@ -1877,12 +1912,10 @@ paths:
   "/accounts/{account_id}/billing_info":
     get:
       tags:
-      - account
       - billing_info
       operationId: get_billing_info
       summary: Fetch an account's billing information
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -1995,14 +2028,13 @@ paths:
           Info: %v\", billingInfo)"
     put:
       tags:
-      - account
       - billing_info
       operationId: update_billing_info
       summary: Set an account's billing information
       description: |
         If you're using Recurly.js to securely submit data from webforms without sending it through your server,
         you can associate the billing information with an account by passing in the `token_id`. The only other
-        field permitted with `token_id` is `primary_payment_method`.
+        fields permitted with `token_id` are `primary_payment_method` and/or `backup_payment_method`.
 
         For credit card payments you'll need the following required fields:
 
@@ -2019,7 +2051,6 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -2170,12 +2201,10 @@ paths:
           Info: %s\", billingInfo)"
     delete:
       tags:
-      - account
       - billing_info
       operationId: remove_billing_info
       summary: Remove an account's billing information
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       description: You may remove any stored billing information for an account. If
         the account has a subscription, the renewal will go into dunning unless the
@@ -2277,17 +2306,146 @@ paths:
           {\n\t\tfmt.Printf(\"Resource not found: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
           Recurly error: %v\", e)\n\treturn nil, err\n}\n\nfmt.Printf(\"Removed Billing
           Info: %v\", billingInfo)"
+  "/accounts/{account_id}/billing_info/verify":
+    post:
+      tags:
+      - billing_info
+      operationId: verify_billing_info
+      summary: Verify an account's credit card billing information
+      parameters:
+      - "$ref": "#/components/parameters/account_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/BillingInfoVerify"
+        required: false
+      responses:
+        '200':
+          description: Transaction information from verify.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Transaction"
+        '404':
+          description: Account has no billing information, or incorrect site or account
+            ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Invalid billing information, or error running the verification
+            transaction.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ErrorMayHaveTransaction"
+      x-code-samples:
+      - lang: Node.js
+        source: |
+          try {
+            const transaction = await client.verifyBillingInfo(accountId)
+            console.log('Fetched Transaction: ', transaction.id)
+          } catch (err) {
+            if (err instanceof recurly.errors.NotFoundError) {
+              // If the request was not found, you may want to alert the user or
+              // just return null
+              console.log('Resource Not Found')
+            } else {
+              // If we don't know what to do with the err, we should
+              // probably re-raise and let our web framework and logger handle it
+              console.log('Unknown Error: ', err)
+            }
+          }
+      - lang: Python
+        source: |
+          try:
+              transaction = client.verify_billing_info(account_id)
+              print("Got Transaction %s" % transaction)
+          except recurly.errors.NotFoundError:
+              # If the resource was not found, you may want to alert the user or
+              # just return nil
+              print("Resource Not Found")
+      - lang: ".NET"
+        source: |
+          try
+          {
+              Transaction transaction = client.VerifyBillingInfo(accountId);
+              Console.WriteLine($"Fetched transaction {transaction.Id}");
+          }
+          catch (Recurly.Errors.NotFound ex)
+          {
+              // If the resource was not found
+              // we may want to alert the user or just return null
+              Console.WriteLine($"Resource Not Found: {ex.Error.Message}");
+          }
+          catch (Recurly.Errors.ApiError ex)
+          {
+              // Use ApiError to catch a generic error from the API
+              Console.WriteLine($"Unexpected Recurly Error: {ex.Error.Message}");
+          }
+      - lang: Ruby
+        source: |
+          begin
+            transaction = @client.verify_billing_info(account_id: account_id)
+            puts "Got Transaction #{transaction}"
+          rescue Recurly::Errors::NotFoundError
+            # If the resource was not found, you may want to alert the user or
+            # just return nil
+            puts "Resource Not Found"
+          end
+      - lang: Java
+        source: |
+          try {
+              final Transaction transaction = client.verifyBillingInfo(accountId);
+              System.out.println("Fetched transaction " + transaction.getId());
+          } catch (NotFoundException e) {
+              // If the resource was not found
+              // we may want to alert the user or just return null
+              System.out.println("Resource Not Found: " + e.getError().getMessage());
+          } catch (ApiException e) {
+              // Use ApiException to catch a generic error from the API
+              System.out.println("Unexpected Recurly Error: " + e.getError().getMessage());
+          }
+      - lang: PHP
+        source: |
+          try {
+              $transaction = $client->verifyBillingInfo($account_id);
+
+              echo 'Got Transaction:' . PHP_EOL;
+              var_dump($transaction);
+          } catch (\Recurly\Errors\NotFound $e) {
+              // Could not find the resource, you may want to inform the user
+              // or just return a NULL
+              echo 'Could not find resource.' . PHP_EOL;
+              var_dump($e);
+          } catch (\Recurly\RecurlyError $e) {
+              // Something bad happened... tell the user so that they can fix it?
+              echo 'Some unexpected Recurly error happened. Try again later.' . PHP_EOL;
+          }
+      - lang: Go
+        source: "verifyBillingInfoParams := &recurly.VerifyBillingInfoParams{}\ntransaction,
+          err := client.VerifyBillingInfo(accountID, verifyBillingInfoParams)\nif
+          e, ok := err.(*recurly.Error); ok {\n\tif e.Type == recurly.ErrorTypeNotFound
+          {\n\t\tfmt.Printf(\"Resource not found: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
+          Recurly error: %v\", e)\n\treturn nil, err\n}\n\nfmt.Printf(\"Fetched Transaction:
+          %v\", transaction)"
   "/accounts/{account_id}/billing_infos":
     get:
       tags:
-      - account
-      - billing_info
+      - billing_infos
       operationId: list_billing_infos
       summary: Get the list of billing information associated with an account
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -2315,14 +2473,13 @@ paths:
       x-code-samples: []
     post:
       tags:
-      - account
-      - billing_info
+      - billing_infos
       operationId: create_billing_info
-      summary: Set an account's billing information when the wallet feature is enabled
+      summary: Add new billing information on an account
       description: |
         If you're using Recurly.js to securely submit data from webforms without sending it through your server,
         you can associate the billing information with an account by passing in the `token_id`. The only other
-        field permitted with `token_id` is `primary_payment_method`.
+        fields permitted with `token_id` are `primary_payment_method` and/or `backup_payment_method`.
 
         For credit card payments you'll need the following required fields:
 
@@ -2339,7 +2496,6 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -2377,12 +2533,10 @@ paths:
   "/accounts/{account_id}/billing_infos/{billing_info_id}":
     get:
       tags:
-      - account
-      - billing_info
+      - billing_infos
       operationId: get_a_billing_info
       summary: Fetch a billing info
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       responses:
@@ -2401,14 +2555,13 @@ paths:
       x-code-samples: []
     put:
       tags:
-      - account
-      - billing_info
+      - billing_infos
       operationId: update_a_billing_info
       summary: Update an account's billing information
       description: |
         If you're using Recurly.js to securely submit data from webforms without sending it through your server,
         you can associate the billing information with an account by passing in the `token_id`. The only other
-        field permitted with `token_id` is `primary_payment_method`.
+        fields permitted with `token_id` are `primary_payment_method` and/or `backup_payment_method`.
 
         For credit card payments you'll need the following required fields:
 
@@ -2425,7 +2578,6 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       requestBody:
@@ -2463,12 +2615,10 @@ paths:
       x-code-samples: []
     delete:
       tags:
-      - account
-      - billing_info
+      - billing_infos
       operationId: remove_a_billing_info
       summary: Remove an account's billing information
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       description: You may remove any stored billing information for an account. If
@@ -2495,14 +2645,12 @@ paths:
   "/accounts/{account_id}/coupon_redemptions":
     get:
       tags:
-      - account
       - coupon_redemption
       operationId: list_account_coupon_redemptions
       summary: Show the coupon redemptions for an account
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -2594,14 +2742,12 @@ paths:
   "/accounts/{account_id}/coupon_redemptions/active":
     get:
       tags:
-      - account
       - coupon_redemption
       operationId: list_active_coupon_redemptions
       summary: Show the coupon redemptions that are active on an account
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -2680,12 +2826,10 @@ paths:
           }
     post:
       tags:
-      - account
       - coupon_redemption
       operationId: create_coupon_redemption
       summary: Generate an active coupon redemption on an account or subscription
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -2812,12 +2956,10 @@ paths:
           Redemption: %v\", couponRedemption)"
     delete:
       tags:
-      - account
       - coupon_redemption
       operationId: remove_coupon_redemption
       summary: Delete the active coupon redemption from an account
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -2928,14 +3070,12 @@ paths:
   "/accounts/{account_id}/credit_payments":
     get:
       tags:
-      - account
       - credit_payment
       operationId: list_account_credit_payments
       summary: List an account's credit payments
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -3038,13 +3178,11 @@ paths:
     get:
       tags:
       - invoice
-      - account
       operationId: list_account_invoices
       summary: List an account's invoices
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -3143,11 +3281,9 @@ paths:
     post:
       tags:
       - invoice
-      - account
       operationId: create_invoice
       summary: Create an invoice for pending line items
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -3315,11 +3451,9 @@ paths:
     post:
       tags:
       - invoice
-      - account
       operationId: preview_invoice
       summary: Preview new invoice for pending line items
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -3485,14 +3619,12 @@ paths:
   "/accounts/{account_id}/line_items":
     get:
       tags:
-      - account
       - line_item
       operationId: list_account_line_items
       summary: List an account's line items
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -3593,12 +3725,10 @@ paths:
           Line Item %3d: %s\\n\",\n\t\t\ti,\n\t\t\tlineItem.Id,\n\t\t)\n\t}\n}"
     post:
       tags:
-      - account
       - line_item
       operationId: create_line_item
       summary: Create a new line item for the account
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -3763,14 +3893,12 @@ paths:
   "/accounts/{account_id}/notes":
     get:
       tags:
-      - account
       - note
       operationId: list_account_notes
       summary: Fetch a list of an account's notes
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       responses:
@@ -3853,12 +3981,10 @@ paths:
   "/accounts/{account_id}/notes/{account_note_id}":
     get:
       tags:
-      - account
       - note
       operationId: get_account_note
       summary: Fetch an account note
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - name: account_note_id
         in: path
@@ -3981,14 +4107,12 @@ paths:
   "/accounts/{account_id}/shipping_addresses":
     get:
       tags:
-      - account
       - shipping_address
       operationId: list_shipping_addresses
       summary: Fetch a list of an account's shipping addresses
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -4079,12 +4203,10 @@ paths:
           Address %3d: %s, %s\\n\",\n\t\t\ti,\n\t\t\tshippingAddress.Id,\n\t\t\tshippingAddress.Street1,\n\t\t)\n\t}\n}"
     post:
       tags:
-      - account
       - shipping_address
       operationId: create_shipping_address
       summary: Create a new shipping address for the account
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -4270,12 +4392,10 @@ paths:
   "/accounts/{account_id}/shipping_addresses/{shipping_address_id}":
     get:
       tags:
-      - account
       - shipping_address
       operationId: get_shipping_address
       summary: Fetch an account's shipping address
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/shipping_address_id"
       responses:
@@ -4391,12 +4511,10 @@ paths:
           Address: %v\", shippingAddress)"
     put:
       tags:
-      - account
       - shipping_address
       operationId: update_shipping_address
       summary: Update an account's shipping address
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/shipping_address_id"
       requestBody:
@@ -4563,12 +4681,10 @@ paths:
           shippingAddress)"
     delete:
       tags:
-      - account
       - shipping_address
       operationId: remove_shipping_address
       summary: Remove an account's shipping address
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/shipping_address_id"
       responses:
@@ -4674,13 +4790,11 @@ paths:
     get:
       tags:
       - subscription
-      - account
       operationId: list_account_subscriptions
       summary: List an account's subscriptions
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -4779,14 +4893,12 @@ paths:
   "/accounts/{account_id}/transactions":
     get:
       tags:
-      - account
       - transaction
       operationId: list_account_transactions
       summary: List an account's transactions
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -4893,7 +5005,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -4977,7 +5088,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -5077,7 +5187,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -5177,8 +5286,6 @@ paths:
       - coupon
       operationId: create_coupon
       summary: Create a new coupon
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -5378,7 +5485,6 @@ paths:
       operationId: get_coupon
       summary: Fetch a coupon
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       responses:
         '200':
@@ -5494,7 +5600,6 @@ paths:
       operationId: update_coupon
       summary: Update an active coupon
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -5648,7 +5753,6 @@ paths:
       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:
@@ -5750,12 +5854,10 @@ paths:
   "/coupons/{coupon_id}/generate":
     post:
       tags:
-      - coupon
       - unique_coupon_code
       operationId: generate_unique_coupon_codes
       summary: Generate unique coupon codes
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -5801,7 +5903,6 @@ paths:
       description: Make an expired coupon redeemable again. You can change editable
         fields in this call.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -5844,14 +5945,12 @@ paths:
   "/coupons/{coupon_id}/unique_coupon_codes":
     get:
       tags:
-      - coupon
       - unique_coupon_code
       operationId: list_unique_coupon_codes
       summary: List unique coupon codes associated with a bulk coupon
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -5888,7 +5987,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
       - "$ref": "#/components/parameters/sort_dates"
@@ -5989,7 +6087,6 @@ paths:
       operationId: get_credit_payment
       summary: Fetch a credit payment
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/credit_payment_id"
       responses:
         '200':
@@ -6020,7 +6117,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -6128,7 +6224,6 @@ paths:
       operationId: get_custom_field_definition
       summary: Fetch an custom field definition
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/custom_field_definition_id"
       responses:
         '200':
@@ -6247,7 +6342,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -6348,8 +6442,6 @@ paths:
       - item
       operationId: create_item
       summary: Create a new item
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -6562,7 +6654,6 @@ paths:
       operationId: get_item
       summary: Fetch an item
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/item_id"
       responses:
         '200':
@@ -6678,7 +6769,6 @@ paths:
       operationId: update_item
       summary: Update an active item
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/item_id"
       requestBody:
         content:
@@ -6845,7 +6935,6 @@ paths:
       operationId: deactivate_item
       summary: Deactivate an item
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/item_id"
       description: Deactivating an item makes it unavailable for new purchases. It
         will not affect existing line items.
@@ -6958,7 +7047,6 @@ paths:
           %s\", deactivatedItem.Code)"
   "/items/{item_id}/reactivate":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/item_id"
     put:
       tags:
@@ -7089,7 +7177,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -7122,8 +7209,6 @@ paths:
       - measured_unit
       operationId: create_measured_unit
       summary: Create a new measured unit
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -7169,7 +7254,6 @@ paths:
       operationId: get_measured_unit
       summary: Fetch a measured unit
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/measured_unit_id"
       responses:
         '200':
@@ -7197,7 +7281,6 @@ paths:
       operationId: update_measured_unit
       summary: Update a measured unit
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/measured_unit_id"
       requestBody:
         content:
@@ -7244,7 +7327,6 @@ paths:
       summary: Remove a measured unit
       description: A mesured unit cannot be deleted if it is used by an active plan.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/measured_unit_id"
       responses:
         '200':
@@ -7275,7 +7357,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -7378,7 +7459,6 @@ paths:
       operationId: get_invoice
       summary: Fetch an invoice
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -7494,7 +7574,6 @@ paths:
       operationId: update_invoice
       summary: Update an invoice
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -7646,7 +7725,6 @@ paths:
       operationId: get_invoice_pdf
       summary: Fetch an invoice as a PDF
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -7786,7 +7864,6 @@ paths:
       description: Force a collection attempt using the stored billing information.
         This will trigger a transaction outside of Recurly's normal retry logic.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -7919,7 +7996,6 @@ paths:
 
         Only invoices with the `pending`, `processing` or `past_due` states can be marked as failed.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -8046,7 +8122,6 @@ paths:
 
         Only invoices with the `pending`, `processing`, `past_due` or `failed` states can be marked as paid.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -8172,7 +8247,6 @@ paths:
       operationId: reopen_invoice
       summary: Reopen a closed, manual invoice
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -8298,7 +8372,6 @@ paths:
       description: Invoice must be a credit invoice (`type=credit`) and cannot be
         closed (`state=closed`), processing (`state=processing`), or already voided.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -8406,7 +8479,6 @@ paths:
         not captured through your gateway. It will throw an error for an auto-collecting
         invoice.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -8464,14 +8536,12 @@ paths:
   "/invoices/{invoice_id}/line_items":
     get:
       tags:
-      - invoice
       - line_item
       operationId: list_invoice_line_items
       summary: List an invoice's line items
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -8576,14 +8646,12 @@ paths:
   "/invoices/{invoice_id}/coupon_redemptions":
     get:
       tags:
-      - invoice
       - coupon_redemption
       operationId: list_invoice_coupon_redemptions
       summary: Show the coupon redemptions applied to an invoice
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -8683,7 +8751,6 @@ paths:
 
         See the [Pagination Guide](/guides/pagination.html) to learn how to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -8777,7 +8844,6 @@ paths:
         If you want to refund the entire refundable amount on the invoice, the
         simplest way is to do `type=amount` without specifiying an `amount`.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -8940,7 +9006,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -9047,7 +9112,6 @@ paths:
       operationId: get_line_item
       summary: Fetch a line item
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/line_item_id"
       responses:
         '200':
@@ -9163,7 +9227,6 @@ paths:
       operationId: remove_line_item
       summary: Delete an uninvoiced line item
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/line_item_id"
       responses:
         '204':
@@ -9284,7 +9347,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -9385,8 +9447,6 @@ paths:
       - plan
       operationId: create_plan
       summary: Create a plan
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -9585,7 +9645,6 @@ paths:
       operationId: get_plan
       summary: Fetch a plan
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       responses:
         '200':
@@ -9701,7 +9760,6 @@ paths:
       operationId: update_plan
       summary: Update a plan
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       requestBody:
         content:
@@ -9848,7 +9906,6 @@ paths:
       operationId: remove_plan
       summary: Remove a plan
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       responses:
         '200':
@@ -9954,13 +10011,11 @@ paths:
     get:
       tags:
       - add-on
-      - plan
       operationId: list_plan_add_ons
       summary: List a plan's add-ons
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -10059,11 +10114,9 @@ paths:
     post:
       tags:
       - add-on
-      - plan
       operationId: create_plan_add_on
       summary: Create an add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       requestBody:
         content:
@@ -10257,12 +10310,10 @@ paths:
   "/plans/{plan_id}/add_ons/{add_on_id}":
     get:
       tags:
-      - plan
       - add-on
       operationId: get_plan_add_on
       summary: Fetch a plan's add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/add_on_id"
       responses:
@@ -10377,12 +10428,10 @@ paths:
           Add-On: %v\", planAddOn)"
     put:
       tags:
-      - plan
       - add-on
       operationId: update_plan_add_on
       summary: Update an add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/add_on_id"
       requestBody:
@@ -10521,12 +10570,10 @@ paths:
           Add-On: %v\", planAddOn)"
     delete:
       tags:
-      - plan
       - add-on
       operationId: remove_plan_add_on
       summary: Remove an add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/add_on_id"
       responses:
@@ -10635,7 +10682,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -10736,7 +10782,6 @@ paths:
       operationId: get_add_on
       summary: Fetch an add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/add_on_id"
       responses:
         '200':
@@ -10855,7 +10900,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -10953,8 +10997,6 @@ paths:
       - shipping_method
       operationId: create_shipping_method
       summary: Create a new shipping method
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -11000,7 +11042,6 @@ paths:
       operationId: get_shipping_method
       summary: Fetch a shipping method
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/shipping_method_id"
       responses:
         '200':
@@ -11028,7 +11069,6 @@ paths:
       operationId: update_shipping_method
       summary: Update an active Shipping Method
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/shipping_method_id"
       requestBody:
         content:
@@ -11074,7 +11114,6 @@ paths:
       operationId: deactivate_shipping_method
       summary: Deactivate a shipping method
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/shipping_method_id"
       description: Deactivating a shipping method makes it unavailable for new subscriptions
         or purchases. It will not affect existing subscriptions.
@@ -11107,7 +11146,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -11208,8 +11246,6 @@ paths:
       - subscription
       operationId: create_subscription
       summary: Create a new subscription
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -11314,8 +11350,7 @@ paths:
             subscription_create = {
               plan_code: plan_code,
               currency: "USD",
-              # This can be an existing account or
-              # a new acocunt
+              # This can be an existing account or a new account
               account: {
                 code: account_code,
               }
@@ -11389,7 +11424,6 @@ paths:
       operationId: get_subscription
       summary: Fetch a subscription
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -11510,7 +11544,6 @@ paths:
         impact on the billed amount. Use the [Create Subscription Change](#operation/create_subscription_change)
         endpoint to make those changes.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -11659,7 +11692,6 @@ paths:
 
         If the subscription has a paid invoice you may choose to refund all, part or none of last invoice's amount.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       - name: refund
         in: query
@@ -11822,7 +11854,6 @@ paths:
         until the end of the billing cycle. When a future subscription (`state=future`)
         is canceled it becomes failed `state=failed` and cannot be reactivated.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -11959,7 +11990,6 @@ paths:
 
         Expired or failed subscriptions cannot be reactivated; instead a new subscription plan will need to be applied to the account.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -12093,7 +12123,6 @@ paths:
 
         Expired, cancelled, or failed subscriptions cannot be paused.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -12247,7 +12276,6 @@ paths:
         The subscription must be in the paused state. Active, expired, cancelled,
         or failed subscriptions cannot be resumed.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -12378,7 +12406,6 @@ paths:
         in trial. The subscription must be in a trial. Active, paused, expired, cancelled,
         or failed subscriptions cannot be converted.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -12410,12 +12437,10 @@ paths:
   "/subscriptions/{subscription_id}/change":
     get:
       tags:
-      - subscription
       - subscription_change
       operationId: get_subscription_change
       summary: Fetch a subscription's pending change
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -12542,13 +12567,11 @@ paths:
           change: %s\", subscriptionChange.Id)"
     post:
       tags:
-      - subscription
       - subscription_change
       operationId: create_subscription_change
       summary: Create a new subscription change
       description: Calling this will overwrite an existing, pending subscription change.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -12702,12 +12725,10 @@ paths:
           changed: %s\", subscriptionChange.Id)"
     delete:
       tags:
-      - subscription
       - subscription_change
       operationId: remove_subscription_change
       summary: Delete the pending subscription change
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       description: Deleting the pending subscription change will cause the current
         subscription settings to be used on the next renewal.
@@ -12818,14 +12839,12 @@ paths:
   "/subscriptions/{subscription_id}/change/preview":
     post:
       tags:
-      - subscription
       - subscription_change
       operationId: preview_subscription_change
       summary: Preview a new subscription change
       description: Calling this will not save the subscription change or overwrite
         an existing change.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -12864,13 +12883,11 @@ paths:
     get:
       tags:
       - invoice
-      - subscription
       operationId: list_subscription_invoices
       summary: List a subscription's invoices
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -12969,13 +12986,12 @@ paths:
   "/subscriptions/{subscription_id}/line_items":
     get:
       tags:
-      - subscription
+      - line_item
       operationId: list_subscription_line_items
       summary: List a subscription's line items
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -13077,14 +13093,12 @@ paths:
   "/subscriptions/{subscription_id}/coupon_redemptions":
     get:
       tags:
-      - subscription
       - coupon_redemption
       operationId: list_subscription_coupon_redemptions
       summary: Show the coupon redemptions for a subscription
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -13176,13 +13190,10 @@ paths:
   "/subscriptions/{subscription_id}/add_ons/{add_on_id}/usage":
     get:
       tags:
-      - invoice
-      - subscription
       - usage
       operationId: list_usage
       summary: List a subscription add-on's usage records
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/add_on_id"
       - "$ref": "#/components/parameters/ids"
@@ -13220,13 +13231,10 @@ paths:
       x-code-samples: []
     post:
       tags:
-      - invoice
-      - subscription
       - usage
       operationId: create_usage
       summary: Log a usage record on this subscription add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/add_on_id"
       requestBody:
@@ -13270,13 +13278,10 @@ paths:
   "/usage/{usage_id}":
     get:
       tags:
-      - invoice
-      - subscription
       - usage
       operationId: get_usage
       summary: Get a usage record
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/usage_id"
       responses:
         '200':
@@ -13306,13 +13311,10 @@ paths:
       x-code-samples: []
     put:
       tags:
-      - invoice
-      - subscription
       - usage
       operationId: update_usage
       summary: Update a usage record
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/usage_id"
       requestBody:
         content:
@@ -13354,13 +13356,10 @@ paths:
       x-code-samples: []
     delete:
       tags:
-      - invoice
-      - subscription
       - usage
       operationId: remove_usage
       summary: Delete a usage record.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/usage_id"
       responses:
         '204':
@@ -13399,7 +13398,6 @@ paths:
       description: See the [Pagination Guide](/guides/pagination.html) to learn how
         to use pagination in the API and Client Libraries.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -13503,7 +13501,6 @@ paths:
       operationId: get_transaction
       summary: Fetch a transaction
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/transaction_id"
       responses:
         '200':
@@ -13615,7 +13612,6 @@ paths:
           %v\", transaction.Id)"
   "/unique_coupon_codes/{unique_coupon_code_id}":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/unique_coupon_code_id"
     get:
       tags:
@@ -13677,7 +13673,6 @@ paths:
       x-code-samples: []
   "/unique_coupon_codes/{unique_coupon_code_id}/restore":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/unique_coupon_code_id"
     put:
       tags:
@@ -13719,8 +13714,6 @@ paths:
       description: A purchase is a checkout containing at least one or more subscriptions
         or one-time charges (line items) and supports both coupon and gift card redemptions.
         All items purchased will be on one invoice and paid for with one transaction.
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -13953,8 +13946,6 @@ paths:
       description: A purchase is a checkout containing at least one or more subscriptions
         or one-time charges (line items) and supports both coupon and gift card redemptions.
         All items purchased will be on one invoice and paid for with one transaction.
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -14176,8 +14167,6 @@ paths:
           Recurly error: %v\", e)\n\treturn nil, err\n}\nfmt.Printf(\"Preview Charge
           Invoice %v\", collection.ChargeInvoice)"
   "/export_dates":
-    parameters:
-    - "$ref": "#/components/parameters/site_id"
     get:
       tags:
       - automated_exports
@@ -14289,7 +14278,6 @@ paths:
           for: \", date)\n}"
   "/export_dates/{export_date}/export_files":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/export_date"
     get:
       tags:
@@ -15755,8 +15743,8 @@ components:
           title: Usage Percentage
           description: The percentage taken of the monetary amount of usage tracked.
             This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
-            if `add_on_type` is usage and `usage_type` is percentage. Must be omitted
-            otherwise. `usage_percentage` does not support tiers.
+            if `add_on_type` is usage, `tier_type` is `flat` and `usage_type` is percentage.
+            Must be omitted otherwise.
         measured_unit_id:
           type: string
           title: Measured Unit ID
@@ -15862,7 +15850,7 @@ components:
           description: |
             If the tier_type is `flat`, then `tiers` must be absent. The `tiers` object
             must include one to many tiers with `ending_quantity` and `unit_amount` for
-            the desired `currencies`. There must be one tier with an `ending_quantity`
+            the desired `currencies`, or alternatively, `usage_percentage` for usage percentage type usage add ons. There must be one tier with an `ending_quantity`
             of 999999999 which is the default if not provided.
       required:
       - code
@@ -15895,8 +15883,8 @@ components:
           title: Usage Percentage
           description: The percentage taken of the monetary amount of usage tracked.
             This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
-            if `add_on_type` is usage and `usage_type` is percentage. Must be omitted
-            otherwise. `usage_percentage` does not support tiers.
+            if `add_on_type` is usage, `tier_type` is `flat` and `usage_type` is percentage.
+            Must be omitted otherwise.
         measured_unit_id:
           type: string
           title: Measured Unit ID
@@ -15991,7 +15979,7 @@ components:
           description: |
             If the tier_type is `flat`, then `tiers` must be absent. The `tiers` object
             must include one to many tiers with `ending_quantity` and `unit_amount` for
-            the desired `currencies`. There must be one tier with an `ending_quantity`
+            the desired `currencies`, or alternatively, `usage_percentage` for usage percentage type usage add ons. There must be one tier with an `ending_quantity`
             of 999999999 which is the default if not provided.
     BillingInfo:
       type: object
@@ -16049,14 +16037,14 @@ components:
               title: Kount rules
         primary_payment_method:
           type: boolean
-          description: The `primary_payment_method` indicator is used to designate
-            the primary billing info on the account. The first billing info created
-            on an account will always become primary. Adding additional billing infos
-            provides the flexibility to mark another billing info as primary, or adding
-            additional non-primary billing infos. This can be accomplished by passing
-            the `primary_payment_method` indicator. When adding billing infos via
-            the billing_info and /accounts endpoints, this value is not permitted,
-            and will return an error if provided.
+          description: The `primary_payment_method` field is used to indicate the
+            primary billing info on the account. The first billing info created on
+            an account will always become primary. This payment method will be used
+        backup_payment_method:
+          type: boolean
+          description: The `backup_payment_method` field is used to indicate a billing
+            info as a backup on the account that will be tried if the initial billing
+            info used for an invoice is declined.
         created_at:
           type: string
           format: date-time
@@ -16171,22 +16159,35 @@ components:
             a consumer card in Brazil. This would be the customer's CPF, CPF is a
             Brazilian tax identifier for all tax paying residents.
         tax_identifier_type:
-          type: string
-          enum:
-            "$ref": "#/components/schemas/TaxIdentifierTypeEnum"
           description: this field and a value of 'cpf' are required if adding a billing
             info that is an elo or hipercard type in Brazil.
+          "$ref": "#/components/schemas/TaxIdentifierTypeEnum"
         primary_payment_method:
           type: boolean
           title: Primary Payment Method
-          description: The `primary_payment_method` indicator is used to designate
-            the primary billing info on the account. The first billing info created
-            on an account will always become primary. Adding additional billing infos
+          description: The `primary_payment_method` field is used to designate the
+            primary billing info on the account. The first billing info created on
+            an account will always become primary. Adding additional billing infos
             provides the flexibility to mark another billing info as primary, or adding
             additional non-primary billing infos. This can be accomplished by passing
-            the `primary_payment_method` indicator. When adding billing infos via
-            the billing_info and /accounts endpoints, this value is not permitted,
-            and will return an error if provided.
+            the `primary_payment_method` with a value of `true`. When adding billing
+            infos via the billing_info and /accounts endpoints, this value is not
+            permitted, and will return an error if provided.
+        backup_payment_method:
+          type: boolean
+          description: The `backup_payment_method` field is used to designate a billing
+            info as a backup on the account that will be tried if the initial billing
+            info used for an invoice is declined. All payment methods, including the
+            billing info marked `primary_payment_method` can be set as a backup. An
+            account can have a maximum of 1 backup, if a user sets a different payment
+            method as a backup, the existing backup will no longer be marked as such.
+    BillingInfoVerify:
+      type: object
+      properties:
+        gateway_code:
+          type: string
+          description: An identifier for a specific payment gateway.
+          maxLength: 13
     Coupon:
       type: object
       properties:
@@ -17228,7 +17229,8 @@ components:
           type: number
           format: float
           title: Subtotal
-          description: The summation of charges, discounts, and credits, before tax.
+          description: The summation of charges and credits, before discounts and
+            taxes.
         tax:
           type: number
           format: float
@@ -18646,17 +18648,22 @@ components:
         ending_quantity:
           type: integer
           title: Ending quantity
+          description: Ending quantity for the tier.  This represents a unit amount
+            for unit-priced add ons, but for percentage type usage add ons, represents
+            the site default currency in its minimum divisible unit.
           minimum: 1
           maximum: 999999999
           default: 999999999
+        usage_percentage:
+          type: string
+          title: Usage Percentage
+          description: Decimal usage percentage.
         currencies:
           type: array
           title: Tier pricing
           items:
             "$ref": "#/components/schemas/TierPricing"
           minItems: 1
-      required:
-      - currencies
     Settings:
       type: object
       properties:
@@ -19496,13 +19503,23 @@ components:
           minimum: 0
           maximum: 1000000
           description: Allows up to 2 decimal places. Optionally, override the tiers'
-            default unit amount.
+            default unit amount. If add-on's `add_on_type` is `usage` and `usage_type`
+            is `percentage`, cannot be provided.
         unit_amount_decimal:
           type: string
           title: Unit amount decimal
           description: |
             Allows up to 9 decimal places.  Optionally, override tiers' default unit amount.
             If `unit_amount_decimal` is provided, `unit_amount` cannot be provided.
+            If add-on's `add_on_type` is `usage` and `usage_type` is `percentage`, cannot be provided.
+        usage_percentage:
+          type: string
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places represented as a string. A value between
+            0.0 and 100.0. Optionally, override tiers' default usage percentage. Required
+            if add-on's `add_on_type` is `usage` and `usage_type` is `percentage`.
+            Must be omitted otherwise.
     SubscriptionCancel:
       type: object
       properties:
@@ -19580,6 +19597,18 @@ components:
           format: date-time
           title: Deleted at
           readOnly: true
+        billing_info:
+          "$ref": "#/components/schemas/SubscriptionChangeBillingInfo"
+    SubscriptionChangeBillingInfo:
+      type: object
+      description: Accept nested attributes for three_d_secure_action_result_token_id
+      properties:
+        three_d_secure_action_result_token_id:
+          type: string
+          title: 3-D Secure action result token ID
+          description: A token generated by Recurly.js after completing a 3-D Secure
+            device fingerprinting or authentication challenge.
+          maxLength: 22
     SubscriptionChangeCreate:
       type: object
       properties:
@@ -19880,8 +19909,8 @@ components:
           format: float
           title: Custom subscription pricing
           description: Override the unit amount of the subscription plan by setting
-            this value in cents. If not provided, the subscription will inherit the
-            price from the subscription plan for the provided currency.
+            this value. If not provided, the subscription will inherit the price from
+            the subscription plan for the provided currency.
           minimum: 0
           maximum: 1000000
         quantity:
@@ -20135,6 +20164,38 @@ components:
           type: number
           format: float
           title: Rate
+        tax_details:
+          type: array
+          items:
+            "$ref": "#/components/schemas/TaxDetail"
+    TaxDetail:
+      type: object
+      title: Tax info
+      description: Provides additional tax details for Canadian Sales Tax when there
+        is tax applied at both the country and province levels. This will only be
+        populated for the Invoice response when fetching a single invoice and not
+        for the InvoiceList or LineItem.
+      properties:
+        type:
+          type: string
+          title: Type
+          description: Provides the tax type for the region. For Canadian Sales Tax,
+            this will be GST, HST, QST or PST.
+        region:
+          type: string
+          title: Region
+          description: Provides the tax region applied on an invoice. For Canadian
+            Sales Tax, this will be either the 2 letter province code or country code.
+        rate:
+          type: number
+          format: float
+          title: Rate
+          description: Provides the tax rate for the region.
+        tax:
+          type: number
+          format: float
+          title: Tax
+          description: The total tax applied for this tax type.
     Transaction:
       type: object
       properties:
@@ -20205,6 +20266,10 @@ components:
           type: boolean
           title: Success?
           description: Did this transaction complete successfully?
+        backup_payment_method_used:
+          type: boolean
+          title: Backup Payment Method Used?
+          description: Indicates if the transaction was completed using a backup payment
         refunded:
           type: boolean
           title: Refunded?