Release 6.3.0

Author: wallee-deployment-user

README.md

@@ -1128,6 +1128,26 @@ Web API client: [*link*](https://app-wallee.com//api/client)<br>
   &nbsp;&nbsp;&nbsp;&nbsp;<strong>GET</strong> /payment/sales-channels/search
   &nbsp;&nbsp;&nbsp;&nbsp;Search payment sales channels.
   <br><br>
+- <strong>PaymentTerminalTransactionSummariesService</strong><br>
+  &nbsp;&nbsp;* <code>get_payment_terminals_transaction_summaries</code>
+  &nbsp;&nbsp;&nbsp;&nbsp;<strong>GET</strong> /payment/terminals/transaction-summaries
+  &nbsp;&nbsp;&nbsp;&nbsp;List all summaries
+  <br><br>
+- <strong>PaymentTerminalTransactionSummariesService</strong><br>
+  &nbsp;&nbsp;* <code>get_payment_terminals_transaction_summaries_id</code>
+  &nbsp;&nbsp;&nbsp;&nbsp;<strong>GET</strong> /payment/terminals/transaction-summaries/{id}
+  &nbsp;&nbsp;&nbsp;&nbsp;Retrieve a summary
+  <br><br>
+- <strong>PaymentTerminalTransactionSummariesService</strong><br>
+  &nbsp;&nbsp;* <code>get_payment_terminals_transaction_summaries_id_receipt</code>
+  &nbsp;&nbsp;&nbsp;&nbsp;<strong>GET</strong> /payment/terminals/transaction-summaries/{id}/receipt
+  &nbsp;&nbsp;&nbsp;&nbsp;Retrieve a rendered summary receipt
+  <br><br>
+- <strong>PaymentTerminalTransactionSummariesService</strong><br>
+  &nbsp;&nbsp;* <code>get_payment_terminals_transaction_summaries_search</code>
+  &nbsp;&nbsp;&nbsp;&nbsp;<strong>GET</strong> /payment/terminals/transaction-summaries/search
+  &nbsp;&nbsp;&nbsp;&nbsp;Search summaries
+  <br><br>
 - <strong>PaymentTerminalsService</strong><br>
   &nbsp;&nbsp;* <code>delete_payment_terminals_id</code>
   &nbsp;&nbsp;&nbsp;&nbsp;<strong>DELETE</strong> /payment/terminals/{id}
@@ -2915,13 +2935,16 @@ Additional Api models documentation: [*link*](https://app-wallee.com/en-us/doc/a
 * <strong>PaymentTerminalConfigurationVersion</strong>
 * <strong>PaymentTerminalConfigurationVersionState</strong>
 * <strong>PaymentTerminalCreate</strong>
+* <strong>PaymentTerminalDccTransactionSum</strong>
 * <strong>PaymentTerminalLocation</strong>
 * <strong>PaymentTerminalLocationState</strong>
 * <strong>PaymentTerminalLocationVersion</strong>
 * <strong>PaymentTerminalLocationVersionState</strong>
 * <strong>PaymentTerminalPreparing</strong>
 * <strong>PaymentTerminalReceiptType</strong>
 * <strong>PaymentTerminalState</strong>
+* <strong>PaymentTerminalTransactionSum</strong>
+* <strong>PaymentTerminalTransactionSummary</strong>
 * <strong>PaymentTerminalTransactionSummaryReference</strong>
 * <strong>PaymentTerminalType</strong>
 * <strong>PaymentTerminalUpdate</strong>
@@ -2981,6 +3004,7 @@ Additional Api models documentation: [*link*](https://app-wallee.com/en-us/doc/a
 * <strong>RenderedDocument</strong>
 * <strong>RenderedTerminalReceipt</strong>
 * <strong>RenderedTerminalReceiptListResponse</strong>
+* <strong>RenderedTerminalTransactionSummary</strong>
 * <strong>RestAddressFormat</strong>
 * <strong>RestAddressFormatField</strong>
 * <strong>RestApiBulkOperationResult</strong>
@@ -3106,6 +3130,8 @@ Additional Api models documentation: [*link*](https://app-wallee.com/en-us/doc/a
 * <strong>TerminalListResponse</strong>
 * <strong>TerminalReceiptFormat</strong>
 * <strong>TerminalSearchResponse</strong>
+* <strong>TerminalTransactionSummaryListResponse</strong>
+* <strong>TerminalTransactionSummarySearchResponse</strong>
 * <strong>Token</strong>
 * <strong>TokenCreate</strong>
 * <strong>TokenListResponse</strong>
@@ -3186,40 +3212,20 @@ When working with webhooks, the `WalleeRubySdk::WalleeSdkException` may throw er
 
 ### Error Code Categories
 
-| **Range** | **Category** | **Description** |
-|-----------|--------------|-----------------|
-| **404** | Not Found | Indicates that the requested resource could not be found or the endpoint returned an empty response |
-| **1000–1999** | Client-Side Errors | Errors typically caused by invalid input |
-| **2000–2999** | Server-Side Errors | Errors typically caused by incorrect data provided by the server |
-
-### Error Code Reference
-
-| **Code** | **Error Name** | **Description** | **Category** |
-|----------|----------------|-----------------|--------------|
-| 404 | `UNKNOWN_WEBHOOK_ENCRYPTION_PUBLIC_KEY` | Unknown webhook signature public key | Not Found |
-| 1000 | `WEBHOOK_ENCRYPTION_GENERAL_ERROR` | General webhook encryption error | Client-Side |
-| 1001 | `INVALID_WEBHOOK_ENCRYPTION_PUBLIC_KEY` | Invalid webhook signature public key | Client-Side |
-| 1002 | `INVALID_WEBHOOK_ENCRYPTION_HEADER_FORMAT` | Invalid webhook signature header | Client-Side |
-| 1003 | `UNSUPPORTED_WEBHOOK_ENCRYPTION_ALGORYTHM` | Unsupported webhook signature algorithm | Client-Side |
-| 1004 | `UNKNOWN_WEBHOOK_ENCRYPTION_PROVIDER` | Unknown webhook encryption provider | Client-Side |
-| 1005 | `WEBHOOK_ENCRYPTION_VERIFIER_INIT_ERROR` | Encryption verifier initialization error | Client-Side |
-| 1006 | `WEBHOOK_ENCRYPTION_VERIFIER_CONTENT_UPDATE_ERROR` | Error during content update in encryption verifier | Client-Side |
-| 1007 | `WEBHOOK_ENCRYPTION_SIGNATURE_VERIFICATION_FAILED` | Encryption signature verification failed | Client-Side |
-| 1008 | `INVALID_WEBHOOK_ENCRYPTION_CONTENT_SIGNATURE` | Invalid webhook content signature | Client-Side |
-| 2000 | `MISSING_WEBHOOK_ENCRYPTION_ALGORYTHM` | Missing webhook signature algorithm value | Server-Side |
+| **Exception**              | **Description**                                                                       |
+|----------------------------|---------------------------------------------------------------------------------------|
+| **ApiExceptionErrorCodes** | Lists the possible HTTP error codes an `ApiException` can generate                    |
+| **SdkExceptionErrorCodes** | Lists the possible error codes a `WalleeSdkException` can generate |
 
 ### Usage Example
 ```ruby
 begin
-  # Webhook SDK operation
-rescue WalleeSdkException => e
-  case e.code
-    when 1001
-        # Handle invalid public key
-    when 1007
-        # Handle signature verification failure
+  # SDK operation
+rescue WalleeRubySdk::ApiError => ex
+  if WalleeRubySdk::ApiExceptionErrorCodes.is?(ex, WalleeRubySdk::ApiExceptionErrorCodes::CONFLICT)
+    # Conflict error handling
   else
-    # Handle other errors
+    # Other error handling
   end
 end
 ```

lib/wallee-ruby-sdk.rb

@@ -25,8 +25,12 @@
 require 'wallee-ruby-sdk/api_error'
 require 'wallee-ruby-sdk/version'
 require 'wallee-ruby-sdk/configuration'
-require 'wallee-ruby-sdk/utils/encryption_util'
 require 'wallee-ruby-sdk/wallee_sdk_exception'
+require 'wallee-ruby-sdk/sdk_exception_error_codes'
+require 'wallee-ruby-sdk/api_exception_error_codes'
+
+# Utils
+require 'wallee-ruby-sdk/utils/encryption_util'
 
 # Models
 require 'wallee-ruby-sdk/models/abstract_account_update'
@@ -352,13 +356,16 @@
 require 'wallee-ruby-sdk/models/payment_terminal_configuration_version'
 require 'wallee-ruby-sdk/models/payment_terminal_configuration_version_state'
 require 'wallee-ruby-sdk/models/payment_terminal_create'
+require 'wallee-ruby-sdk/models/payment_terminal_dcc_transaction_sum'
 require 'wallee-ruby-sdk/models/payment_terminal_location'
 require 'wallee-ruby-sdk/models/payment_terminal_location_state'
 require 'wallee-ruby-sdk/models/payment_terminal_location_version'
 require 'wallee-ruby-sdk/models/payment_terminal_location_version_state'
 require 'wallee-ruby-sdk/models/payment_terminal_preparing'
 require 'wallee-ruby-sdk/models/payment_terminal_receipt_type'
 require 'wallee-ruby-sdk/models/payment_terminal_state'
+require 'wallee-ruby-sdk/models/payment_terminal_transaction_sum'
+require 'wallee-ruby-sdk/models/payment_terminal_transaction_summary'
 require 'wallee-ruby-sdk/models/payment_terminal_transaction_summary_reference'
 require 'wallee-ruby-sdk/models/payment_terminal_type'
 require 'wallee-ruby-sdk/models/payment_terminal_update'
@@ -418,6 +425,7 @@
 require 'wallee-ruby-sdk/models/rendered_document'
 require 'wallee-ruby-sdk/models/rendered_terminal_receipt'
 require 'wallee-ruby-sdk/models/rendered_terminal_receipt_list_response'
+require 'wallee-ruby-sdk/models/rendered_terminal_transaction_summary'
 require 'wallee-ruby-sdk/models/rest_address_format'
 require 'wallee-ruby-sdk/models/rest_address_format_field'
 require 'wallee-ruby-sdk/models/rest_api_bulk_operation_result'
@@ -543,6 +551,8 @@
 require 'wallee-ruby-sdk/models/terminal_list_response'
 require 'wallee-ruby-sdk/models/terminal_receipt_format'
 require 'wallee-ruby-sdk/models/terminal_search_response'
+require 'wallee-ruby-sdk/models/terminal_transaction_summary_list_response'
+require 'wallee-ruby-sdk/models/terminal_transaction_summary_search_response'
 require 'wallee-ruby-sdk/models/token'
 require 'wallee-ruby-sdk/models/token_create'
 require 'wallee-ruby-sdk/models/token_list_response'
@@ -662,6 +672,7 @@
 require 'wallee-ruby-sdk/service/payment_processor_configurations_service'
 require 'wallee-ruby-sdk/service/payment_processors_service'
 require 'wallee-ruby-sdk/service/payment_sales_channels_service'
+require 'wallee-ruby-sdk/service/payment_terminal_transaction_summaries_service'
 require 'wallee-ruby-sdk/service/payment_terminals_service'
 require 'wallee-ruby-sdk/service/payment_web_apps_service'
 require 'wallee-ruby-sdk/service/permissions_service'

lib/wallee-ruby-sdk/api_client.rb

@@ -118,7 +118,7 @@ def build_request(http_method, path, request, opts = {}, connection_timeout)
       http_method = http_method.to_sym.downcase
 
       default_headers = {
-        'x-meta-sdk-version': "6.2.0",
+        'x-meta-sdk-version': "6.3.0",
         'x-meta-sdk-language': "ruby",
         'x-meta-sdk-provider': "wallee",
         'x-meta-sdk-language-version': RUBY_VERSION

lib/wallee-ruby-sdk/api_exception_error_codes.rb

@@ -0,0 +1,60 @@
+=begin
+# Wallee AG Ruby SDK
+#
+# This library allows to interact with the Wallee AG payment service.
+#
+# Copyright owner: Wallee AG
+# Website: https://en.wallee.com
+# Developer email: ecosystem-team@wallee.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+=end
+
+module WalleeRubySdk
+  module ApiExceptionErrorCodes
+    # This class represents possible HTTP error codes which can be sent by the API.
+    # This list corresponds to https://app-wallee.com/en-us/doc/api/web-service#_errors
+
+    # The request was not accepted often due to missing or invalid parameters
+    BAD_REQUEST = 400
+    # The necessary authentication credentials are missing or incorrect
+    UNAUTHORIZED = 401
+    # The application user is missing the required permissions
+    FORBIDDEN = 403
+    # The requested resource was not found
+    NOT_FOUND = 404
+    # The requested response format is not supported
+    NOT_ACCEPTABLE = 406
+    # The request conflicts with another request often because of to optimistic locking
+    CONFLICT = 409
+    # Too many operations in a bulk request
+    PAYLOAD_TOO_LARGE = 413
+    # The request provides unsupported or invalid data
+    UNSUPPORTED_MEDIA_TYPE = 415
+    # The pagination offset exceeds the limit
+    RANGE_NOT_SATISFIABLE = 416
+    # The request is well-formed but contains semantic errors. Check the response body for details
+    UNPROCESSABLE_ENTITY = 422
+    # Too many requests hit the API too quickly
+    TOO_MANY_REQUESTS = 429
+    # An internal error occurred on the server
+    INTERNAL_SERVER_ERROR = 500
+
+    # Checks if the given exception matches the specific error code.
+    # @param exception [ApiException] The exception to check
+    # @param code [Integer] The error code to compare against
+    def self.is?(exception, code)
+      exception.code == code
+    end
+  end
+end

lib/wallee-ruby-sdk/models/payment_terminal_address.rb

@@ -205,12 +205,20 @@ def list_invalid_properties
         invalid_properties.push('invalid value for "mobile_phone_number", the character length must be smaller than or equal to 100.')
       end
 
+      if !@postcode.nil? && @postcode.to_s.length > 12
+        invalid_properties.push('invalid value for "postcode", the character length must be smaller than or equal to 12.')
+      end
+
       if !@dependent_locality.nil? && @dependent_locality.to_s.length > 100
         invalid_properties.push('invalid value for "dependent_locality", the character length must be smaller than or equal to 100.')
       end
 
-      if !@email_address.nil? && @email_address.to_s.length > 254
-        invalid_properties.push('invalid value for "email_address", the character length must be smaller than or equal to 254.')
+      if !@email_address.nil? && @email_address.to_s.length > 80
+        invalid_properties.push('invalid value for "email_address", the character length must be smaller than or equal to 80.')
+      end
+
+      if !@phone_number.nil? && @phone_number.to_s.length > 20
+        invalid_properties.push('invalid value for "phone_number", the character length must be smaller than or equal to 20.')
       end
 
       if !@sorting_code.nil? && @sorting_code.to_s.length > 100
@@ -229,8 +237,10 @@ def list_invalid_properties
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if !@mobile_phone_number.nil? && @mobile_phone_number.to_s.length > 100
+      return false if !@postcode.nil? && @postcode.to_s.length > 12
       return false if !@dependent_locality.nil? && @dependent_locality.to_s.length > 100
-      return false if !@email_address.nil? && @email_address.to_s.length > 254
+      return false if !@email_address.nil? && @email_address.to_s.length > 80
+      return false if !@phone_number.nil? && @phone_number.to_s.length > 20
       return false if !@sorting_code.nil? && @sorting_code.to_s.length > 100
       return false if !@salutation.nil? && @salutation.to_s.length > 20
       true
@@ -250,6 +260,20 @@ def mobile_phone_number=(mobile_phone_number)
       @mobile_phone_number = mobile_phone_number
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] postcode Value to be assigned
+    def postcode=(postcode)
+      if postcode.nil?
+        fail ArgumentError, 'postcode cannot be nil'
+      end
+
+      if postcode.to_s.length > 12
+        fail ArgumentError, 'invalid value for "postcode", the character length must be smaller than or equal to 12.'
+      end
+
+      @postcode = postcode
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] dependent_locality Value to be assigned
     def dependent_locality=(dependent_locality)
@@ -271,13 +295,27 @@ def email_address=(email_address)
         fail ArgumentError, 'email_address cannot be nil'
       end
 
-      if email_address.to_s.length > 254
-        fail ArgumentError, 'invalid value for "email_address", the character length must be smaller than or equal to 254.'
+      if email_address.to_s.length > 80
+        fail ArgumentError, 'invalid value for "email_address", the character length must be smaller than or equal to 80.'
       end
 
       @email_address = email_address
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] phone_number Value to be assigned
+    def phone_number=(phone_number)
+      if phone_number.nil?
+        fail ArgumentError, 'phone_number cannot be nil'
+      end
+
+      if phone_number.to_s.length > 20
+        fail ArgumentError, 'invalid value for "phone_number", the character length must be smaller than or equal to 20.'
+      end
+
+      @phone_number = phone_number
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] sorting_code Value to be assigned
     def sorting_code=(sorting_code)