adyen-ruby-api-library 11.2.0 → 12.0.0

data/lib/adyen/services/sessionAuthentication/session_authentication_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Create a session token
     def create_authentication_session(request, headers: {})
-      endpoint = '/sessions'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/sessions')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/storedValue/stored_value_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Changes the status of the payment method.
     def change_status(request, headers: {})
-      endpoint = '/changeStatus'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/changeStatus')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Checks the balance.
     def check_balance(request, headers: {})
-      endpoint = '/checkBalance'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/checkBalance')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Issues a new card.
     def issue(request, headers: {})
-      endpoint = '/issue'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/issue')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Loads the payment method.
     def load(request, headers: {})
-      endpoint = '/load'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/load')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -54,9 +46,7 @@ module Adyen
 
     # Merge the balance of two cards.
     def merge_balance(request, headers: {})
-      endpoint = '/mergeBalance'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/mergeBalance')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -64,9 +54,7 @@ module Adyen
 
     # Voids a transaction.
     def void_transaction(request, headers: {})
-      endpoint = '/voidTransaction'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/voidTransaction')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

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

@@ -16,10 +16,10 @@ 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: {})
-      endpoint = '/grants'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      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 }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -29,10 +29,10 @@ 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: {})
-      endpoint = '/grants/{id}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, id)
+      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 }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -42,10 +42,10 @@ 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: {})
-      endpoint = '/grants'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      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 }
       @client.call_adyen_api(@service, action, request, headers, @version)

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

@@ -14,9 +14,7 @@ module Adyen
 
     # Get all transactions
     def get_all_transactions(headers: {}, query_params: {})
-      endpoint = '/transactions'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/transactions')
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Get a transaction
     def get_transaction(id, headers: {})
-      endpoint = '/transactions/{id}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, id)
+      endpoint = build_endpoint('/transactions/{id}', id)
       
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)

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

@@ -14,9 +14,7 @@ module Adyen
 
     # Approve initiated transfers
     def approve_initiated_transfers(request, headers: {})
-      endpoint = '/transfers/approve'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/transfers/approve')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Cancel initiated transfers
     def cancel_initiated_transfers(request, headers: {})
-      endpoint = '/transfers/cancel'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/transfers/cancel')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Get all transfers
     def get_all_transfers(headers: {}, query_params: {})
-      endpoint = '/transfers'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/transfers')
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Get a transfer
     def get_transfer(id, headers: {})
-      endpoint = '/transfers/{id}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, id)
+      endpoint = build_endpoint('/transfers/{id}', id)
       
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -54,9 +46,7 @@ module Adyen
 
     # Return a transfer
     def return_transfer(request, transfer_id, headers: {})
-      endpoint = '/transfers/{transferId}/returns'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, transfer_id)
+      endpoint = build_endpoint('/transfers/{transferId}/returns', transfer_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -64,9 +54,7 @@ module Adyen
 
     # Transfer funds
     def transfer_funds(request, headers: {})
-      endpoint = '/transfers'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/transfers')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

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,38 +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)
-        puts(expected_sign)
-        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.2.0'.freeze
+  VERSION = '12.0.0'.freeze
 end

data/sdk-generation-log/balancecontrol.json

@@ -0,0 +1,8 @@
+{
+  "service": "balancecontrol",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:52Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/balanceplatform.json

@@ -0,0 +1,8 @@
+{
+  "service": "balanceplatform",
+  "project": "ruby",
+  "generatedAt": "2026-07-31T12:01:02Z",
+  "openapiCommitSha": "425d65d12163ebd4fe6fa6d2f859075817c81cba",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "7f77a7b7aca2c2b22147ba4b996ada979f9decd9"
+}

data/sdk-generation-log/binlookup.json

@@ -0,0 +1,8 @@
+{
+  "service": "binlookup",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:47Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/capital.json

@@ -0,0 +1,8 @@
+{
+  "service": "capital",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:47Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/checkout.json

@@ -0,0 +1,8 @@
+{
+  "service": "checkout",
+  "project": "ruby",
+  "generatedAt": "2026-08-04T08:22:34Z",
+  "openapiCommitSha": "f0d0bd47b721d1b4e2c86e8b3aad706ecb88423a",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "2c40b0c319ba09d1dd30970a137b53af3193db76"
+}

data/sdk-generation-log/dataprotection.json

@@ -0,0 +1,8 @@
+{
+  "service": "dataprotection",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:47Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/disputes.json

@@ -0,0 +1,8 @@
+{
+  "service": "disputes",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:52Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/legalentitymanagement.json

@@ -0,0 +1,8 @@
+{
+  "service": "legalentitymanagement",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:46Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/management.json

@@ -0,0 +1,8 @@
+{
+  "service": "management",
+  "project": "ruby",
+  "generatedAt": "2026-07-31T12:01:01Z",
+  "openapiCommitSha": "425d65d12163ebd4fe6fa6d2f859075817c81cba",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "7f77a7b7aca2c2b22147ba4b996ada979f9decd9"
+}

data/sdk-generation-log/payment.json

@@ -0,0 +1,8 @@
+{
+  "service": "payment",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:48Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/paymentsapp.json

@@ -0,0 +1,8 @@
+{
+  "service": "paymentsapp",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:40:00Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/payout.json

@@ -0,0 +1,8 @@
+{
+  "service": "payout",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:45Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/posmobile.json

@@ -0,0 +1,8 @@
+{
+  "service": "posmobile",
+  "project": "ruby",
+  "generatedAt": "2026-07-27T10:28:53Z",
+  "openapiCommitSha": "2f7d0e1961772ee974be4ed268282cf2ba8f6e03",
+  "automationCommitSha": "0c108bd8050cf480d2710b78b770afdfbdd89397",
+  "libraryCommitSha": "c80f38ce8b02c80778053741d0e9175e8e530742"
+}

data/sdk-generation-log/recurring.json

@@ -0,0 +1,8 @@
+{
+  "service": "recurring",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:48Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/sessionauthentication.json

@@ -0,0 +1,8 @@
+{
+  "service": "sessionauthentication",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:49Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/storedvalue.json

@@ -0,0 +1,8 @@
+{
+  "service": "storedvalue",
+  "project": "ruby",
+  "generatedAt": "2026-04-20T13:39:48Z",
+  "openapiCommitSha": "3550ecd3f320efaad6bee55ffed5122cb9ba09d5",
+  "automationCommitSha": "4ad0c0c7e87bc0e5994a9a3350a991d0691350bb",
+  "libraryCommitSha": "60ccdbdbbb7069d54600a8a8cd19eea245661134"
+}

data/sdk-generation-log/transfers.json

@@ -0,0 +1,8 @@
+{
+  "service": "transfers",
+  "project": "ruby",
+  "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