recurly 4.1.0 → 4.5.0

data/lib/recurly/requests/address.rb

@@ -11,7 +11,7 @@ module Recurly
       define_attribute :city, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute phone

data/lib/recurly/requests/billing_info_create.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :amazon_billing_agreement_id, String
 
       # @!attribute backup_payment_method
-      #   @return [Boolean] The `backup_payment_method` indicator is used to designate a billing info as a backup on the account that will be tried if the billing info marked `primary_payment_method` fails. 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.
+      #   @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
@@ -67,15 +67,15 @@ 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
-      #   @return [String] Tax identifier is required if adding a billing info that is a consumer card in Brazil. This would be the customer's CPF, CPF is a Brazilian tax identifier for all tax paying residents.
+      #   @return [String] Tax identifier is required if adding a billing info that is a consumer card in Brazil or in Argentina. This would be the customer's CPF (Brazil) and CUIT (Argentina). CPF and CUIT are tax identifiers for all residents who pay taxes in Brazil and Argentina respectively.
       define_attribute :tax_identifier, String
 
       # @!attribute tax_identifier_type
-      #   @return [String] this field and a value of 'cpf' are required if adding a billing info that is an elo or hipercard type in Brazil.
+      #   @return [String] This field and a value of `cpf` or `cuit` are required if adding a billing info that is an elo or hipercard type in Brazil or in Argentina.
       define_attribute :tax_identifier_type, String
 
       # @!attribute three_d_secure_action_result_token_id

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/invoice_address.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :company, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute first_name

data/lib/recurly/requests/shipping_address_create.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :company, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute email

data/lib/recurly/requests/shipping_address_update.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :company, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute email

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_create.rb

@@ -99,7 +99,7 @@ module Recurly
       define_attribute :transaction_type, String
 
       # @!attribute trial_ends_at
-      #   @return [DateTime] If set, overrides the default trial behavior for the subscription. The date must be in the future.
+      #   @return [DateTime] If set, overrides the default trial behavior for the subscription. When the current date time or a past date time is provided the subscription will begin with no trial phase (overriding any plan default trial). When a future date time is provided the subscription will begin with a trial phase ending at the specified date time.
       define_attribute :trial_ends_at, DateTime
 
       # @!attribute unit_amount

data/lib/recurly/requests/subscription_purchase.rb

@@ -55,7 +55,7 @@ module Recurly
       define_attribute :total_billing_cycles, Integer
 
       # @!attribute trial_ends_at
-      #   @return [DateTime] If set, overrides the default trial behavior for the subscription. The date must be in the future.
+      #   @return [DateTime] If set, overrides the default trial behavior for the subscription. When the current date time or a past date time is provided the subscription will begin with no trial phase (overriding any plan default trial). When a future date time is provided the subscription will begin with a trial phase ending at the specified date time.
       define_attribute :trial_ends_at, DateTime
 
       # @!attribute unit_amount

data/lib/recurly/resources/address.rb

@@ -11,7 +11,7 @@ module Recurly
       define_attribute :city, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute phone

data/lib/recurly/resources/address_with_name.rb

@@ -11,7 +11,7 @@ module Recurly
       define_attribute :city, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute first_name

data/lib/recurly/resources/billing_info.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :address, :Address
 
       # @!attribute backup_payment_method
-      #   @return [Boolean] The `backup_payment_method` indicator is used to designate a billing info as a backup on the account that will be tried if the billing info marked `primary_payment_method` fails.
+      #   @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
@@ -51,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/billing_info_updated_by.rb

@@ -7,7 +7,7 @@ module Recurly
     class BillingInfoUpdatedBy < Resource
 
       # @!attribute country
-      #   @return [String] Country of IP address, if known by Recurly.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code matching the origin IP address, if known by Recurly.
       define_attribute :country, String
 
       # @!attribute ip

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/invoice_address.rb

@@ -15,7 +15,7 @@ module Recurly
       define_attribute :company, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute first_name

data/lib/recurly/resources/payment_method.rb

@@ -18,6 +18,10 @@ module Recurly
       #   @return [String] Visa, MasterCard, American Express, Discover, JCB, etc.
       define_attribute :card_type, String
 
+      # @!attribute cc_bin_country
+      #   @return [String] The 2-letter ISO 3166-1 alpha-2 country code associated with the credit card BIN, if known by Recurly. Available on the BillingInfo object only. Available when the BIN country lookup feature is enabled.
+      define_attribute :cc_bin_country, String
+
       # @!attribute exp_month
       #   @return [Integer] Expiration month.
       define_attribute :exp_month, Integer

data/lib/recurly/resources/shipping_address.rb

@@ -19,7 +19,7 @@ module Recurly
       define_attribute :company, String
 
       # @!attribute country
-      #   @return [String] Country, 2-letter ISO code.
+      #   @return [String] Country, 2-letter ISO 3166-1 alpha-2 code.
       define_attribute :country, String
 
       # @!attribute created_at

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]] 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.
+      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/transaction.rb

@@ -87,7 +87,7 @@ module Recurly
       define_attribute :invoice, :InvoiceMini
 
       # @!attribute ip_address_country
-      #   @return [String] IP address's country
+      #   @return [String] Origin IP address country, 2-letter ISO 3166-1 alpha-2 code, if known by Recurly.
       define_attribute :ip_address_country, String
 
       # @!attribute ip_address_v4

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "4.1.0"
+  VERSION = "4.5.0"
 end

data/openapi/api.yaml

@@ -111,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:
@@ -190,6 +192,7 @@ x-tagGroups:
   - note
   - account_acquisition
   - billing_info
+  - billing_infos
   - subscription
   - subscription_change
   - shipping_address
@@ -260,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
@@ -547,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"
@@ -650,8 +658,6 @@ paths:
       - account
       operationId: create_account
       summary: Create an account
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -899,7 +905,6 @@ paths:
           %s\", account.Id)"
   "/accounts/{account_id}":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/account_id"
     get:
       tags:
@@ -1288,7 +1293,6 @@ paths:
           Account: %s\", account.Id)"
   "/accounts/{account_id}/acquisition":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/account_id"
     get:
       tags:
@@ -1668,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:
@@ -1792,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:
@@ -1914,7 +1916,6 @@ paths:
       operationId: get_billing_info
       summary: Fetch an account's billing information
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -2050,7 +2051,6 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -2205,7 +2205,6 @@ paths:
       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
@@ -2307,16 +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:
-      - 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"
@@ -2344,9 +2473,9 @@ paths:
       x-code-samples: []
     post:
       tags:
-      - 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
@@ -2367,7 +2496,6 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -2405,11 +2533,10 @@ paths:
   "/accounts/{account_id}/billing_infos/{billing_info_id}":
     get:
       tags:
-      - 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:
@@ -2428,7 +2555,7 @@ paths:
       x-code-samples: []
     put:
       tags:
-      - billing_info
+      - billing_infos
       operationId: update_a_billing_info
       summary: Update an account's billing information
       description: |
@@ -2451,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:
@@ -2489,11 +2615,10 @@ paths:
       x-code-samples: []
     delete:
       tags:
-      - 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
@@ -2526,7 +2651,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/sort_dates"
@@ -2624,7 +2748,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"
       responses:
         '200':
@@ -2707,7 +2830,6 @@ paths:
       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:
@@ -2838,7 +2960,6 @@ paths:
       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':
@@ -2955,7 +3076,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/limit"
       - "$ref": "#/components/parameters/order"
@@ -3063,7 +3183,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"
@@ -3165,7 +3284,6 @@ paths:
       operationId: create_invoice
       summary: Create an invoice for pending line items
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -3336,7 +3454,6 @@ paths:
       operationId: preview_invoice
       summary: Preview new invoice for pending line items
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -3508,7 +3625,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"
@@ -3613,7 +3729,6 @@ paths:
       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:
@@ -3731,7 +3846,7 @@ paths:
           try {
               LineItemCreate lineItemCreate = new LineItemCreate();
               lineItemCreate.setCurrency("USD");
-              lineItemCreate.setUnitAmount(1000.0f);
+              lineItemCreate.setUnitAmount(new BigDecimal("1000.0"));
               lineItemCreate.setType(Constants.LineItemType.CHARGE); // choose "credit" for a credit
 
               LineItem lineItem = client.createLineItem(accountId, lineItemCreate);
@@ -3784,7 +3899,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"
       responses:
@@ -3871,7 +3985,6 @@ paths:
       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
@@ -4000,7 +4113,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"
@@ -4095,7 +4207,6 @@ paths:
       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:
@@ -4285,7 +4396,6 @@ paths:
       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:
@@ -4405,7 +4515,6 @@ paths:
       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:
@@ -4576,7 +4685,6 @@ paths:
       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:
@@ -4687,7 +4795,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"
@@ -4792,7 +4899,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"
@@ -4899,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"
@@ -4983,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"
@@ -5083,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"
@@ -5183,8 +5286,6 @@ paths:
       - coupon
       operationId: create_coupon
       summary: Create a new coupon
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -5325,7 +5426,7 @@ paths:
               List<CouponPricing> currencies = new ArrayList<CouponPricing>();
               CouponPricing couponPrice = new CouponPricing();
               couponPrice.setCurrency("USD");
-              couponPrice.setDiscount(10.0f);
+              couponPrice.setDiscount(new BigDecimal("10.0"));
               currencies.add(couponPrice);
 
               couponCreate.setCurrencies(currencies);
@@ -5384,7 +5485,6 @@ paths:
       operationId: get_coupon
       summary: Fetch a coupon
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       responses:
         '200':
@@ -5500,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:
@@ -5654,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:
@@ -5760,7 +5858,6 @@ paths:
       operationId: generate_unique_coupon_codes
       summary: Generate unique coupon codes
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -5806,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:
@@ -5855,7 +5951,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/coupon_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -5892,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"
@@ -5993,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':
@@ -6024,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"
@@ -6132,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':
@@ -6251,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"
@@ -6352,8 +6442,6 @@ paths:
       - item
       operationId: create_item
       summary: Create a new item
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -6566,7 +6654,6 @@ paths:
       operationId: get_item
       summary: Fetch an item
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/item_id"
       responses:
         '200':
@@ -6682,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:
@@ -6849,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.
@@ -6962,7 +7047,6 @@ paths:
           %s\", deactivatedItem.Code)"
   "/items/{item_id}/reactivate":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/item_id"
     put:
       tags:
@@ -7093,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"
@@ -7126,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:
@@ -7173,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':
@@ -7201,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:
@@ -7248,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':
@@ -7279,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"
@@ -7382,7 +7459,6 @@ paths:
       operationId: get_invoice
       summary: Fetch an invoice
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -7498,7 +7574,6 @@ paths:
       operationId: update_invoice
       summary: Update an invoice
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -7650,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':
@@ -7790,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:
@@ -7923,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':
@@ -8050,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':
@@ -8176,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':
@@ -8302,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':
@@ -8410,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:
@@ -8474,7 +8542,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/invoice_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -8585,7 +8652,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/invoice_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -8685,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':
@@ -8779,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:
@@ -8893,7 +8957,7 @@ paths:
               final InvoiceRefund invoiceRefund = new InvoiceRefund();
               invoiceRefund.setCreditCustomerNotes("Notes on credits");
               invoiceRefund.setType(Constants.InvoiceRefundType.AMOUNT); // could also be "line_items"
-              invoiceRefund.setAmount(100f);
+              invoiceRefund.setAmount(new BigDecimal("100"));
 
               final Invoice invoice = client.refundInvoice(invoiceId, invoiceRefund);
               System.out.println("Refunded invoice " + invoice.getNumber());
@@ -8942,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"
@@ -9049,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':
@@ -9165,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':
@@ -9286,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"
@@ -9387,8 +9447,6 @@ paths:
       - plan
       operationId: create_plan
       summary: Create a plan
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -9529,7 +9587,7 @@ paths:
               List<PlanPricing> currencies = new ArrayList<PlanPricing>();
               PlanPricing planPrice = new PlanPricing();
               planPrice.setCurrency("USD");
-              planPrice.setUnitAmount(10000.0f);
+              planPrice.setUnitAmount(new BigDecimal("10000"));
               currencies.add(planPrice);
 
               planCreate.setCurrencies(currencies);
@@ -9587,7 +9645,6 @@ paths:
       operationId: get_plan
       summary: Fetch a plan
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       responses:
         '200':
@@ -9703,7 +9760,6 @@ paths:
       operationId: update_plan
       summary: Update a plan
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       requestBody:
         content:
@@ -9850,7 +9906,6 @@ paths:
       operationId: remove_plan
       summary: Remove a plan
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       responses:
         '200':
@@ -9961,7 +10016,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/plan_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -10063,7 +10117,6 @@ paths:
       operationId: create_plan_add_on
       summary: Create an add-on
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
       requestBody:
         content:
@@ -10203,7 +10256,7 @@ paths:
               List<AddOnPricing> currencies = new ArrayList<AddOnPricing>();
               AddOnPricing addOnPrice = new AddOnPricing();
               addOnPrice.setCurrency("USD");
-              addOnPrice.setUnitAmount(10000.0f);
+              addOnPrice.setUnitAmount(new BigDecimal("10000.0"));
               currencies.add(addOnPrice);
 
               addOnCreate.setCurrencies(currencies);
@@ -10261,7 +10314,6 @@ paths:
       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:
@@ -10380,7 +10432,6 @@ paths:
       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:
@@ -10523,7 +10574,6 @@ paths:
       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:
@@ -10632,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"
@@ -10733,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':
@@ -10852,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"
@@ -10950,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:
@@ -10997,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':
@@ -11025,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:
@@ -11071,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.
@@ -11104,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"
@@ -11205,8 +11246,6 @@ paths:
       - subscription
       operationId: create_subscription
       summary: Create a new subscription
-      parameters:
-      - "$ref": "#/components/parameters/site_id"
       requestBody:
         content:
           application/json:
@@ -11385,7 +11424,6 @@ paths:
       operationId: get_subscription
       summary: Fetch a subscription
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -11506,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:
@@ -11655,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
@@ -11818,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:
@@ -11955,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':
@@ -12089,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:
@@ -12243,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':
@@ -12374,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,7 +12441,6 @@ paths:
       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,7 +12572,6 @@ paths:
       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:
@@ -12700,7 +12729,6 @@ paths:
       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.
@@ -12817,7 +12845,6 @@ paths:
       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:
@@ -12861,7 +12888,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/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -12966,7 +12992,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/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -13074,7 +13099,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/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -13170,7 +13194,6 @@ paths:
       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"
@@ -13212,7 +13235,6 @@ paths:
       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:
@@ -13260,7 +13282,6 @@ paths:
       operationId: get_usage
       summary: Get a usage record
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/usage_id"
       responses:
         '200':
@@ -13294,7 +13315,6 @@ paths:
       operationId: update_usage
       summary: Update a usage record
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/usage_id"
       requestBody:
         content:
@@ -13340,7 +13360,6 @@ paths:
       operationId: remove_usage
       summary: Delete a usage record.
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/usage_id"
       responses:
         '204':
@@ -13379,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"
@@ -13483,7 +13501,6 @@ paths:
       operationId: get_transaction
       summary: Fetch a transaction
       parameters:
-      - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/transaction_id"
       responses:
         '200':
@@ -13595,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:
@@ -13657,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:
@@ -13699,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:
@@ -13878,7 +13891,14 @@ paths:
               // why. You can find the invalid params and reasons in e.getError().getParams()
               System.out.println("Failed validation: " + e.getError().getMessage());
               System.out.println("Params: " + e.getError().getParams());
-          } catch (ApiException e) {
+          } catch (TransactionException e) {
+              TransactionError tError = e.getError().getTransactionError();
+              if (tError.getCategory() == Constants.ErrorCategory.THREE_D_SECURE_ACTION_REQUIRED) {
+                  String actionTokenId = tError.getThreeDSecureActionTokenId();
+                  System.out.println("Got 3DSecure TransactionError token: " + actionTokenId);
+              }
+          }
+          catch (ApiException e) {
               // Use ApiException to catch a generic error from the API
               System.out.println("Unexpected Recurly Error: " + e.getError().getMessage());
           }
@@ -13933,8 +13953,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:
@@ -14156,8 +14174,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
@@ -14269,7 +14285,6 @@ paths:
           for: \", date)\n}"
   "/export_dates/{export_date}/export_files":
     parameters:
-    - "$ref": "#/components/parameters/site_id"
     - "$ref": "#/components/parameters/export_date"
     get:
       tags:
@@ -15474,7 +15489,7 @@ components:
         country:
           type: string
           title: Country
-          description: Country, 2-letter ISO code.
+          description: Country, 2-letter ISO 3166-1 alpha-2 code.
     AddressWithName:
       allOf:
       - "$ref": "#/components/schemas/Address"
@@ -16029,19 +16044,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` indicator is used to designate
-            a billing info as a backup on the account that will be tried if the billing
-            info marked `primary_payment_method` fails.
+          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
@@ -16063,7 +16073,8 @@ components:
               maxLength: 20
             country:
               type: string
-              description: Country of IP address, if known by Recurly.
+              description: Country, 2-letter ISO 3166-1 alpha-2 code matching the
+                origin IP address, if known by Recurly.
               maxLength: 2
     BillingInfoCreate:
       type: object
@@ -16153,32 +16164,39 @@ components:
         tax_identifier:
           type: string
           description: Tax identifier is required if adding a billing info that is
-            a consumer card in Brazil. This would be the customer's CPF, CPF is a
-            Brazilian tax identifier for all tax paying residents.
+            a consumer card in Brazil or in Argentina. This would be the customer's
+            CPF (Brazil) and CUIT (Argentina). CPF and CUIT are tax identifiers for
+            all residents who pay taxes in Brazil and Argentina respectively.
         tax_identifier_type:
-          description: this field and a value of 'cpf' are required if adding a billing
-            info that is an elo or hipercard type in Brazil.
+          description: This field and a value of `cpf` or `cuit` are required if adding
+            a billing info that is an elo or hipercard type in Brazil or in Argentina.
           "$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` indicator is used to designate
-            a billing info as a backup on the account that will be tried if the billing
-            info marked `primary_payment_method` fails. 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.
+          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:
@@ -17220,7 +17238,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
@@ -18733,7 +18752,7 @@ components:
         country:
           type: string
           maxLength: 50
-          description: Country, 2-letter ISO code.
+          description: Country, 2-letter ISO 3166-1 alpha-2 code.
         created_at:
           type: string
           title: Created at
@@ -18788,7 +18807,7 @@ components:
         country:
           type: string
           maxLength: 50
-          description: Country, 2-letter ISO code.
+          description: Country, 2-letter ISO 3166-1 alpha-2 code.
       required:
       - first_name
       - last_name
@@ -19038,7 +19057,7 @@ components:
         country:
           type: string
           maxLength: 50
-          description: Country, 2-letter ISO code.
+          description: Country, 2-letter ISO 3166-1 alpha-2 code.
     Site:
       type: object
       properties:
@@ -19493,13 +19512,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:
@@ -19577,6 +19606,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:
@@ -19778,7 +19819,10 @@ components:
           format: date-time
           title: Trial ends at
           description: If set, overrides the default trial behavior for the subscription.
-            The date must be in the future.
+            When the current date time or a past date time is provided the subscription
+            will begin with no trial phase (overriding any plan default trial). When
+            a future date time is provided the subscription will begin with a trial
+            phase ending at the specified date time.
         starts_at:
           type: string
           format: date-time
@@ -19904,7 +19948,10 @@ components:
           format: date-time
           title: Trial ends at
           description: If set, overrides the default trial behavior for the subscription.
-            The date must be in the future.
+            When the current date time or a past date time is provided the subscription
+            will begin with no trial phase (overriding any plan default trial). When
+            a future date time is provided the subscription will begin with a trial
+            phase ending at the specified date time.
         starts_at:
           type: string
           format: date-time
@@ -20132,6 +20179,38 @@ components:
           type: number
           format: float
           title: Rate
+        tax_details:
+          type: array
+          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.
+          items:
+            "$ref": "#/components/schemas/TaxDetail"
+    TaxDetail:
+      type: object
+      title: Tax detail
+      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:
@@ -20228,7 +20307,8 @@ components:
             - When the merchant enters billing information using the UI, no IP address is recorded.
         ip_address_country:
           type: string
-          title: IP address's country
+          title: Origin IP address country, 2-letter ISO 3166-1 alpha-2 code, if known
+            by Recurly.
         status_code:
           type: string
           title: Status code
@@ -20713,6 +20793,11 @@ components:
           description: A token used in place of a credit card in order to perform
             transactions.
           maxLength: 50
+        cc_bin_country:
+          type: string
+          description: The 2-letter ISO 3166-1 alpha-2 country code associated with
+            the credit card BIN, if known by Recurly. Available on the BillingInfo
+            object only. Available when the BIN country lookup feature is enabled.
         gateway_code:
           type: string
           description: An identifier for a specific payment gateway.
@@ -21433,6 +21518,7 @@ components:
       - invalid_data
       - invalid_email
       - invalid_gateway_configuration
+      - invalid_gateway_access_token
       - invalid_issuer
       - invalid_login
       - invalid_merchant_type
@@ -21525,3 +21611,4 @@ components:
       type: string
       enum:
       - cpf
+      - cuit