adyen-ruby-api-library 11.3.0 → 12.0.0

data/lib/adyen/services/management/donation_campaigns_api.rb

@@ -0,0 +1,64 @@
+require_relative '../service'
+module Adyen
+
+  # NOTE: This class is auto generated by OpenAPI Generator
+  # Ref: https://openapi-generator.tech
+  #
+  # Do not edit the class manually.
+  class DonationCampaignsApi < Service
+    attr_accessor :service, :version
+
+    def initialize(client, version = DEFAULT_VERSION)
+      super(client, version, 'Management')
+    end
+
+    # Create a donation campaign
+    def create_donation_campaign(request, company_id, headers: {})
+      endpoint = build_endpoint('/companies/{companyId}/campaignManagement', company_id)
+      
+      action = { method: 'post', url: endpoint }
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    # Delete a donation campaign
+    def delete_donation_campaign(company_id, donation_campaign_id, headers: {})
+      endpoint = build_endpoint('/companies/{companyId}/campaignManagement/{donationCampaignId}', company_id, donation_campaign_id)
+      
+      action = { method: 'delete', url: endpoint }
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    # Get the donation campaigns for an account holder
+    def list_donation_campaigns_for_account_holder(company_id, account_holder_id, headers: {}, query_params: {})
+      endpoint = build_endpoint('/companies/{companyId}/campaignManagement/accountHolders/{accountHolderId}', company_id, account_holder_id)
+      endpoint += create_query_string(query_params)
+      action = { method: 'get', url: endpoint }
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    # Get a list of nonprofits
+    def list_nonprofits(request, company_id, headers: {}, query_params: {})
+      endpoint = build_endpoint('/companies/{companyId}/nonprofits', company_id)
+      endpoint += create_query_string(query_params)
+      action = { method: 'post', url: endpoint }
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    # Update a donation campaign
+    def update_donation_campaign(request, company_id, donation_campaign_id, headers: {})
+      endpoint = build_endpoint('/companies/{companyId}/campaignManagement/{donationCampaignId}', company_id, donation_campaign_id)
+      
+      action = { method: 'patch', url: endpoint }
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    # Activate or end a donation campaign
+    def update_donation_campaign_status(company_id, donation_campaign_id, status, headers: {})
+      endpoint = build_endpoint('/companies/{companyId}/campaignManagement/{donationCampaignId}/status/{status}', company_id, donation_campaign_id, status)
+      
+      action = { method: 'post', url: endpoint }
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+  end
+end

data/lib/adyen/services/management.rb

@@ -10,6 +10,7 @@ require_relative 'management/allowed_origins_merchant_level_api'
 require_relative 'management/android_files_company_level_api'
 require_relative 'management/client_key_company_level_api'
 require_relative 'management/client_key_merchant_level_api'
+require_relative 'management/donation_campaigns_api'
 require_relative 'management/my_api_credential_api'
 require_relative 'management/payment_methods_merchant_level_api'
 require_relative 'management/payout_settings_merchant_level_api'
@@ -92,6 +93,10 @@ module Adyen
       @client_key_merchant_level_api ||= Adyen::ClientKeyMerchantLevelApi.new(@client, @version)
     end
 
+    def donation_campaigns_api
+      @donation_campaigns_api ||= Adyen::DonationCampaignsApi.new(@client, @version)
+    end
+
     def my_api_credential_api
       @my_api_credential_api ||= Adyen::MyAPICredentialApi.new(@client, @version)
     end

data/lib/adyen/services/payment/modifications_api.rb

@@ -47,7 +47,9 @@ module Adyen
     # Create a donation
     #
     # Deprecated 
+    # @deprecated
     def donate(request, headers: {})
+      Adyen::Deprecation.warn(:donate)
       endpoint = build_endpoint('/donate')
       
       action = { method: 'post', url: endpoint }

data/lib/adyen/services/posMobile/pos_mobile_api.rb

@@ -13,7 +13,12 @@ module Adyen
     end
 
     # Create a communication session
+    #
+    # Deprecated since POS Mobile API v68
+    # Use POST [/auth/certificate](https://docs.adyen.com/api-explorer/softpos-configuration-api/latest/post/auth/certificate) to establish secure communications.
+    # @deprecated
     def create_communication_session(request, headers: {})
+      Adyen::Deprecation.warn(:create_communication_session, since: 'POS Mobile API v68', message: 'Use POST [/auth/certificate](https://docs.adyen.com/api-explorer/softpos-configuration-api/latest/post/auth/certificate) to establish secure communications.')
       endpoint = build_endpoint('/sessions')
       
       action = { method: 'post', url: endpoint }

data/lib/adyen/services/posTerminalManagement.rb

@@ -17,7 +17,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def assign_terminals(request, headers: {})
+      Adyen::Deprecation.warn(:assign_terminals, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/assignTerminals'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -30,7 +32,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def find_terminal(request, headers: {})
+      Adyen::Deprecation.warn(:find_terminal, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/findTerminal'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -43,7 +47,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def get_stores_under_account(request, headers: {})
+      Adyen::Deprecation.warn(:get_stores_under_account, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/getStoresUnderAccount'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -56,7 +62,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def get_terminal_details(request, headers: {})
+      Adyen::Deprecation.warn(:get_terminal_details, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/getTerminalDetails'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -69,7 +77,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def get_terminals_under_account(request, headers: {})
+      Adyen::Deprecation.warn(:get_terminals_under_account, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/getTerminalsUnderAccount'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)

data/lib/adyen/services/recurring/recurring_api.rb

@@ -15,7 +15,9 @@ module Adyen
     # Create new permits linked to a recurring contract.
     #
     # Deprecated since Adyen Recurring API v68
+    # @deprecated
     def create_permit(request, headers: {})
+      Adyen::Deprecation.warn(:create_permit, since: 'Adyen Recurring API v68')
       endpoint = build_endpoint('/createPermit')
       
       action = { method: 'post', url: endpoint }
@@ -33,7 +35,9 @@ module Adyen
     # Disable an existing permit.
     #
     # Deprecated since Adyen Recurring API v68
+    # @deprecated
     def disable_permit(request, headers: {})
+      Adyen::Deprecation.warn(:disable_permit, since: 'Adyen Recurring API v68')
       endpoint = build_endpoint('/disablePermit')
       
       action = { method: 'post', url: endpoint }

data/lib/adyen/services/service.rb

@@ -1,3 +1,5 @@
+require_relative '../deprecation'
+
 module Adyen
   class Service
     attr_accessor :service, :version

data/lib/adyen/services/transfers/capital_api.rb

@@ -16,7 +16,9 @@ module Adyen
     #
     # Deprecated since Transfers API v4
     # Use the `/grants` endpoint from the [Capital API](https://docs.adyen.com/api-explorer/capital/latest/get/grants) instead.
+    # @deprecated
     def get_capital_account(headers: {}, query_params: {})
+      Adyen::Deprecation.warn(:get_capital_account, since: 'Transfers API v4', message: 'Use the `/grants` endpoint from the [Capital API](https://docs.adyen.com/api-explorer/capital/latest/get/grants) instead.')
       endpoint = build_endpoint('/grants')
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
@@ -27,7 +29,9 @@ module Adyen
     #
     # Deprecated since Transfers API v4
     # Use the `/grants/{grantId}` endpoint from the [Capital API](https://docs.adyen.com/api-explorer/capital/latest/get/grants/(grantId)) instead.
+    # @deprecated
     def get_grant_reference_details(id, headers: {})
+      Adyen::Deprecation.warn(:get_grant_reference_details, since: 'Transfers API v4', message: 'Use the `/grants/{grantId}` endpoint from the [Capital API](https://docs.adyen.com/api-explorer/capital/latest/get/grants/(grantId)) instead.')
       endpoint = build_endpoint('/grants/{id}', id)
       
       action = { method: 'get', url: endpoint }
@@ -38,7 +42,9 @@ module Adyen
     #
     # Deprecated since Transfers API v4
     # Use the `/grants` endpoint from the [Capital API](https://docs.adyen.com/api-explorer/capital/latest/post/grants) instead.
+    # @deprecated
     def request_grant_payout(request, headers: {})
+      Adyen::Deprecation.warn(:request_grant_payout, since: 'Transfers API v4', message: 'Use the `/grants` endpoint from the [Capital API](https://docs.adyen.com/api-explorer/capital/latest/post/grants) instead.')
       endpoint = build_endpoint('/grants')
       
       action = { method: 'post', url: endpoint }

data/lib/adyen/services/transfers/cash_out_api.rb

@@ -0,0 +1,24 @@
+require_relative '../service'
+module Adyen
+
+  # NOTE: This class is auto generated by OpenAPI Generator
+  # Ref: https://openapi-generator.tech
+  #
+  # Do not edit the class manually.
+  class CashOutApi < Service
+    attr_accessor :service, :version
+
+    def initialize(client, version = DEFAULT_VERSION)
+      super(client, version, 'Transfers')
+    end
+
+    # Initiate a cashout
+    def initiate_cashout(request, headers: {})
+      endpoint = build_endpoint('/cashouts')
+      
+      action = { method: 'post', url: endpoint }
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+  end
+end

data/lib/adyen/services/transfers.rb

@@ -1,4 +1,5 @@
 require_relative 'transfers/capital_api'
+require_relative 'transfers/cash_out_api'
 require_relative 'transfers/transactions_api'
 require_relative 'transfers/transfers_api'
 
@@ -22,6 +23,10 @@ module Adyen
       @capital_api ||= Adyen::CapitalApi.new(@client, @version)
     end
 
+    def cash_out_api
+      @cash_out_api ||= Adyen::CashOutApi.new(@client, @version)
+    end
+
     def transactions_api
       @transactions_api ||= Adyen::TransactionsApi.new(@client, @version)
     end

data/lib/adyen/utils/hmac_validator.rb

@@ -1,3 +1,5 @@
+require 'openssl'
+
 module Adyen
   module Utils
     class HmacValidator
@@ -9,7 +11,9 @@ module Adyen
       ].freeze
 
       # <b>DEPRECATED:</b> Please use valid_webhook_hmac?() instead.
+      # @deprecated
       def valid_notification_hmac?(notification_request_item, hmac_key)
+        Adyen::Deprecation.warn(:valid_notification_hmac?, message: "Use valid_webhook_hmac?() instead.")
         valid_webhook_hmac?(notification_request_item, hmac_key)
       end
 
@@ -18,14 +22,14 @@ module Adyen
       #
       # @param webhook_request_item [Object] The webhook request item.
       # @param hmac_key [String] The HMAC key used to validate the payload.
-      
-      # @return [Boolean] Returns true if the HMAC signature is valid, otherwise false.      
+
+      # @return [Boolean] Returns true if the HMAC signature is valid, otherwise false.
       def valid_webhook_hmac?(webhook_request_item, hmac_key)
         expected_sign = calculate_webhook_hmac(webhook_request_item, hmac_key)
         merchant_sign =
           webhook_request_item.dig('additionalData', 'hmacSignature')
 
-        expected_sign == merchant_sign
+        merchant_sign.is_a?(String) && OpenSSL.secure_compare(expected_sign, merchant_sign)
       end
 
       # validates the HMAC signature of a payload against an expected signature. Use for webhooks that provide the
@@ -35,37 +39,31 @@ module Adyen
       # @param hmac_key [String] The HMAC key used to validate the payload.
       # @param payload [String] The webhook payload.
 
-      # @return [Boolean] Returns true if the HMAC signature is valid, otherwise false.      
+      # @return [Boolean] Returns true if the HMAC signature is valid, otherwise false.
       def valid_webhook_payload_hmac?(hmac_signature, hmac_key, payload)
         expected_sign = calculate_webhook_payload_hmac(payload, hmac_key)
-        expected_sign == hmac_signature
+        hmac_signature.is_a?(String) && OpenSSL.secure_compare(expected_sign, hmac_signature)
       end
 
       # <b>DEPRECATED:</b> Please use calculate_webhook_hmac() instead.
+      # @deprecated
       def calculate_notification_hmac(notification_request_item, hmac_key)
+        Adyen::Deprecation.warn(:calculate_notification_hmac, message: "Use calculate_webhook_hmac() instead.")
         calculate_webhook_hmac(notification_request_item, hmac_key)
       end
 
-    
       def calculate_webhook_payload_hmac(data, hmac_key)
-        Base64.strict_encode64(
-          OpenSSL::HMAC.digest(HMAC_ALGORITHM, [hmac_key].pack('H*'), data)
-        )
+        # Base64 strict encoding
+        [OpenSSL::HMAC.digest(HMAC_ALGORITHM, [hmac_key].pack('H*'), data)].pack('m0')
       end
 
       def calculate_webhook_hmac(webhook_request_item, hmac_key)
         data = data_to_sign(webhook_request_item)
 
-        Base64.strict_encode64(
-          OpenSSL::HMAC.digest(HMAC_ALGORITHM, [hmac_key].pack('H*'), data)
-        )
+        # Base64 strict encoding
+        [OpenSSL::HMAC.digest(HMAC_ALGORITHM, [hmac_key].pack('H*'), data)].pack('m0')
       end
 
-
-      # TODO: Deprecate instead of aliasing
-      alias valid_notification_hmac? valid_webhook_hmac?
-      alias calculate_notification_hmac calculate_webhook_hmac
-
       def data_to_sign(webhook_request_item)
         WEBHOOK_VALIDATION_KEYS
           .map { webhook_request_item.dig(*_1.split('.')).to_s }

data/lib/adyen/version.rb

@@ -1,4 +1,4 @@
 module Adyen
   NAME = 'adyen-ruby-api-library'.freeze
-  VERSION = '11.3.0'.freeze
+  VERSION = '12.0.0'.freeze
 end

data/sdk-generation-log/balanceplatform.json

@@ -1,8 +1,8 @@
 {
   "service": "balanceplatform",
   "project": "ruby",
-  "generatedAt": "2026-04-20T13:40:00Z",
-  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
-  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
-  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+  "generatedAt": "2026-07-31T12:01:02Z",
+  "openapiCommitSha": "425d65d12163ebd4fe6fa6d2f859075817c81cba",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "7f77a7b7aca2c2b22147ba4b996ada979f9decd9"
 }

data/sdk-generation-log/checkout.json

@@ -1,8 +1,8 @@
 {
   "service": "checkout",
   "project": "ruby",
-  "generatedAt": "2026-04-20T13:39:49Z",
-  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
-  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
-  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+  "generatedAt": "2026-08-04T08:22:34Z",
+  "openapiCommitSha": "f0d0bd47b721d1b4e2c86e8b3aad706ecb88423a",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "2c40b0c319ba09d1dd30970a137b53af3193db76"
 }

data/sdk-generation-log/management.json

@@ -1,8 +1,8 @@
 {
   "service": "management",
   "project": "ruby",
-  "generatedAt": "2026-04-20T13:39:49Z",
-  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
-  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
-  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+  "generatedAt": "2026-07-31T12:01:01Z",
+  "openapiCommitSha": "425d65d12163ebd4fe6fa6d2f859075817c81cba",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "7f77a7b7aca2c2b22147ba4b996ada979f9decd9"
 }

data/sdk-generation-log/posmobile.json

@@ -1,8 +1,8 @@
 {
   "service": "posmobile",
   "project": "ruby",
-  "generatedAt": "2026-04-20T13:39:47Z",
-  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
-  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
-  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+  "generatedAt": "2026-07-27T10:28:53Z",
+  "openapiCommitSha": "2f7d0e1961772ee974be4ed268282cf2ba8f6e03",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "c80f38ce8b02c80778053741d0e9175e8e530742"
 }

data/sdk-generation-log/transfers.json

@@ -1,8 +1,8 @@
 {
   "service": "transfers",
   "project": "ruby",
-  "generatedAt": "2026-04-20T13:39:51Z",
-  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
-  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
-  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+  "generatedAt": "2026-07-31T12:01:01Z",
+  "openapiCommitSha": "425d65d12163ebd4fe6fa6d2f859075817c81cba",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "7f77a7b7aca2c2b22147ba4b996ada979f9decd9"
 }

data/spec/balance_control_spec.rb

@@ -42,4 +42,45 @@ RSpec.describe Adyen::BalanceControl, service: 'balanceControl' do
     expect(response_hash)
       .to be_a_kind_of Hash
   end
+
+  describe 'deprecated balance_transfer' do
+    around do |example|
+      previous = Warning[:deprecated]
+      Warning[:deprecated] = true
+      example.run
+    ensure
+      Warning[:deprecated] = previous
+    end
+
+    it 'emits a deprecation warning and still returns a successful response' do
+      request_body = JSON.parse(json_from_file('mocks/requests/BalanceControl/balance_transfer.json'))
+
+      response_body = json_from_file('mocks/responses/BalanceControl/balance_transfer.json')
+
+      url = @shared_values[:client].service_url(
+        @shared_values[:service],
+        'balanceTransfer',
+        @shared_values[:client].balance_control.version)
+      WebMock.stub_request(:post, url)
+             .with(
+               body: request_body,
+               headers: {
+                 'x-api-key' => @shared_values[:client].api_key
+               }
+             )
+             .to_return(
+               body: response_body
+             )
+
+      result = nil
+      expect do
+        result = @shared_values[:client].balance_control.balance_control_api.balance_transfer(request_body)
+      end.to output(/\[DEPRECATED\] `balance_transfer` is deprecated since Adyen Balance Control API v1\n/).to_stderr
+
+      expect(result.status)
+        .to eq(200)
+      expect(result.response)
+        .to eq(JSON.parse(response_body))
+    end
+  end
 end