BTI-1166 - Python SDK | Update, Test & Release 0.2.0

.gitignore

@@ -14,6 +14,16 @@ htmlcov/
 .DS_Store
 __pycache__/
 *.pyc
+__pycache__/
+*.pyo
+
+# local environment
 .env
+.venv/
+venv/
 
+# logs
 *.log
+
+# type checking
+.mypy_cache/

CHANGELOG.md

@@ -6,6 +6,19 @@ All notable changes to this project will be documented in this file.
 
 ## [Released]
 
+## [0.2.0]
+- BTI-977 Add Point of Sale (POS) payment method
+- BTI-22 Add Credit Management solution
+- BTI-16 Add Split Payments (Marketplaces) solution
+- BTI-23 Add eMandate solution (B2C + B2B)
+- BTI-21 Implement instant refunds for iDEAL and Payconiq
+- BTI-20 Add iDIN verification method (identify, verify, login)
+- BTI-17 Add PayPerEmail example and feature test
+- BTI-584 Update Klarna MOR to DataRequestKey flow
+- BTI-1077 Add In3 authorize/capture flow
+- BTI-721 Add Banking service (PaymentOrder payout)
+- BTI-978 Add In3 route param for ABN-AMRO Achteraf Betalen
+
 ## [0.1.1]
 - BTI-1091 Send the culture code as the `Culture` request header
 - Add PayPerEmail builder for PaymentInvitation

README.md

@@ -16,6 +16,7 @@
 - [eMandate](#emandate)
 - [Split Payments](#split-payments)
 - [Credit Management](#credit-management)
+- [Point of Sale (POS)](#point-of-sale-pos)
 - [Contribute](#contribute)
 - [Versioning](#versioning)
 - [Additional information](#additional-information)
@@ -442,6 +443,42 @@ top-level, `originalInvoiceNumber` and `Debtor` as service parameters),
 See [`examples/credit_management.py`](examples/credit_management.py) for a
 runnable demo of the main actions.
 
+### Point of Sale (POS)
+
+POS transactions are PIN-based in-store payments processed through a physical payment terminal.
+You initiate the transaction via API with the terminal's unique `TerminalID`; Buckaroo routes the
+request to that terminal, which prompts the customer to complete payment there. There's no
+redirect flow, every request is sent with a fixed `Channel: "Web"`, set internally by the SDK.
+
+The immediate response carries a pending/awaiting status. The final result, plus the printable
+`Ticket` receipt text for the customer, arrives later via push notification.
+
+```python
+response = payments.create_payment("pospayment", {
+    "currency": "EUR",
+    "amount": 0.01,
+    "invoice": "TestFactuur01",
+}).terminal_id("50000001").pay()
+
+print("key:", response.key)
+print("pending:", response.is_pending())
+```
+
+Parsing the push notification once the terminal completes the transaction push bodies wrap the
+transaction under a `Transaction` key, so unwrap it before handing it to `PaymentResponse`:
+
+```python
+from buckaroo.models.payment_response import PaymentResponse
+
+transaction = push_json["Transaction"]  # raw body your webhook endpoint received
+response = PaymentResponse({"data": transaction})
+
+ticket = response.get_service_parameter("Ticket")  # printable receipt text
+```
+
+See [`examples/pos_payment.py`](examples/pos_payment.py) for a runnable demo of both the `Pay`
+action and push-notification parsing.
+
 ### Contribute
 
 We really appreciate it when developers contribute to improve the Buckaroo plugins.

buckaroo/_buckaroo_client.py

@@ -1,3 +1,4 @@
+import logging
 from typing import Optional
 from .exceptions._authentication_error import AuthenticationError
 from .config.buckaroo_config import BuckarooConfig, create_config_from_mode
@@ -118,7 +119,13 @@ def confirm_credential(self) -> bool:
         try:
             response = self.http_client.get("/json/Transaction/Specification/ideal")
             return response.success
-        except Exception:
+        except Exception as e:
+            logging.warning(
+                "confirm_credential: unexpected error during credential check "
+                "(network issue or unexpected API response): %s",
+                e,
+                exc_info=True,
+            )
             return False
 
     def get_config_info(self) -> dict:

buckaroo/_version.py

@@ -1 +1 @@
-VERSION = "0.1.1"
+VERSION = "0.2.0"