recurly 4.67.0 → 4.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecdc59beffdb2d49c779442d7d3765d3f7bf38c5c2eb696f269534f019ea424c
-  data.tar.gz: 0ebe1b6e43e0e6381b69be1452908af55e02eba7aa70882d37a3debde3d78f75
+  metadata.gz: 5b47a550c5fcd45124c917ca4c4dba881b5b6d045bcba8ec50b9c17a62704f49
+  data.tar.gz: 4af34eb50bb46053e22ce93ce26939c2be6ead84f8e7b8697e77ecdbdcc1f2dd
 SHA512:
-  metadata.gz: 71afc7f777daeb723c2a7dfdeb292c82838dda1bcd6dd6d3a4b9c7984411efd0f797eac180c1366aebb90a04311a50dcb9fdfd9afe7e84d81070154c1a33a485
-  data.tar.gz: fb44979a290c16d34570e33f3ba965d920a9b749ba3ce5589c82a36bf92cc2dbe8372e4e57feb7d347d10b57e618d83c6fbe7fe7122d2430fad6b9307c282494
+  metadata.gz: 9cf13b027e609eedcb85f67af12a151ce40536ca3bf3e06adc4014b3fdb31cc8818f027d488b72419424a75ce0c0ec5034ea29c3584939ba809227f6c593b1f5
+  data.tar.gz: dcd17df5feb98ee03ae155e4067b4abbedb573c29c14ef2bb32317c5cde933d6007c9fb300856b9082186396cd347f02a6aa78f419ca4867c291da1c75c7153c

data/.bumpversion.cfg

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

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [4.69.0](https://github.com/recurly/recurly-client-ruby/tree/4.69.0) (2025-11-03)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.68.0...4.69.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 [#939](https://github.com/recurly/recurly-client-ruby/pull/939) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
+## [4.68.0](https://github.com/recurly/recurly-client-ruby/tree/4.68.0) (2025-10-09)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.67.0...4.68.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 [#936](https://github.com/recurly/recurly-client-ruby/pull/936) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
 ## [4.67.0](https://github.com/recurly/recurly-client-ruby/tree/4.67.0) (2025-08-13)
 
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.66.0...4.67.0)

data/GETTING_STARTED.md

@@ -5,7 +5,7 @@ This repository houses the official ruby client for Recurly's V3 API.
 In your Gemfile, add `recurly` as a dependency.
 
 ```ruby
-gem 'recurly', '~> 4.67'
+gem 'recurly', '~> 4.69'
 ```
 
 > *Note*: We try to follow [semantic versioning](https://semver.org/) and will only apply breaking changes to major versions.

data/lib/recurly/client/operations.rb

@@ -1113,6 +1113,21 @@ module Recurly
       pager(path, **options)
     end
 
+    # Create an account note
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_account_note create_account_note api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param body [Requests::AccountNoteCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountNoteCreate}
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::AccountNote] An account note.
+    #
+    def create_account_note(account_id:, body:, **options)
+      path = interpolate_path("/accounts/{account_id}/notes", account_id: account_id)
+      post(path, body, Requests::AccountNoteCreate, **options)
+    end
+
     # Fetch an account note
     #
     # {https://developers.recurly.com/api/v2021-02-25#operation/get_account_note get_account_note api documentation}
@@ -1140,6 +1155,21 @@ module Recurly
       get(path, **options)
     end
 
+    # Delete an account note
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_account_note remove_account_note api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param account_note_id [String] Account Note ID.
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::Empty] Account note deleted.
+    #
+    def remove_account_note(account_id:, account_note_id:, **options)
+      path = interpolate_path("/accounts/{account_id}/notes/{account_note_id}", account_id: account_id, account_note_id: account_note_id)
+      delete(path, **options)
+    end
+
     # Fetch a list of an account's shipping addresses
     #
     # {https://developers.recurly.com/api/v2021-02-25#operation/list_shipping_addresses list_shipping_addresses api documentation}

data/lib/recurly/requests/account_create.rb

@@ -14,6 +14,10 @@ module Recurly
       #   @return [Address]
       define_attribute :address, :Address
 
+      # @!attribute bill_date
+      #   @return [DateTime] The preferred billing date for the account. This date will be used as the billing date for when activating new subscriptions on the account.
+      define_attribute :bill_date, DateTime
+
       # @!attribute bill_to
       #   @return [String] An enumerable describing the billing behavior of the account, specifically whether the account is self-paying or will rely on the parent account to pay.
       define_attribute :bill_to, String

data/lib/recurly/requests/account_note_create.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 AccountNoteCreate < Request
+
+      # @!attribute message
+      #   @return [String] The content of the account note.
+      define_attribute :message, String
+    end
+  end
+end

data/lib/recurly/requests/account_purchase.rb

@@ -14,6 +14,10 @@ module Recurly
       #   @return [Address]
       define_attribute :address, :Address
 
+      # @!attribute bill_date
+      #   @return [DateTime] The preferred billing date for the account. This date will be used as the billing date for when activating new subscriptions on the account.
+      define_attribute :bill_date, DateTime
+
       # @!attribute bill_to
       #   @return [String] An enumerable describing the billing behavior of the account, specifically whether the account is self-paying or will rely on the parent account to pay.
       define_attribute :bill_to, String

data/lib/recurly/requests/account_update.rb

@@ -10,6 +10,10 @@ module Recurly
       #   @return [Address]
       define_attribute :address, :Address
 
+      # @!attribute bill_date
+      #   @return [DateTime] The preferred billing date for the account. This date will be used as the billing date for when activating new subscriptions on the account.
+      define_attribute :bill_date, DateTime
+
       # @!attribute bill_to
       #   @return [String] An enumerable describing the billing behavior of the account, specifically whether the account is self-paying or will rely on the parent account to pay.
       define_attribute :bill_to, String

data/lib/recurly/requests/add_on_create.rb

@@ -38,6 +38,10 @@ module Recurly
       #   @return [Boolean] Determines if the quantity field is displayed on the hosted pages for the add-on.
       define_attribute :display_quantity, :Boolean
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute item_code
       #   @return [String] Unique code to identify an item. Available when the `Credit Invoices` feature is enabled. If `item_id` and `item_code` are both present, `item_id` will be used.
       define_attribute :item_code, String

data/lib/recurly/requests/add_on_update.rb

@@ -34,6 +34,10 @@ module Recurly
       #   @return [Boolean] Determines if the quantity field is displayed on the hosted pages for the add-on.
       define_attribute :display_quantity, :Boolean
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute id
       #   @return [String] Add-on ID
       define_attribute :id, String

data/lib/recurly/requests/billing_info_create.rb

@@ -151,7 +151,7 @@ module Recurly
       define_attribute :transaction_type, String
 
       # @!attribute type
-      #   @return [String] The payment method type for a non-credit card based billing info. `bacs` and `becs` are the only accepted values.
+      #   @return [String] The payment method type for a non-credit card based billing info. `bacs`, `becs`, `pix-automatico`, `mercadopago` are the only accepted values.
       define_attribute :type, String
 
       # @!attribute vat_number

data/lib/recurly/requests/item_create.rb

@@ -38,6 +38,10 @@ module Recurly
       #   @return [String] Optional, stock keeping unit to link the item to other inventory systems.
       define_attribute :external_sku, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute liability_gl_account_id
       #   @return [String] The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.
       define_attribute :liability_gl_account_id, String

data/lib/recurly/requests/item_update.rb

@@ -38,6 +38,10 @@ module Recurly
       #   @return [String] Optional, stock keeping unit to link the item to other inventory systems.
       define_attribute :external_sku, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute liability_gl_account_id
       #   @return [String] The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.
       define_attribute :liability_gl_account_id, String

data/lib/recurly/requests/line_item_create.rb

@@ -42,6 +42,10 @@ module Recurly
       #   @return [DateTime] If this date is provided, it indicates the end of a time range.
       define_attribute :end_date, DateTime
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals. If `item_code`/`item_id` is part of the request then `harmonized_system_code` must be absent.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute item_code
       #   @return [String] Unique code to identify an item. Available when the Credit Invoices feature is enabled.
       define_attribute :item_code, String

data/lib/recurly/requests/plan_create.rb

@@ -50,6 +50,10 @@ module Recurly
       #   @return [String] Unique ID to identify a dunning campaign. Used to specify if a non-default dunning campaign should be assigned to this plan. For sites without multiple dunning campaigns enabled, the default dunning campaign will always be used.
       define_attribute :dunning_campaign_id, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute hosted_pages
       #   @return [PlanHostedPages] Hosted pages settings
       define_attribute :hosted_pages, :PlanHostedPages

data/lib/recurly/requests/plan_update.rb

@@ -46,6 +46,10 @@ module Recurly
       #   @return [String] Unique ID to identify a dunning campaign. Used to specify if a non-default dunning campaign should be assigned to this plan. For sites without multiple dunning campaigns enabled, the default dunning campaign will always be used.
       define_attribute :dunning_campaign_id, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute hosted_pages
       #   @return [PlanHostedPages] Hosted pages settings
       define_attribute :hosted_pages, :PlanHostedPages

data/lib/recurly/requests/subscription_create.rb

@@ -59,7 +59,7 @@ module Recurly
       define_attribute :customer_notes, String
 
       # @!attribute gateway_code
-      #   @return [String] If present, this subscription's transactions will use the payment gateway with this code.
+      #   @return [String] If present, this subscription's subsequent transactions will use the payment gateway with this code. To select a payment gateway to use when creating a Subscription, be sure to set the `account.billing_info.gateway_code` as well.
       define_attribute :gateway_code, String
 
       # @!attribute gift_card_redemption_code
@@ -94,6 +94,10 @@ module Recurly
       #   @return [String] The price segment ID, e.g. `e28zov4fw0v2`.
       define_attribute :price_segment_id, String
 
+      # @!attribute proration_settings
+      #   @return [SubscriptionCreateProrationSettings] Allows you to control how any resulting charges will be calculated and prorated.
+      define_attribute :proration_settings, :SubscriptionCreateProrationSettings
+
       # @!attribute quantity
       #   @return [Integer] Optionally override the default quantity of 1.
       define_attribute :quantity, Integer

data/lib/recurly/requests/subscription_create_proration_settings.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 SubscriptionCreateProrationSettings < Request
+
+      # @!attribute charge
+      #   @return [String] Determines how the amount charged is determined for this change
+      define_attribute :charge, String
+    end
+  end
+end

data/lib/recurly/requests/subscription_purchase.rb

@@ -38,6 +38,10 @@ module Recurly
       #   @return [String] The price segment ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For requests, the code can also be used. Use prefix `code-`, e.g. `code-gold`.
       define_attribute :price_segment_id, String
 
+      # @!attribute proration_settings
+      #   @return [SubscriptionCreateProrationSettings] Allows you to control how any resulting charges will be calculated and prorated.
+      define_attribute :proration_settings, :SubscriptionCreateProrationSettings
+
       # @!attribute quantity
       #   @return [Integer] Optionally override the default quantity of 1.
       define_attribute :quantity, Integer

data/lib/recurly/resources/account.rb

@@ -10,6 +10,10 @@ module Recurly
       #   @return [Address]
       define_attribute :address, :Address
 
+      # @!attribute bill_date
+      #   @return [DateTime] The preferred billing date for the account. This date will be used as the billing date for when activating new subscriptions on the account.
+      define_attribute :bill_date, DateTime
+
       # @!attribute bill_to
       #   @return [String] An enumerable describing the billing behavior of the account, specifically whether the account is self-paying or will rely on the parent account to pay.
       define_attribute :bill_to, String

data/lib/recurly/resources/add_on.rb

@@ -50,6 +50,10 @@ module Recurly
       #   @return [String] Optional, stock keeping unit to link the item to other inventory systems.
       define_attribute :external_sku, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute id
       #   @return [String] Add-on ID
       define_attribute :id, String

data/lib/recurly/resources/item.rb

@@ -46,6 +46,10 @@ module Recurly
       #   @return [String] Optional, stock keeping unit to link the item to other inventory systems.
       define_attribute :external_sku, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute id
       #   @return [String] Item ID
       define_attribute :id, String

data/lib/recurly/resources/line_item.rb

@@ -78,6 +78,10 @@ module Recurly
       #   @return [String] Optional Stock Keeping Unit assigned to an item. Available when the Credit Invoices feature is enabled.
       define_attribute :external_sku, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute id
       #   @return [String] Line item ID
       define_attribute :id, String

data/lib/recurly/resources/plan.rb

@@ -54,6 +54,10 @@ module Recurly
       #   @return [String] Unique ID to identify a dunning campaign. Used to specify if a non-default dunning campaign should be assigned to this plan. For sites without multiple dunning campaigns enabled, the default dunning campaign will always be used.
       define_attribute :dunning_campaign_id, String
 
+      # @!attribute harmonized_system_code
+      #   @return [String] The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. The HS code, sometimes called Commodity Code, is used by customs authorities around the world to identify products when assessing duties and taxes. The HS code may also be referred to as the tariff code or customs code. Values should contain only digits and decimals.
+      define_attribute :harmonized_system_code, String
+
       # @!attribute hosted_pages
       #   @return [PlanHostedPages] Hosted pages settings
       define_attribute :hosted_pages, :PlanHostedPages

data/lib/recurly/resources/transaction.rb

@@ -110,6 +110,10 @@ module Recurly
       #   @return [String] This conditional parameter is useful for merchants in specific industries who need to submit one-time Merchant Initiated transactions in specific cases. Not all gateways support these methods, but will support a generic one-time Merchant Initiated transaction. Only use this if the initiator value is "merchant". Otherwise, it will be ignored.   - Incremental: Send `incremental` with an additional purchase if the original authorization amount is not sufficient to cover the costs of your service or product. For example, if the customer adds goods or services or there are additional expenses.   - No Show: Send `no_show` if you charge customers a fee due to an agreed-upon cancellation policy in your industry.   - Resubmission: Send `resubmission` if you need to attempt collection on a declined transaction. You may also use the force collection behavior which has the same effect.   - Service Extension: Send `service_extension` if you are in a service industry and the customer has increased/extended their service in some way. For example: adding a day onto a car rental agreement.   - Split Shipment: Send `split_shipment` if you sell physical product and need to split up a shipment into multiple transactions when the customer is no longer in session.   - Top Up: Send `top_up` if you process one-time transactions based on a pre-arranged agreement with your customer where there is a pre-arranged account balance that needs maintaining. For example, if the customer has agreed to maintain an account balance of 30.00 and their current balance is 20.00, the MIT amount would be at least 10.00 to meet that 30.00 threshold.
       define_attribute :merchant_reason_code, String
 
+      # @!attribute next_action
+      #   @return [TransactionNextAction] Next action values are used for any required customer follow-up action. Currently, this is supported for Ebanx when using Pix Automatico.
+      define_attribute :next_action, :TransactionNextAction
+
       # @!attribute object
       #   @return [String] Object type
       define_attribute :object, String

data/lib/recurly/resources/transaction_next_action.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class TransactionNextAction < Resource
+
+      # @!attribute type
+      #   @return [String] The type of next action required.
+      define_attribute :type, String
+
+      # @!attribute value
+      #   @return [String] The value associated with the next action type.
+      define_attribute :value, String
+    end
+  end
+end

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "4.67.0"
+  VERSION = "4.69.0"
 end

data/openapi/api.yaml

@@ -4462,6 +4462,51 @@ paths:
           accountNotes.Fetch()\n\tif e, ok := err.(*recurly.Error); ok {\n\t\tfmt.Printf(\"Failed
           to retrieve next page: %v\", e)\n\t\tbreak\n\t}\n\tfor i, note := range
           accountNotes.Data() {\n\t\tfmt.Printf(\"Account Note %3d: %s\\n\",\n\t\t\ti,\n\t\t\tnote.Id,\n\t\t)\n\t}\n}"
+    post:
+      tags:
+      - note
+      operationId: create_account_note
+      summary: Create an account note
+      parameters:
+      - "$ref": "#/components/parameters/account_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/AccountNoteCreate"
+        required: true
+      responses:
+        '201':
+          description: An account note.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/AccountNote"
+        '400':
+          description: Bad request; perhaps missing or invalid parameters.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: A validation error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
   "/accounts/{account_id}/notes/{account_note_id}":
     get:
       tags:
@@ -4470,12 +4515,7 @@ paths:
       summary: Fetch an account note
       parameters:
       - "$ref": "#/components/parameters/account_id"
-      - name: account_note_id
-        in: path
-        description: Account Note ID.
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/account_note_id"
       responses:
         '200':
           description: An account note.
@@ -4588,6 +4628,30 @@ 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}\nfmt.Printf(\"Fetched Account
           Note: %v\", accountNote)"
+    delete:
+      tags:
+      - note
+      operationId: remove_account_note
+      summary: Delete an account note
+      parameters:
+      - "$ref": "#/components/parameters/account_id"
+      - "$ref": "#/components/parameters/account_note_id"
+      responses:
+        '204':
+          description: Account note deleted.
+        '404':
+          description: Incorrect site, account or note ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
   "/accounts/{account_id}/shipping_addresses":
     get:
       tags:
@@ -16941,6 +17005,13 @@ components:
       required: true
       schema:
         type: string
+    account_note_id:
+      name: account_note_id
+      in: path
+      description: Account Note ID.
+      required: true
+      schema:
+        type: string
     add_on_id:
       name: add_on_id
       in: path
@@ -18046,6 +18117,13 @@ components:
           description: The Avalara AvaTax value that can be passed to identify the
             customer type for tax purposes. The range of values can be A - R (more
             info at Avalara). Value is case-sensitive.
+        bill_date:
+          type: string
+          title: Bill Date
+          format: date-time
+          description: The preferred billing date for the account. This date will
+            be used as the billing date for when activating new subscriptions on the
+            account.
     AccountResponse:
       type: object
       properties:
@@ -18152,6 +18230,13 @@ components:
           description: The Avalara AvaTax value that can be passed to identify the
             customer type for tax purposes. The range of values can be A - R (more
             info at Avalara). Value is case-sensitive.
+        bill_date:
+          title: Bill Date
+          type: string
+          format: date-time
+          description: The preferred billing date for the account. This date will
+            be used as the billing date for when activating new subscriptions on the
+            account.
     AccountNote:
       type: object
       required:
@@ -18175,6 +18260,14 @@ components:
           type: string
           format: date-time
           readOnly: true
+    AccountNoteCreate:
+      type: object
+      required:
+      - message
+      properties:
+        message:
+          type: string
+          description: The content of the account note.
     AccountMini:
       type: object
       title: Account mini details
@@ -18280,9 +18373,11 @@ components:
         street1:
           type: string
           title: Street 1
+          maxLength: 50
         street2:
           type: string
           title: Street 2
+          maxLength: 50
         city:
           type: string
           title: City
@@ -18488,6 +18583,17 @@ components:
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes. If `item_code`/`item_id` is part of
             the request then `tax_code` must be absent.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          pattern: "^\\d+(\\.\\d+)*$"
+          maxLength: 25
         display_quantity:
           type: boolean
           title: Display quantity?
@@ -18710,6 +18816,17 @@ components:
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes. If `item_code`/`item_id` is part of
             the request then `tax_code` must be absent.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          pattern: "^\\d+(\\.\\d+)*$"
+          maxLength: 25
         currencies:
           type: array
           title: Add-on pricing
@@ -18865,6 +18982,17 @@ components:
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes. If an `Item` is associated to the
             `AddOn` then `tax_code` must be absent.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          pattern: "^\\d+(\\.\\d+)*$"
+          maxLength: 25
         display_quantity:
           type: boolean
           title: Display quantity?
@@ -20207,6 +20335,17 @@ components:
             codes using any of these tax integrations. For Recurly's In-the-Box tax
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          pattern: "^\\d+(\\.\\d+)*$"
+          maxLength: 25
         tax_exempt:
           type: boolean
           title: Tax exempt?
@@ -20317,6 +20456,17 @@ components:
             codes using any of these tax integrations. For Recurly's In-the-Box tax
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          pattern: "^\\d+(\\.\\d+)*$"
+          maxLength: 25
         tax_exempt:
           type: boolean
           title: Tax exempt?
@@ -20415,6 +20565,17 @@ components:
             codes using any of these tax integrations. For Recurly's In-the-Box tax
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System Code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          pattern: "^\\d+(\\.\\d+)*$"
+          maxLength: 25
         tax_exempt:
           type: boolean
           title: Tax exempt?
@@ -21310,6 +21471,17 @@ components:
             codes using any of these tax integrations. For Recurly's In-the-Box tax
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System Code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          maxLength: 25
+          pattern: "^\\d+(\\.\\d+)*$"
         tax_info:
           "$ref": "#/components/schemas/TaxInfo"
         origin_tax_address_source:
@@ -21554,6 +21726,18 @@ components:
             codes using any of these tax integrations. For Recurly's In-the-Box tax
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System Code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals. If `item_code`/`item_id` is part
+            of the request then `harmonized_system_code` must be absent.
+          maxLength: 25
+          pattern: "^\\d+(\\.\\d+)*$"
         product_code:
           type: string
           title: Product code
@@ -21749,6 +21933,17 @@ components:
             codes using any of these tax integrations. For Recurly's In-the-Box tax
             offering you can also choose to instead use simple values of `unknown`,
             `physical`, or `digital` tax codes.
+        harmonized_system_code:
+          type: string
+          title: Harmonized System Code
+          description: The Harmonized System (HS) code is an internationally standardized
+            system of names and numbers to classify traded products. The HS code,
+            sometimes called Commodity Code, is used by customs authorities around
+            the world to identify products when assessing duties and taxes. The HS
+            code may also be referred to as the tariff code or customs code. Values
+            should contain only digits and decimals.
+          maxLength: 25
+          pattern: "^\\d+(\\.\\d+)*$"
         tax_exempt:
           type: boolean
           title: Tax exempt?
@@ -22182,6 +22377,22 @@ components:
       - full_amount
       - prorated_amount
       - none
+    SubscriptionCreateProrationSettings:
+      type: object
+      title: Proration Settings
+      description: Allows you to control how any resulting charges will be calculated
+        and prorated.
+      properties:
+        charge:
+          "$ref": "#/components/schemas/SubscriptionCreateProrationSettingsChargeEnum"
+    SubscriptionCreateProrationSettingsChargeEnum:
+      type: string
+      title: Charge
+      description: Determines how the amount charged is determined for this change
+      default: prorated_amount
+      enum:
+      - full_amount
+      - prorated_amount
     Settings:
       type: object
       properties:
@@ -23768,8 +23979,10 @@ components:
         gateway_code:
           type: string
           title: Gateway Code
-          description: If present, this subscription's transactions will use the payment
-            gateway with this code.
+          description: If present, this subscription's subsequent transactions will
+            use the payment gateway with this code. To select a payment gateway to
+            use when creating a Subscription, be sure to set the `account.billing_info.gateway_code`
+            as well.
           maxLength: 13
         transaction_type:
           description: An optional type designation for the payment gateway transaction
@@ -23787,6 +24000,8 @@ components:
             second limit on creating subscriptions. Should only be used when creating
             subscriptions in bulk from the API.
           default: false
+        proration_settings:
+          "$ref": "#/components/schemas/SubscriptionCreateProrationSettings"
       required:
       - plan_code
       - currency
@@ -23898,6 +24113,8 @@ components:
             second limit on creating subscriptions. Should only be used when creating
             subscriptions in bulk from the API.
           default: false
+        proration_settings:
+          "$ref": "#/components/schemas/SubscriptionCreateProrationSettings"
       required:
       - plan_code
     SubscriptionUpdate:
@@ -24421,6 +24638,22 @@ components:
           title: VAT Number
         fraud_info:
           "$ref": "#/components/schemas/TransactionFraudInfo"
+        next_action:
+          type: object
+          x-class-name: TransactionNextAction
+          description: Next action values are used for any required customer follow-up
+            action. Currently, this is supported for Ebanx when using Pix Automatico.
+          properties:
+            type:
+              type: string
+              title: Next action type
+              description: The type of next action required.
+              "$ref": "#/components/schemas/NextActionTypeEnum"
+            value:
+              type: string
+              title: Next action value
+              description: The value associated with the next action type.
+          title: Next action
     TransactionFraudInfo:
       type: object
       title: Fraud information
@@ -26830,9 +27063,11 @@ components:
       - credit_card
       - eft
       - google_pay
+      - mercadopago
       - money_order
       - other
       - paypal
+      - pix_automatico
       - roku
       - sepadirectdebit
       - wire_transfer
@@ -26970,6 +27205,11 @@ components:
       - scheduled
       - success
       - void
+    NextActionTypeEnum:
+      type: string
+      description: The type of next action required for the transaction.
+      enum:
+      - qr_code
     CvvCheckEnum:
       type: string
       enum:
@@ -27046,6 +27286,9 @@ components:
       - boleto
       - cash_app
       - upi_autopay
+      - pix_automatico
+      - mercadopago
+      - klarna
     CardTypeEnum:
       type: string
       enum:
@@ -27371,10 +27614,12 @@ components:
     AchTypeEnum:
       type: string
       description: The payment method type for a non-credit card based billing info.
-        `bacs` and `becs` are the only accepted values.
+        `bacs`, `becs`, `pix-automatico`, `mercadopago` are the only accepted values.
       enum:
       - bacs
       - becs
+      - pix-automatico
+      - mercadopago
     AchAccountTypeEnum:
       type: string
       description: The bank account type. (ACH only)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 4.67.0
+  version: 4.69.0
 platform: ruby
 authors:
 - Recurly
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-13 00:00:00.000000000 Z
+date: 2025-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -167,6 +167,7 @@ files:
 - lib/recurly/requests/account_acquisition_update.rb
 - lib/recurly/requests/account_create.rb
 - lib/recurly/requests/account_external_subscription.rb
+- lib/recurly/requests/account_note_create.rb
 - lib/recurly/requests/account_purchase.rb
 - lib/recurly/requests/account_reference.rb
 - lib/recurly/requests/account_update.rb
@@ -244,6 +245,7 @@ files:
 - lib/recurly/requests/subscription_change_create.rb
 - lib/recurly/requests/subscription_change_shipping_create.rb
 - lib/recurly/requests/subscription_create.rb
+- lib/recurly/requests/subscription_create_proration_settings.rb
 - lib/recurly/requests/subscription_pause.rb
 - lib/recurly/requests/subscription_purchase.rb
 - lib/recurly/requests/subscription_ramp_interval.rb
@@ -354,6 +356,7 @@ files:
 - lib/recurly/resources/transaction.rb
 - lib/recurly/resources/transaction_error.rb
 - lib/recurly/resources/transaction_fraud_info.rb
+- lib/recurly/resources/transaction_next_action.rb
 - lib/recurly/resources/transaction_payment_gateway.rb
 - lib/recurly/resources/unique_coupon_code.rb
 - lib/recurly/resources/unique_coupon_code_params.rb
@@ -384,7 +387,7 @@ metadata:
   changelog_uri: https://github.com/recurly/recurly-client-ruby/blob/master/CHANGELOG.md
   documentation_uri: https://recurly.github.io/recurly-client-ruby/
   homepage_uri: https://github.com/recurly/recurly-client-ruby
-  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.67.0
+  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.69.0
 post_install_message:
 rdoc_options: []
 require_paths: