adyen-ruby-api-library 6.2.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b091a2aaf201f3a22b41a22c069321d1d181daee6e33da275d94ab970b9b9ab
-  data.tar.gz: 1806d42c9f609c9ff3b6e84e31ff1be9f4d4503d15f5a0c300a664a779a5c295
+  metadata.gz: 8a353164deda5fc44de3ec027f4022732e9c4afdb1a5bfacf91704e9d8c9e90a
+  data.tar.gz: 1f1f2d92d0f9528a9c6945da699a3a9d8a05e0594c7fe4d2fb66ad8c85c01c77
 SHA512:
-  metadata.gz: f9c9221b5d0c164cd4a90c5d7e6531e6361c116e00139662fcff37588309c07c21740d8a3c277ec4b7febbad4d5af752a772eab0df5625430f66b3b47fcbfc92
-  data.tar.gz: 4b89bec481b6b2e900325a9f9bc11a69e87b42d61a1358205e53d3a17f90c722377e4fdf7accafc11124ac2e4d70d88b36cdd214cb5f9b7d576e216d9ca6b31b
+  metadata.gz: a8d4190c1cbb857fa27ca0134a34b559c4e30c46d9397bce514b5894820c6fc0a33e4af10076953a27bfe5c36e3ab06558a55264c34a1ae3acfc26c818786979
+  data.tar.gz: be1328cdf8c4592cf0c3dc6573c1a248b761efc30f01e4eb997744234295c397c35b3b2755ab07593f6d5f1e776287daedf8f98493f462492e1f2284bcfda346

data/.github/CODEOWNERS

@@ -1 +1 @@
-* @crrood @wboereboom @AlexandrosMor @michaelpaul
+* @Adyen/api-libraries-reviewers

data/.github/workflows/codeql.yml

@@ -0,0 +1,41 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "develop", "main" ]
+  pull_request:
+    branches: [ "develop" ]
+  schedule:
+    - cron: "40 12 * * 0"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ javascript ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v2
+        with:
+          languages: ${{ matrix.language }}
+          queries: +security-and-quality
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v2
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v2
+        with:
+          category: "/language:${{ matrix.language }}"

data/.github/workflows/ruby.yml

@@ -12,7 +12,7 @@ jobs:
         ruby: [2.5, 2.6, 2.7, '3.0', head]
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{ matrix.ruby }}

data/.github/workflows/rubygems_release.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v3
 
       - name: Release Gem on RubyGems
         if: contains(github.ref, 'refs/tags/v')

data/.gitignore

@@ -15,3 +15,6 @@ design.txt
 .DS_Store
 
 .idea
+main.rb
+build/
+openapi-generator-cli-6.0.1.jar

data/Makefile

@@ -0,0 +1,72 @@
+generator:=ruby
+openapi-generator-version:=6.4.0
+openapi-generator-url:=https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/$(openapi-generator-version)/openapi-generator-cli-$(openapi-generator-version).jar
+openapi-generator-jar:=build/openapi-generator-cli.jar
+openapi-generator-cli:=java -jar build/openapi-generator-cli.jar
+output:=build/out
+
+services:=balancePlatform checkout legalEntityManagement management payout platformsAccount platformsFund platformsHostedOnboardingPage platformsNotificationConfiguration transfers
+singleFileServices:=balanceControlService binLookup dataProtection recurring storedValue posTerminalManagement payment
+
+binLookup: spec=BinLookupService-v54
+checkout: spec=CheckoutService-v70
+dataProtection: spec=DataProtectionService-v1
+storedValue: spec=StoredValueService-v46
+posTerminalManagement: spec=TfmAPIService-v1
+payment: spec=PaymentService-v68
+recurring: spec=RecurringService-v68
+payout: spec=PayoutService-v68
+management: spec=ManagementService-v1
+legalEntityManagement: spec=LegalEntityService-v3
+balancePlatform: spec=BalancePlatformService-v2
+platformsAccount: spec=AccountService-v6
+platformsFund: spec=FundService-v6
+platformsNotificationConfiguration: spec=NotificationConfigurationService-v6
+platformsHostedOnboardingPage: spec=HopService-v6
+transfers: spec=TransferService-v3
+balanceControlService: spec=BalanceControlService-v1
+
+allServices: $(services) $(singleFileServices)
+
+$(services): build/spec $(openapi-generator-jar)
+	wget $(openapi-generator-url) -O build/openapi-generator-cli.jar
+	rm -rf $(output)
+	$(openapi-generator-cli) generate \
+		-i build/spec/json/$(spec).json \
+		-g $(generator) \
+		-c ./templates/config.yaml \
+		-o $(output) \
+		--global-property apis,apiTests=false,apiDocs=false,supportingFiles=api-single.rb\
+		--additional-properties serviceName=$@\
+		--skip-validate-spec
+	rm -f $(output)/lib/openapi_client/api/*-small.rb
+	mkdir -p lib/adyen/services/$@
+	mv $(output)/lib/openapi_client/api/*.rb lib/adyen/services/$@
+	mv $(output)/api/api-single.rb lib/adyen/services/$@.rb
+	rm -rf $(output)
+
+$(singleFileServices): build/spec
+	wget $(openapi-generator-url) -O build/openapi-generator-cli.jar
+	cat <<< "$$(jq 'del(.paths[][].tags)' build/spec/json/$(spec).json)" > build/spec/json/$(spec).json
+	rm -rf $(output)
+	$(openapi-generator-cli) generate \
+		-i build/spec/json/$(spec).json \
+		-g $(generator) \
+		-c ./templates/config.yaml \
+		-o $(output) \
+		--global-property apis,apiTests=false,apiDocs=false\
+		--additional-properties serviceName=$@\
+		--skip-validate-spec
+	mv $(output)/lib/openapi_client/api/default_api-small.rb lib/adyen/services/$@.rb
+	rm -rf $(output)
+
+templates: $(openapi-generator-jar)
+	$(openapi-generator-cli) author template -g $(generator) -o build/templates
+
+# Download the generator
+$(openapi-generator-jar):
+	wget --quiet -o /dev/null $(openapi-generator-url) -O $(openapi-generator-jar)
+
+build/spec:
+	git clone https://github.com/Adyen/adyen-openapi.git build/spec
+	perl -i -pe's/"openapi" : "3.[0-9].[0-9]"/"openapi" : "3.0.0"/' build/spec/json/*.json

data/README.md

@@ -1,24 +1,26 @@
+![Ruby](https://user-images.githubusercontent.com/93914435/236416787-3da4dd32-0a7d-43f7-9aa4-8d77697c85f9.png)
 # Adyen API Library for Ruby
 
-
 This is the officially supported Ruby library for using Adyen's APIs.
 
-## Integration
-The library supports all APIs under the following services:
-
-* [Checkout API](https://docs.adyen.com/api-explorer/#/CheckoutService/v68/overview): Our latest integration for accepting online payments. Current supported version: **v68**
-* [Payments API](https://docs.adyen.com/api-explorer/#/Payment/v64/overview): Our classic integration for online payments. Current supported version: **v64**
-* [Recurring API](https://docs.adyen.com/api-explorer/#/Recurring/v49/overview): Endpoints for managing saved payment details. Current supported version: **v49**
-* [Payouts API](https://docs.adyen.com/api-explorer/#/Payout/v64/overview): Endpoints for sending funds to your customers. Current supported version: **v64**
-* [Platforms APIs](https://docs.adyen.com/platforms/api): Set of APIs when using Adyen for Platforms. 
-  * [Account API](https://docs.adyen.com/api-explorer/#/Account/v6/overview) Current supported version: **v6**
-  * [Fund API](https://docs.adyen.com/api-explorer/#/Fund/v6/overview) Current supported version: **v6**
-  * [Notification Configuration API](https://docs.adyen.com/api-explorer/#/NotificationConfigurationService/v6/overview) Current supported version: **v6**
-* [POS Terminal Management API](https://docs.adyen.com/api-explorer/#/postfmapi/v1/overview): Current supported version: **v1**
-* [Adyen BinLookup API](https://docs.adyen.com/api-explorer/#/BinLookup/v50/overview): Current supported version: **v50**
-* [Data Protection API](https://docs.adyen.com/development-resources/data-protection-api): Current supported version: **v1**
-* [Disputes API](https://docs.adyen.com/risk-management/disputes-api): Current supported version: **v50**
-
+## Supported APIs
+
+This library supports the following:
+
+| API name | API version | Description | API object |
+|----------|:-----------:|-------------|------------|
+| [BIN lookup API](https://docs.adyen.com/api-explorer/#/BinLookup/v52/overview) | v54 | The BIN Lookup API provides endpoints for retrieving information based on a given BIN. | [BinLookup](lib/adyen/services/binLookup.rb) |
+| [Checkout API](https://docs.adyen.com/api-explorer/#/CheckoutService/v69/overview) | v70 | Our latest integration for accepting online payments. | [CheckoutAPI](lib/adyen/services/checkout.rb) |
+| [Configuration API](https://docs.adyen.com/api-explorer/#/balanceplatform/v2/overview) | v2 | The Configuration API enables you to create a platform where you can onboard your users as account holders and create balance accounts, cards, and business accounts. | [BalancePlatform](lib/adyen/services/balancePlatform.rb) |
+| [DataProtection API](https://docs.adyen.com/development-resources/data-protection-api) | v1 | Adyen Data Protection API provides a way for you to process [Subject Erasure Requests](https://gdpr-info.eu/art-17-gdpr/) as mandated in GDPR. Use our API to submit a request to delete shopper's data, including payment details and other related information (for example, delivery address or shopper email) | [DataProtection](lib/adyen/services/dataProtection.rb) |
+| [Legal Entity Management API](https://docs.adyen.com/api-explorer/#/legalentity/v3/overview) | v3 | Manage legal entities that contain information required for verification. | [LegalEntityManagement](lib/adyen/services/legalEntityManagement.rb) |
+| [Management API](https://docs.adyen.com/api-explorer/#/ManagementService/v1/overview) | v1 | Configure and manage your Adyen company and merchant accounts, stores, and payment terminals. | [Management](lib/adyen/services/management.rb) |
+| [Payments API](https://docs.adyen.com/api-explorer/#/Payment/v68/overview) | v68 | Our classic integration for online payments. | [Classic Integration API](lib/adyen/services/payment.rb) |
+| [Payouts API](https://docs.adyen.com/api-explorer/#/Payout/v68/overview) | v68 | Endpoints for sending funds to your customers. | [Payout](lib/adyen/services/payout.rb) |
+| [POS Terminal Management API](https://docs.adyen.com/api-explorer/#/postfmapi/v1/overview) | v1 | Endpoints for managing your point-of-sale payment terminals. | [TerminalManagement](lib/adyen/services/posTerminalManagement.rb) |
+| [Recurring API](https://docs.adyen.com/api-explorer/#/Recurring/v68/overview) | v68 | Endpoints for managing saved payment details. | [Recurring](lib/adyen/services/recurring.rb) |
+| [Stored Value API](https://docs.adyen.com/payment-methods/gift-cards/stored-value-api) | v46 | Manage both online and point-of-sale gift cards and other stored-value cards. | [StoredValue](lib/adyen/services/storedValue.rb) |
+| [Transfers API](https://docs.adyen.com/api-explorer/transfers/3/overview) | v3 | The Transfers API provides endpoints that can be used to get information about all your transactions, move funds within your balance platform or send funds from your balance platform to a transfer instrument. | [Transfers](lib/adyen/services/transfers.rb) |
 
 For more information, refer to our [documentation](https://docs.adyen.com/) or the [API Explorer](https://docs.adyen.com/api-explorer/).
 
@@ -64,7 +66,7 @@ adyen.api_key = 'AF5XXXXXXXXXXXXXXXXXXXX'
 
 - Make a Payment
 ~~~~ruby
-response = adyen.checkout.payments({
+response = adyen.checkout.payments_api.payments({
   :amount => {
     :currency => "EUR",
     :value => 1000

data/lib/adyen/client.rb

@@ -35,30 +35,43 @@ module Adyen
 
     # base URL for API given service and @env
     def service_url_base(service)
-      raise ArgumentError, "Please set Client.live_url_prefix to the portion of your merchant-specific URL prior to '-[service]-live.adyenpayments.com'" if @live_url_prefix.nil? and @env == :live
       if @env == :mock
         @mock_service_url_base
       else
         case service
         when "Checkout"
-          url = "https://checkout-#{@env}.adyen.com/checkout"
+          url = "https://checkout-#{@env}.adyen.com"
           supports_live_url_prefix = true
         when "Account", "Fund", "Notification", "Hop"
-          url = "https://cal-#{@env}.adyen.com/cal/services"
+          url = "https://cal-#{@env}.adyen.com/cal/services/#{service}"
           supports_live_url_prefix = false
-        when "Recurring", "Payment", "Payout", "BinLookup"
-          url = "https://pal-#{@env}.adyen.com/pal/servlet"
+        when "Recurring", "Payment", "Payout", "BinLookup", "StoredValue", "BalanceControlService"
+          url = "https://pal-#{@env}.adyen.com/pal/servlet/#{service}"
           supports_live_url_prefix = true
-        when "Terminal"
+        when "PosTerminalManagement"
           url = "https://postfmapi-#{@env}.adyen.com/postfmapi/terminal"
           supports_live_url_prefix = false
         when "DataProtectionService", "DisputeService"
-          url = "https://ca-#{@env}.adyen.com/ca/services"
+          url = "https://ca-#{@env}.adyen.com/ca/services/#{service}"
+          supports_live_url_prefix = false
+        when "LegalEntityManagement"
+          url = "https://kyc-#{@env}.adyen.com/lem"
+          supports_live_url_prefix = false
+        when "BalancePlatform" 
+          url = "https://balanceplatform-api-#{@env}.adyen.com/bcl"
+          supports_live_url_prefix = false
+        when "Transfers"
+          url = "https://balanceplatform-api-#{@env}.adyen.com/btl"
+          supports_live_url_prefix = false
+        when "Management"
+          url = "https://management-#{@env}.adyen.com"
           supports_live_url_prefix = false
         else
           raise ArgumentError, "Invalid service specified"
         end
-
+        
+        raise ArgumentError, "Please set Client.live_url_prefix to the portion of your merchant-specific URL prior to '-[service]-live.adyenpayments.com'" \
+         if @live_url_prefix.nil? and @env == :live and supports_live_url_prefix
         if @env == :live && supports_live_url_prefix
           url.insert(8, "#{@live_url_prefix}-")
           url["adyen.com"] = "adyenpayments.com"
@@ -70,11 +83,7 @@ module Adyen
 
     # construct full URL from service and endpoint
     def service_url(service, action, version)
-      if service == "Checkout" || service == "Terminal"
-        "#{service_url_base(service)}/v#{version}/#{action}"
-      else
-        "#{service_url_base(service)}/#{service}/v#{version}/#{action}"
-      end
+      "#{service_url_base(service)}/v#{version}/#{action}"
     end
 
     # send request to adyen API
@@ -121,6 +130,10 @@ module Adyen
         headers.map do |key, value|
           faraday.headers[key] = value
         end
+
+        # add library headers
+        faraday.headers["adyen-library-name"] = Adyen::NAME
+        faraday.headers["adyen-library-version"] = Adyen::VERSION
       end
       # if json string convert to hash
       # needed to add applicationInfo
@@ -128,10 +141,6 @@ module Adyen
         request_data = JSON.parse(request_data)
       end
 
-      # add application only on checkout service
-      if with_application_info
-        add_application_info(request_data)
-      end
 
       # convert to json
       request_data = request_data.to_json
@@ -144,6 +153,13 @@ module Adyen
             raise connection_error, "Connection to #{url} failed"
           end
         end
+        if action.fetch(:method) == "delete"
+          begin
+            response = conn.delete
+          rescue Faraday::ConnectionFailed => connection_error
+            raise connection_error, "Connection to #{url} failed"
+          end
+        end
         if action.fetch(:method) == "patch"
           begin
             response = conn.patch do |req|
@@ -153,7 +169,7 @@ module Adyen
             raise connection_error, "Connection to #{url} failed"
           end
         end
-      else
+       if action.fetch(:method) == 'post'
         # post request to Adyen
         begin
           response = conn.post do |req|
@@ -162,46 +178,46 @@ module Adyen
         rescue Faraday::ConnectionFailed => connection_error
           raise connection_error, "Connection to #{url} failed"
         end
+       end 
+      else
+        begin
+          response = conn.post do |req|
+            req.body = request_data
+          end # handle client errors
+        rescue Faraday::ConnectionFailed => connection_error
+          raise connection_error, "Connection to #{url} failed"
+        end
       end
-
       # check for API errors
       case response.status
       when 401
         raise Adyen::AuthenticationError.new("Invalid API authentication; https://docs.adyen.com/user-management/how-to-get-the-api-key", request_data)
       when 403
-        raise Adyen::PermissionError.new("Missing user permissions; https://docs.adyen.com/user-management/user-roles", request_data)
+        raise Adyen::PermissionError.new("Missing user permissions; https://docs.adyen.com/user-management/user-roles", request_data, response.body)
       end
-
-      formatted_response = AdyenResult.new(response.body, response.headers, response.status)
-
+      
+      # delete has no response.body (unless it throws an error)
+      if response.body == nil
+        formatted_response = AdyenResult.new("{}", response.headers, response.status)
+      else
+        formatted_response = AdyenResult.new(response.body, response.headers, response.status)
+      end
+      
       formatted_response
     end
 
-    # add application_info for analytics
-    def add_application_info(request_data)
-      adyenLibrary = {
-        :name => Adyen::NAME,
-        :version => Adyen::VERSION.to_s,
-      }
-
-      if request_data[:applicationInfo].nil?
-        request_data[:applicationInfo] = {}
-      end
-
-      request_data[:applicationInfo][:adyenLibrary] = adyenLibrary
-    end
 
     # services
     def checkout
       @checkout ||= Adyen::Checkout.new(self)
     end
 
-    def payments
-      @payments ||= Adyen::Payments.new(self)
+    def payment
+      @payment ||= Adyen::Payment.new(self)
     end
 
-    def payouts
-      @payouts ||= Adyen::Payouts.new(self)
+    def payout
+      @payout ||= Adyen::Payout.new(self)
     end
 
     def recurring
@@ -212,8 +228,8 @@ module Adyen
       @marketpay ||= Adyen::Marketpay::Marketpay.new(self)
     end
 
-    def postfmapi
-      @postfmapi ||= Adyen::PosTerminalManagement.new(self)
+    def pos_terminal_management
+      @pos_terminal_management ||= Adyen::PosTerminalManagement.new(self)
     end
 
     def data_protection
@@ -227,5 +243,29 @@ module Adyen
     def bin_lookup
       @bin_lookup ||= Adyen::BinLookup.new(self)
     end
+
+    def legal_entity_management
+      @legal_entity_management ||= Adyen::LegalEntityManagement.new(self)
+    end
+
+    def balance_platform
+      @balance_platform ||= Adyen::BalancePlatform.new(self)
+    end
+
+    def transfers
+      @transfers ||= Adyen::Transfers.new(self)
+    end
+
+    def management
+      @management ||= Adyen::Management.new(self)
+    end
+    
+    def stored_value
+      @stored_value ||=Adyen::StoredValue.new(self)
+    end
+
+    def balance_control_service
+      @balance_control_service ||=Adyen::BalanceControlService.new(self)
+    end
   end
 end

data/lib/adyen/errors.rb

@@ -70,8 +70,8 @@ module Adyen
   end
 
   class PermissionError < AdyenError
-    def initialize(msg, request)
-      super(request, nil, msg, 403)
+    def initialize(msg, request, response)
+      super(request, response, msg, 403)
     end
   end
 

data/lib/adyen/services/balanceControlService.rb

@@ -0,0 +1,28 @@
+require_relative './service'
+module Adyen
+
+
+  class BalanceControlService < Service
+    attr_accessor :service, :version
+    DEFAULT_VERSION = 1
+
+    def initialize(client, version = DEFAULT_VERSION)
+      @service = "BalanceControlService"
+      @client = client
+      @version = version
+    end
+
+    def balance_transfer(request, headers: {} )
+      """
+      Start a balance transfer
+      """
+      endpoint = "/balanceTransfer".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % []
+      
+      action = { method: "post", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+  end
+end

data/lib/adyen/services/balancePlatform/account_holders_api.rb

@@ -0,0 +1,63 @@
+require_relative '../service'
+module Adyen
+
+
+  class AccountHoldersApi < Service
+    attr_accessor :service, :version
+
+    def initialize(client, version = DEFAULT_VERSION)
+      @service = "BalancePlatform"
+      @client = client
+      @version = version
+    end
+
+    def get_account_holder(id, headers: {} )
+      """
+      Get an account holder
+      """
+      endpoint = "/accountHolders/{id}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [id]
+      
+      action = { method: "get", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def get_all_balance_accounts_of_account_holder(id, headers: {} , queryParams: {})
+      """
+      Get all balance accounts of an account holder
+      """
+      endpoint = "/accountHolders/{id}/balanceAccounts".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [id]
+      endpoint = endpoint + create_query_string(queryParams)
+      action = { method: "get", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def update_account_holder(request, id, headers: {} )
+      """
+      Update an account holder
+      """
+      endpoint = "/accountHolders/{id}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [id]
+      
+      action = { method: "patch", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    def create_account_holder(request, headers: {} )
+      """
+      Create an account holder
+      """
+      endpoint = "/accountHolders".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % []
+      
+      action = { method: "post", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+  end
+end

data/lib/adyen/services/balancePlatform/balance_accounts_api.rb

@@ -0,0 +1,123 @@
+require_relative '../service'
+module Adyen
+
+
+  class BalanceAccountsApi < Service
+    attr_accessor :service, :version
+
+    def initialize(client, version = DEFAULT_VERSION)
+      @service = "BalancePlatform"
+      @client = client
+      @version = version
+    end
+
+    def delete_sweep(balanceAccountId, sweepId, headers: {} )
+      """
+      Delete a sweep
+      """
+      endpoint = "/balanceAccounts/{balanceAccountId}/sweeps/{sweepId}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [balanceAccountId,sweepId]
+      
+      action = { method: "delete", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def get_all_sweeps_for_balance_account(balanceAccountId, headers: {} , queryParams: {})
+      """
+      Get all sweeps for a balance account
+      """
+      endpoint = "/balanceAccounts/{balanceAccountId}/sweeps".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [balanceAccountId]
+      endpoint = endpoint + create_query_string(queryParams)
+      action = { method: "get", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def get_sweep(balanceAccountId, sweepId, headers: {} )
+      """
+      Get a sweep
+      """
+      endpoint = "/balanceAccounts/{balanceAccountId}/sweeps/{sweepId}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [balanceAccountId,sweepId]
+      
+      action = { method: "get", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def get_balance_account(id, headers: {} )
+      """
+      Get a balance account
+      """
+      endpoint = "/balanceAccounts/{id}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [id]
+      
+      action = { method: "get", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def get_all_payment_instruments_for_balance_account(id, headers: {} , queryParams: {})
+      """
+      Get all payment instruments for a balance account
+      """
+      endpoint = "/balanceAccounts/{id}/paymentInstruments".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [id]
+      endpoint = endpoint + create_query_string(queryParams)
+      action = { method: "get", url: endpoint}
+      @client.call_adyen_api(@service, action, {}, headers, @version)
+    end
+
+    def update_sweep(request, balanceAccountId, sweepId, headers: {} )
+      """
+      Update a sweep
+      """
+      endpoint = "/balanceAccounts/{balanceAccountId}/sweeps/{sweepId}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [balanceAccountId,sweepId]
+      
+      action = { method: "patch", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    def update_balance_account(request, id, headers: {} )
+      """
+      Update a balance account
+      """
+      endpoint = "/balanceAccounts/{id}".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [id]
+      
+      action = { method: "patch", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    def create_balance_account(request, headers: {} )
+      """
+      Create a balance account
+      """
+      endpoint = "/balanceAccounts".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % []
+      
+      action = { method: "post", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+    def create_sweep(request, balanceAccountId, headers: {} )
+      """
+      Create a sweep
+      """
+      endpoint = "/balanceAccounts/{balanceAccountId}/sweeps".gsub(/{.+?}/, '%s') 
+      endpoint = endpoint.gsub(/^\//, "")
+      endpoint = endpoint % [balanceAccountId]
+      
+      action = { method: "post", url: endpoint}
+      @client.call_adyen_api(@service, action, request, headers, @version)
+    end
+
+  end
+end