Release 4.2.0

Author: wallee-deployment-user

README.md

@@ -108,6 +108,39 @@ payment_page_url = transaction_payment_page_service.payment_page_url(space_id=sp
 # redirect your customer to this payment_page_url
 ```
 
+### Integrating Webhook Payload Signing Mechanism into webhook callback handler
+
+The HTTP request which is sent for a state change of an entity now includes an additional field `state`, which provides information about the update of the monitored entity's state. This enhancement is a result of the implementation of our webhook encryption mechanism.
+
+Payload field `state` provides direct information about the state update of the entity, making additional API calls to retrieve the entity state redundant.
+
+#### ⚠️ Warning: Generic Pseudocode
+
+> **The provided pseudocode is intentionally generic and serves to illustrate the process of enhancing your API to leverage webhook payload signing. It is not a complete implementation.**
+>
+> Please ensure that you adapt and extend this code to meet the specific needs of your application, including appropriate security measures and error handling.
+For a detailed webhook payload signing mechanism understanding we highly recommend referring to our comprehensive
+[Webhook Payload Signing Documentation](https://app-wallee.com/doc/webhooks#_webhook_payload_signing_mechanism).
+
+```python
+@app.route('/webhook/callback', methods=['POST'])
+def handle_webhook():
+    request_payload = request.data.decode('utf-8')
+    signature = request.headers.get('x-signature')
+
+    if not signature:
+        # Make additional API call to retrieve the entity state
+        # ...
+    else:
+        if webhook_encryption_service().is_content_valid(signature_header=signature, content_to_verify=request_payload):
+            # Parse request_payload to extract 'state' value
+            # Process entity's state change
+            # ...
+
+    # Process the received webhook data
+    # ...
+
+```
 
 ## License
 

setup.py

@@ -6,7 +6,7 @@
     long_description = fh.read()
 
 NAME = "wallee"
-VERSION = "4.1.0"
+VERSION = "4.2.0"
 
 REQUIRES = [
     "certifi >= 14.05.14",

wallee/api_client.py

@@ -4,7 +4,7 @@
 
     Python SDK
 
-    OpenAPI spec version: 4.1.0
+    OpenAPI spec version: 4.2.0
     
 """
 
@@ -67,7 +67,7 @@ def __init__(self, configuration=None, header_name=None, header_value=None,
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'wallee/4.1.0/python'
+        self.user_agent = 'wallee/4.2.0/python'
 
     def __del__(self):
         if self._pool is not None:
@@ -106,7 +106,7 @@ def __call_api(
 
         # predefined default headers
         default_headers = {
-            'x-meta-sdk-version': '4.1.0',
+            'x-meta-sdk-version': '4.2.0',
             'x-meta-sdk-language': 'python',
             'x-meta-sdk-provider': 'wallee',
             'x-meta-sdk-language-version': platform.python_version()

wallee/configuration.py

@@ -262,6 +262,6 @@ def to_debug_report(self):
         return "Python SDK Debug Report:\n"\
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
-               "Version of the API: 4.1.0\n"\
-               "SDK Package Version: 4.1.0".\
+               "Version of the API: 4.2.0\n"\
+               "SDK Package Version: 4.2.0".\
                format(env=sys.platform, pyversion=sys.version)