Add SessionAuthentication API

Author: gcatanese

README.md

@@ -16,6 +16,7 @@ This library supports the following:
 | [Legal Entity Management API](https://docs.adyen.com/api-explorer/legalentity/3/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/Management/3/overview)                                     |     v3      | Configure and manage your Adyen company and merchant accounts, stores, and payment terminals.                                                                                                                                                                                                                                           | [Management](lib/adyen/services/management.rb)                       |
 | [OpenBanking API](https://docs.adyen.com/api-explorer/open-banking/1/overview)                                                |     v1      |  Securely share financial data and services with third parties.                                                                                                                                                                                                                                                  | [OpenBanking](lib/adyen/services/openBanking.rb)                     |
+| [SessionAuthentication API](https://docs.adyen.com/api-explorer/sessionauthentication/1/overview)                                                |     v1      |  The Session authentication API enables you to create and manage the JSON Web Tokens (JWT) required for integrating components.                                                                                                                                                                                                                                                  | [SessionAuthentication](lib/adyen/services/sessionAuthentication.rb)                     |
 | [Payments API](https://docs.adyen.com/api-explorer/Payment/68/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/68/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/1/overview)                                       |     ~~v1~~      | ~~Endpoints for managing your point-of-sale payment terminals.~~ ‼️ **Deprecated**: use instead the [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview) for the management of your terminal fleet.                                                                                                                                                                                                                                                                                | ~~[TerminalManagement](lib/adyen/services/posTerminalManagement.rb)~~    || [Recurring API](https://docs.adyen.com/api-explorer/Recurring/68/overview)                                                    |     v68     | Endpoints for managing saved payment details.                                                                                                                                                                                                                                                                                           | [Recurring](lib/adyen/services/recurring.rb)                         |

lib/adyen-ruby-api-library.rb

@@ -22,3 +22,5 @@
 require_relative 'adyen/services/terminalCloudAPI'
 require_relative 'adyen/services/posMobile'
 require_relative 'adyen/services/openBanking'
+require_relative 'adyen/services/sessionAuthentication'
+

lib/adyen/client.rb

@@ -308,6 +308,10 @@ def open_banking
       @open_banking ||= Adyen::OpenBanking.new(self)
     end
 
+    def session_authentication
+      @open_banking ||= Adyen::SessionAuthentication.new(self)
+    end
+
     private
 
     def auth_header(auth_type, faraday)

lib/adyen/services/sessionAuthentication/session_authentication_api.rb

@@ -13,7 +13,7 @@ def initialize(client, version = DEFAULT_VERSION)
     end
 
     # Create a session token
-    def create_authentication_session(request, authentication_session_request, headers: {})
+    def create_authentication_session(request, headers: {})
       endpoint = '/sessions'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)

spec/mocks/requests/SessionAuthentication/create_authentication_session.json

@@ -0,0 +1,16 @@
+{
+  "allowOrigin": "https://www.your-website.com",
+  "product": "platform",
+  "policy": {
+    "resources": [
+      {
+        "type": "accountHolder",
+        "accountHolderId": "AH00000000000000000000001"
+      }
+    ],
+    "roles": [
+      "Transactions Overview Component: View",
+      "Payouts Overview Component: View"
+    ]
+  }
+}

spec/mocks/responses/SessionAuthentication/create_authentication_session.json

@@ -0,0 +1,4 @@
+{
+  "sessionToken": "long_session_token_string",
+  "expiresAt": "2025-10-07T12:00:00Z"
+}

spec/session_authentication_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+require 'json'
+
+RSpec.describe Adyen::SessionAuthentication, service: 'SessionAuthentication' do
+  before(:all) do
+    @shared_values = {
+      client: create_client(:api_key),
+      service: 'SessionAuthentication'
+    }
+  end
+
+  it 'makes a create_authentication_session POST call' do
+    request_body = JSON.parse(json_from_file('mocks/requests/SessionAuthentication/create_authentication_session.json'))
+    response_body = json_from_file('mocks/responses/SessionAuthentication/create_authentication_session.json')
+
+    url = @shared_values[:client].service_url(
+      @shared_values[:service],
+      'sessions',
+      @shared_values[:client].session_authentication.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 = @shared_values[:client].session_authentication.session_authentication_api.create_authentication_session(request_body)
+    response_hash = result.response
+
+    expect(result.status).to eq(200)
+    expect(response_hash).to eq(JSON.parse(response_body))
+    expect(response_hash).to be_a Adyen::HashWithAccessors
+    expect(response_hash).to be_a_kind_of Hash
+  end
+end