Release 6.3.0

Author: wallee-deployment-user

README.md

@@ -1038,6 +1038,26 @@ Web Api client: [*link*](https://checkout.postfinance.ch//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}
@@ -2725,13 +2745,16 @@ Additional Api models documentation: [*link*](https://checkout.postfinance.ch/en
 * <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>
@@ -2791,6 +2814,7 @@ Additional Api models documentation: [*link*](https://checkout.postfinance.ch/en
 * <strong>RenderedDocument</strong>
 * <strong>RenderedTerminalReceipt</strong>
 * <strong>RenderedTerminalReceiptListResponse</strong>
+* <strong>RenderedTerminalTransactionSummary</strong>
 * <strong>RestAddressFormat</strong>
 * <strong>RestAddressFormatField</strong>
 * <strong>RestApiBulkOperationResult</strong>
@@ -2916,6 +2940,8 @@ Additional Api models documentation: [*link*](https://checkout.postfinance.ch/en
 * <strong>TerminalListResponse</strong>
 * <strong>TerminalReceiptFormat</strong>
 * <strong>TerminalSearchResponse</strong>
+* <strong>TerminalTransactionSummaryListResponse</strong>
+* <strong>TerminalTransactionSummarySearchResponse</strong>
 * <strong>Token</strong>
 * <strong>TokenCreate</strong>
 * <strong>TokenListResponse</strong>
@@ -2996,44 +3022,20 @@ When working with webhooks, the `PostFinanceCheckoutSdkException` may throw erro
 
 ### 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 `PostFinanceCheckoutSdkException` can generate |
 
 ### Usage Example
 ```python
-from postfinancecheckout.postfinancecheckout_sdk_exception import PostFinanceCheckoutSdkException
-
 try:
-    # Webhook SDK operation
-except PostFinanceCheckoutSdkException as e:
-    if e.code == 1001:  # INVALID_WEBHOOK_ENCRYPTION_PUBLIC_KEY
-        # Handle invalid public key
-        pass
-    elif e.code == 1007:  # WEBHOOK_ENCRYPTION_SIGNATURE_VERIFICATION_FAILED
-        # Handle signature verification failure
-        pass
+    # SDK operation
+except ApiException as ex:
+    if ApiExceptionErrorCodes.CONFLICT.matches(ex):
+        # Handle Conflict
     else:
-        # Handle other errors
-        pass
+        # Other handling
 ```
 
 ## Author

postfinancecheckout/__init__.py

@@ -25,7 +25,7 @@
 """
 
 
-__version__ = "6.2.0"
+__version__ = "6.3.0"
 
 # import apis into sdk package
 from postfinancecheckout.service.accounts_service import AccountsService
@@ -70,6 +70,7 @@
 from postfinancecheckout.service.payment_processor_configurations_service import PaymentProcessorConfigurationsService
 from postfinancecheckout.service.payment_processors_service import PaymentProcessorsService
 from postfinancecheckout.service.payment_sales_channels_service import PaymentSalesChannelsService
+from postfinancecheckout.service.payment_terminal_transaction_summaries_service import PaymentTerminalTransactionSummariesService
 from postfinancecheckout.service.payment_terminals_service import PaymentTerminalsService
 from postfinancecheckout.service.permissions_service import PermissionsService
 from postfinancecheckout.service.refund_bank_transactions_service import RefundBankTransactionsService
@@ -126,6 +127,8 @@
 from postfinancecheckout.exceptions import ApiKeyError
 from postfinancecheckout.exceptions import ApiAttributeError
 from postfinancecheckout.exceptions import ApiException
+from postfinancecheckout.api_exception_error_codes import ApiExceptionErrorCodes
+from postfinancecheckout.sdk_exception_error_codes import SdkExceptionErrorCodes
 from postfinancecheckout.postfinancecheckout_sdk_exception import PostFinanceCheckoutSdkException
 
 # import utils into sdk package
@@ -409,13 +412,16 @@
 from postfinancecheckout.models.payment_terminal_configuration_version import PaymentTerminalConfigurationVersion
 from postfinancecheckout.models.payment_terminal_configuration_version_state import PaymentTerminalConfigurationVersionState
 from postfinancecheckout.models.payment_terminal_create import PaymentTerminalCreate
+from postfinancecheckout.models.payment_terminal_dcc_transaction_sum import PaymentTerminalDccTransactionSum
 from postfinancecheckout.models.payment_terminal_location import PaymentTerminalLocation
 from postfinancecheckout.models.payment_terminal_location_state import PaymentTerminalLocationState
 from postfinancecheckout.models.payment_terminal_location_version import PaymentTerminalLocationVersion
 from postfinancecheckout.models.payment_terminal_location_version_state import PaymentTerminalLocationVersionState
 from postfinancecheckout.models.payment_terminal_preparing import PaymentTerminalPreparing
 from postfinancecheckout.models.payment_terminal_receipt_type import PaymentTerminalReceiptType
 from postfinancecheckout.models.payment_terminal_state import PaymentTerminalState
+from postfinancecheckout.models.payment_terminal_transaction_sum import PaymentTerminalTransactionSum
+from postfinancecheckout.models.payment_terminal_transaction_summary import PaymentTerminalTransactionSummary
 from postfinancecheckout.models.payment_terminal_transaction_summary_reference import PaymentTerminalTransactionSummaryReference
 from postfinancecheckout.models.payment_terminal_type import PaymentTerminalType
 from postfinancecheckout.models.payment_terminal_update import PaymentTerminalUpdate
@@ -475,6 +481,7 @@
 from postfinancecheckout.models.rendered_document import RenderedDocument
 from postfinancecheckout.models.rendered_terminal_receipt import RenderedTerminalReceipt
 from postfinancecheckout.models.rendered_terminal_receipt_list_response import RenderedTerminalReceiptListResponse
+from postfinancecheckout.models.rendered_terminal_transaction_summary import RenderedTerminalTransactionSummary
 from postfinancecheckout.models.rest_address_format import RestAddressFormat
 from postfinancecheckout.models.rest_address_format_field import RestAddressFormatField
 from postfinancecheckout.models.rest_api_bulk_operation_result import RestApiBulkOperationResult
@@ -600,6 +607,8 @@
 from postfinancecheckout.models.terminal_list_response import TerminalListResponse
 from postfinancecheckout.models.terminal_receipt_format import TerminalReceiptFormat
 from postfinancecheckout.models.terminal_search_response import TerminalSearchResponse
+from postfinancecheckout.models.terminal_transaction_summary_list_response import TerminalTransactionSummaryListResponse
+from postfinancecheckout.models.terminal_transaction_summary_search_response import TerminalTransactionSummarySearchResponse
 from postfinancecheckout.models.token import Token
 from postfinancecheckout.models.token_create import TokenCreate
 from postfinancecheckout.models.token_list_response import TokenListResponse

postfinancecheckout/api_client.py

@@ -181,7 +181,7 @@ def param_serialize(
 
         # predefined default headers
         default_headers = {
-            'x-meta-sdk-version': '6.2.0',
+            'x-meta-sdk-version': '6.3.0',
             'x-meta-sdk-language': 'python',
             'x-meta-sdk-provider': 'postfinancecheckout',
             'x-meta-sdk-language-version': platform.python_version()

postfinancecheckout/api_exception_error_codes.py

@@ -0,0 +1,69 @@
+# coding: utf-8
+
+"""
+PostFinance Python SDK
+
+This library allows to interact with the PostFinance payment service.
+
+Copyright owner: Wallee AG
+Website: https://www.postfinance.ch/en/private.html
+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.
+"""
+
+
+from enum import Enum
+
+class ApiExceptionErrorCodes(Enum):
+    """
+    This class represents possible HTTP error codes which can be sent by the API.
+    This list corresponds to https://checkout.postfinance.ch/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
+    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
+
+    def __init__(self, http_code):
+        self._http_code = http_code
+
+    @property
+    def http_code(self):
+        return self._http_code
+
+    def matches(self, api_exception):
+        """
+        Checks if the given exception matches this error code.
+        """
+        return api_exception.status == self.http_code

postfinancecheckout/configuration.py

@@ -347,7 +347,7 @@ def to_debug_report(self) -> str:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 2.0\n"\
-               "SDK Package Version: 6.2.0".\
+               "SDK Package Version: 6.3.0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

postfinancecheckout/error_code.py

@@ -302,13 +302,16 @@
 from postfinancecheckout.models.payment_terminal_configuration_version import PaymentTerminalConfigurationVersion
 from postfinancecheckout.models.payment_terminal_configuration_version_state import PaymentTerminalConfigurationVersionState
 from postfinancecheckout.models.payment_terminal_create import PaymentTerminalCreate
+from postfinancecheckout.models.payment_terminal_dcc_transaction_sum import PaymentTerminalDccTransactionSum
 from postfinancecheckout.models.payment_terminal_location import PaymentTerminalLocation
 from postfinancecheckout.models.payment_terminal_location_state import PaymentTerminalLocationState
 from postfinancecheckout.models.payment_terminal_location_version import PaymentTerminalLocationVersion
 from postfinancecheckout.models.payment_terminal_location_version_state import PaymentTerminalLocationVersionState
 from postfinancecheckout.models.payment_terminal_preparing import PaymentTerminalPreparing
 from postfinancecheckout.models.payment_terminal_receipt_type import PaymentTerminalReceiptType
 from postfinancecheckout.models.payment_terminal_state import PaymentTerminalState
+from postfinancecheckout.models.payment_terminal_transaction_sum import PaymentTerminalTransactionSum
+from postfinancecheckout.models.payment_terminal_transaction_summary import PaymentTerminalTransactionSummary
 from postfinancecheckout.models.payment_terminal_transaction_summary_reference import PaymentTerminalTransactionSummaryReference
 from postfinancecheckout.models.payment_terminal_type import PaymentTerminalType
 from postfinancecheckout.models.payment_terminal_update import PaymentTerminalUpdate
@@ -368,6 +371,7 @@
 from postfinancecheckout.models.rendered_document import RenderedDocument
 from postfinancecheckout.models.rendered_terminal_receipt import RenderedTerminalReceipt
 from postfinancecheckout.models.rendered_terminal_receipt_list_response import RenderedTerminalReceiptListResponse
+from postfinancecheckout.models.rendered_terminal_transaction_summary import RenderedTerminalTransactionSummary
 from postfinancecheckout.models.rest_address_format import RestAddressFormat
 from postfinancecheckout.models.rest_address_format_field import RestAddressFormatField
 from postfinancecheckout.models.rest_api_bulk_operation_result import RestApiBulkOperationResult
@@ -493,6 +497,8 @@
 from postfinancecheckout.models.terminal_list_response import TerminalListResponse
 from postfinancecheckout.models.terminal_receipt_format import TerminalReceiptFormat
 from postfinancecheckout.models.terminal_search_response import TerminalSearchResponse
+from postfinancecheckout.models.terminal_transaction_summary_list_response import TerminalTransactionSummaryListResponse
+from postfinancecheckout.models.terminal_transaction_summary_search_response import TerminalTransactionSummarySearchResponse
 from postfinancecheckout.models.token import Token
 from postfinancecheckout.models.token_create import TokenCreate
 from postfinancecheckout.models.token_list_response import TokenListResponse