From 39c9d9742090005f875ab0367782a840b780e410 Mon Sep 17 00:00:00 2001 From: qbirr agent Date: Tue, 6 Oct 2026 19:34:10 +0300 Subject: [PATCH] Document tolerance, max_age_hours and payer_error The API accepts per-call overrides for the underpayment limit ("25" = 25 ETB, "1%" = one percent) and the receipt age limit (hours, 0 disables), and returns payer_error alongside error. None of it was in this SDK. payer_error is the payer-facing wording: show it to the customer, because error is written for the merchant and can name their own saved accounts. --- src/qbirr/__init__.py | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/src/qbirr/__init__.py b/src/qbirr/__init__.py index 55fa30f..0f44346 100644 --- a/src/qbirr/__init__.py +++ b/src/qbirr/__init__.py @@ -64,6 +64,9 @@ class VerifyResult: #: a ``verified=True`` with ``"none"`` means the reference exists and the #: amount matches, but says nothing about who received the money. receiver_source: Optional[str] = None + #: The same failure written for the CUSTOMER. Show this to the payer; ``error`` + #: is the merchant-facing version and may name your own accounts. + payer_error: Optional[str] = None #: True only on sandbox (``TEST-...``) responses. sandbox: bool = False @@ -81,6 +84,7 @@ class VerifyResult: retryable=bool(data.get("retryable")), code=data.get("code") or None, receiver_source=data.get("receiver_source") or None, + payer_error=data.get("payer_error") or None, sandbox=bool(data.get("sandbox")), ) @@ -124,6 +128,8 @@ class Qbirr: amount: float, receiver_name: str, receiver_account: Optional[str] = None, + tolerance: Optional[str] = None, + max_age_hours: Optional[int] = None, ) -> VerifyResult: """ Verify a single transaction. @@ -142,6 +148,10 @@ class Qbirr: } if receiver_account: body["receiver_account"] = receiver_account + if tolerance: + body["tolerance"] = tolerance + if max_age_hours is not None: + body["max_age_hours"] = int(max_age_hours) data = self._request("POST", "/api/v1/verify", json=body) return VerifyResult.from_payload(data) @@ -155,6 +165,8 @@ class Qbirr: filename: str = "upload.pdf", content_type: str = "application/pdf", receiver_account: Optional[str] = None, + tolerance: Optional[str] = None, + max_age_hours: Optional[int] = None, ) -> VerifyResult: """ Verify by uploading a receipt file (PDF, PNG, or JPEG).