postfinancecheckout 6.2.0__tar.gz → 6.3.0__tar.gz

{postfinancecheckout-6.2.0 → postfinancecheckout-6.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: postfinancecheckout
-Version: 6.2.0
+Version: 6.3.0
 Summary: PostFinance Checkout API
 Home-page: 
 Author: postfinancecheckout

{postfinancecheckout-6.2.0 → postfinancecheckout-6.3.0}/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,6 +2745,7 @@ 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>
@@ -2732,6 +2753,8 @@ Additional Api models documentation: [*link*](https://checkout.postfinance.ch/en
 * <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-6.2.0 → postfinancecheckout-6.3.0}/postfinancecheckout/__init__.py

@@ -25,7 +25,7 @@ limitations under the License.
 """
 
 
-__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_methods_service import PaymentMethodsSe
 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 ApiValueError
 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,6 +412,7 @@ from postfinancecheckout.models.payment_terminal_configuration_state import Paym
 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
@@ -416,6 +420,8 @@ from postfinancecheckout.models.payment_terminal_location_version_state import P
 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.refund_type import RefundType
 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.tenant_database import TenantDatabase
 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-6.2.0 → postfinancecheckout-6.3.0}/postfinancecheckout/api_client.py

@@ -181,7 +181,7 @@ class ApiClient:
 
         # 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-6.3.0/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-6.2.0 → postfinancecheckout-6.3.0}/postfinancecheckout/configuration.py

@@ -347,7 +347,7 @@ class Configuration:
                "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-6.2.0 → postfinancecheckout-6.3.0}/postfinancecheckout/models/__init__.py

@@ -302,6 +302,7 @@ from postfinancecheckout.models.payment_terminal_configuration_state import Paym
 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
@@ -309,6 +310,8 @@ from postfinancecheckout.models.payment_terminal_location_version_state import P
 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.refund_type import RefundType
 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.tenant_database import TenantDatabase
 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-6.2.0 → postfinancecheckout-6.3.0}/postfinancecheckout/models/payment_terminal_address.py

@@ -43,10 +43,10 @@ class PaymentTerminalAddress(BaseModel):
     organization_name: Optional[StrictStr] = Field(default=None, description="The organization's name.", alias="organizationName")
     city: Optional[StrictStr] = Field(default=None, description="The city, town or village.")
     given_name: Optional[StrictStr] = Field(default=None, description="The given or first name.", alias="givenName")
-    postcode: Optional[StrictStr] = Field(default=None, description="The postal code, also known as ZIP, postcode, etc.")
+    postcode: Optional[Annotated[str, Field(strict=True, max_length=12)]] = Field(default=None, description="The postal code, also known as ZIP, postcode, etc.")
     dependent_locality: Optional[Annotated[str, Field(strict=True, max_length=100)]] = Field(default=None, description="The dependent locality which is a sub-division of the state.", alias="dependentLocality")
-    email_address: Optional[Annotated[str, Field(strict=True, max_length=254)]] = Field(default=None, description="The email address.", alias="emailAddress")
-    phone_number: Optional[StrictStr] = Field(default=None, description="The phone number.", alias="phoneNumber")
+    email_address: Optional[Annotated[str, Field(strict=True, max_length=80)]] = Field(default=None, description="The email address.", alias="emailAddress")
+    phone_number: Optional[Annotated[str, Field(strict=True, max_length=20)]] = Field(default=None, description="The phone number.", alias="phoneNumber")
     sorting_code: Optional[Annotated[str, Field(strict=True, max_length=100)]] = Field(default=None, description="The sorting code identifying the post office where the PO Box is located.", alias="sortingCode")
     street: Optional[StrictStr] = Field(default=None, description="The street or PO Box.")
     family_name: Optional[StrictStr] = Field(default=None, description="The family or last name.", alias="familyName")

postfinancecheckout-6.3.0/postfinancecheckout/models/payment_terminal_dcc_transaction_sum.py

@@ -0,0 +1,128 @@
+# 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 __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class PaymentTerminalDccTransactionSum(BaseModel):
+    """
+    Represents the aggregated summary of Dynamic Currency Conversion (DCC) transactions grouped by brand and currency combinations in a transaction summary receipt.
+    """ # noqa: E501
+    transaction_currency: Optional[StrictStr] = Field(default=None, description="The original currency of the transactions before DCC conversion (typically the merchant's local currency).", alias="transactionCurrency")
+    transaction_amount: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The total sum of all transactions in the original transaction currency (the amount in merchant's local currency before DCC conversion).", alias="transactionAmount")
+    dcc_amount: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The total sum of all transactions in the converted DCC currency (the amount paid by customers in their chosen currency).", alias="dccAmount")
+    id: Optional[StrictInt] = Field(default=None, description="A unique identifier for the object.")
+    transaction_count: Optional[StrictInt] = Field(default=None, description="The total count of DCC transactions processed for this specific brand and currency combination.", alias="transactionCount")
+    dcc_currency: Optional[StrictStr] = Field(default=None, description="The converted currency used in DCC transactions (the currency chosen by the customer for payment).", alias="dccCurrency")
+    brand: Optional[StrictStr] = Field(default=None, description="The payment brand for which these DCC transactions are summarized.")
+    version: Optional[StrictInt] = Field(default=None, description="The version is used for optimistic locking and incremented whenever the object is updated.")
+    __properties: ClassVar[List[str]] = ["transactionCurrency", "transactionAmount", "dccAmount", "id", "transactionCount", "dccCurrency", "brand", "version"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of PaymentTerminalDccTransactionSum from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        """
+        excluded_fields: Set[str] = set([
+            "transaction_currency",
+            "transaction_amount",
+            "dcc_amount",
+            "id",
+            "transaction_count",
+            "dcc_currency",
+            "brand",
+            "version",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of PaymentTerminalDccTransactionSum from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "transactionCurrency": obj.get("transactionCurrency"),
+            "transactionAmount": obj.get("transactionAmount"),
+            "dccAmount": obj.get("dccAmount"),
+            "id": obj.get("id"),
+            "transactionCount": obj.get("transactionCount"),
+            "dccCurrency": obj.get("dccCurrency"),
+            "brand": obj.get("brand"),
+            "version": obj.get("version")
+        })
+        return _obj
+
+

postfinancecheckout-6.3.0/postfinancecheckout/models/payment_terminal_transaction_sum.py

@@ -0,0 +1,140 @@
+# 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 __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class PaymentTerminalTransactionSum(BaseModel):
+    """
+    Represents the aggregated transaction data for a specific brand and currency, including regular and DCC (Dynamic Currency Conversion) transactions.
+    """ # noqa: E501
+    transaction_tip_amount: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The total amount of tips from regular (non-DCC) transactions in the transaction currency.", alias="transactionTipAmount")
+    product: Optional[StrictStr] = Field(default=None, description="The product within the brand for which transactions are summarized.")
+    transaction_currency: Optional[StrictStr] = Field(default=None, description="The base currency in which the transactions were processed and settled, excluding any DCC conversions.", alias="transactionCurrency")
+    transaction_amount: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The total monetary value of all transactions in the transaction currency, excluding DCC transactions.", alias="transactionAmount")
+    dcc_tip_amount: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The total amount of tips from DCC transactions, converted and presented in the transaction currency.", alias="dccTipAmount")
+    id: Optional[StrictInt] = Field(default=None, description="A unique identifier for the object.")
+    transaction_count: Optional[StrictInt] = Field(default=None, description="The total count of regular (non-DCC) transactions processed within this summary period.", alias="transactionCount")
+    brand: Optional[StrictStr] = Field(default=None, description="The payment brand for which the transactions are summarized.")
+    dcc_transaction_count: Optional[StrictInt] = Field(default=None, description="The number of transactions where Dynamic Currency Conversion (DCC) was applied, allowing customers to pay in their home currency.", alias="dccTransactionCount")
+    version: Optional[StrictInt] = Field(default=None, description="The version is used for optimistic locking and incremented whenever the object is updated.")
+    dcc_transaction_amount: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The total monetary value of DCC transactions, converted and presented in the transaction currency.", alias="dccTransactionAmount")
+    __properties: ClassVar[List[str]] = ["transactionTipAmount", "product", "transactionCurrency", "transactionAmount", "dccTipAmount", "id", "transactionCount", "brand", "dccTransactionCount", "version", "dccTransactionAmount"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of PaymentTerminalTransactionSum from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        """
+        excluded_fields: Set[str] = set([
+            "transaction_tip_amount",
+            "product",
+            "transaction_currency",
+            "transaction_amount",
+            "dcc_tip_amount",
+            "id",
+            "transaction_count",
+            "brand",
+            "dcc_transaction_count",
+            "version",
+            "dcc_transaction_amount",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of PaymentTerminalTransactionSum from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "transactionTipAmount": obj.get("transactionTipAmount"),
+            "product": obj.get("product"),
+            "transactionCurrency": obj.get("transactionCurrency"),
+            "transactionAmount": obj.get("transactionAmount"),
+            "dccTipAmount": obj.get("dccTipAmount"),
+            "id": obj.get("id"),
+            "transactionCount": obj.get("transactionCount"),
+            "brand": obj.get("brand"),
+            "dccTransactionCount": obj.get("dccTransactionCount"),
+            "version": obj.get("version"),
+            "dccTransactionAmount": obj.get("dccTransactionAmount")
+        })
+        return _obj
+
+