velocity-python 0.2.7__py3-none-any.whl → 0.2.8__py3-none-any.whl

velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.2.7"
+__version__ = version = "0.2.8"
 
 import importlib as _importlib
 

velocity/payment/braintree_adapter.py

@@ -113,6 +113,24 @@ def parse_braintree_environment(value: Any = None) -> str:
     return name
 
 
+def _decline_details(transaction: Any) -> Dict[str, Any]:
+    """The processor's own verdict on a declined sale, for callers that decide
+    whether to try the card again: ``processor_response_code``,
+    ``processor_response_text`` and ``processor_response_type``
+    (``approved`` / ``soft_declined`` / ``hard_declined`` -- Braintree's
+    classification; a hard decline will not be approved on retry). Only the
+    keys Braintree set; empty without a transaction (gateway rejection or
+    validation failure)."""
+    if transaction is None:
+        return {}
+    details = {
+        "processor_response_code": _attr(transaction, "processor_response_code"),
+        "processor_response_text": _attr(transaction, "processor_response_text"),
+        "processor_response_type": _attr(transaction, "processor_response_type"),
+    }
+    return {key: value for key, value in details.items() if value not in (None, "")}
+
+
 def _deep_errors(result: Any) -> List[str]:
     errors = getattr(getattr(result, "errors", None), "deep_errors", None) or []
     return [scrub(f"{error.code}: {error.message}") for error in errors]
@@ -556,7 +574,11 @@ class BraintreeAdapter(PaymentProcessorAdapter):
             "expires_at": None,
             "error_message": error_message,
             "metadata": _with_reference(
-                {"braintree_errors": _deep_errors(result)}, order_id
+                {
+                    "braintree_errors": _deep_errors(result),
+                    **_decline_details(result.transaction),
+                },
+                order_id,
             ),
         }
 
@@ -674,7 +696,12 @@ class BraintreeAdapter(PaymentProcessorAdapter):
             )
             error_message = scrub(result.transaction.processor_response_text)
         return failure(
-            "failed", error_message, {"braintree_errors": _deep_errors(result)}
+            "failed",
+            error_message,
+            {
+                "braintree_errors": _deep_errors(result),
+                **_decline_details(result.transaction),
+            },
         )
 
     def find_charge_by_reference(

velocity/payment/stripe_adapter.py

@@ -139,6 +139,16 @@ def _amount_captured(payment_intent: Any, charge: Any, requested: Optional[int])
     return 0
 
 
+def _decline_details(error: Any) -> Dict[str, Any]:
+    """``decline_code`` of a card decline (``CardError``): the issuer's reason
+    (``insufficient_funds``, ``lost_card``, ``expired_card`` ...), for callers
+    that decide whether to try the card again. Empty when Stripe gave none."""
+    decline_code = getattr(error, "decline_code", None) or getattr(
+        getattr(error, "error", None), "decline_code", None
+    )
+    return {"decline_code": decline_code} if decline_code else {}
+
+
 class StripeAdapter(PaymentProcessorAdapter):
     """
     Stripe Connect adapter for payment processing.
@@ -664,6 +674,7 @@ class StripeAdapter(PaymentProcessorAdapter):
                     "error_code": e.code,
                     "error_type": type(e).__name__,
                     "idempotency_key": idempotency_key,
+                    **_decline_details(e),
                 },
             }
             if reference:
@@ -824,6 +835,7 @@ class StripeAdapter(PaymentProcessorAdapter):
                     "error_code": e.code,
                     "error_type": type(e).__name__,
                     "idempotency_key": idempotency_key,
+                    **_decline_details(e),
                 },
             }
             if reference:

{velocity_python-0.2.7.dist-info → velocity_python-0.2.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.2.7
+Version: 0.2.8
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT
@@ -267,7 +267,6 @@ What changed in each release, and what callers must do before upgrading, is in
 | Testing Guide | `docs/TESTING.md` | Running tests, markers, coverage |
 | Security | `docs/SECURITY.md` | Pre-commit hooks, credential scanning |
 | Changelog | `CHANGELOG.md` | Per-release breaking changes, deploy ordering, additions and fixes |
-| Improvement Backlog | `docs/IMPROVEMENT_BACKLOG.md` | Proposed and deferred library improvements |
 
 ---
 

{velocity_python-0.2.7.dist-info → velocity_python-0.2.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-velocity/__init__.py,sha256=yFS8i5a6vkF9fvBhXU1pEodyDqxw4rkW3ZYGgOHV8g4,362
+velocity/__init__.py,sha256=iPrUPi45dX2tx99GwA1L_u5bjx7W7F0Y_zuF6VDGNqw,362
 velocity/cache.py,sha256=pthvw7gDVEXRzkTcQtA5YVf4Q1IxAamWsba4UReT0RE,8933
 velocity/logging.py,sha256=MAsZap1cDSdOBNRc_9ezQxup5dHOS0ARxU9NI_-UK3E,4037
 velocity/aws/__init__.py,sha256=XJJ79gnPlhg3aJij713PB8-vjQOt-BkqxYeGCBOxAu8,3460
@@ -211,7 +211,7 @@ velocity/payment/_mirror_core.py,sha256=tjZOVgueXiXdYcbxBFgv1JsDcRhEq2YVCJCSoJSb
 velocity/payment/authorizenet_adapter.py,sha256=UnMne4agLwddZOVaihOhlMZz4iBLidjMHsQn1fHTq5U,60261
 velocity/payment/authorizenet_mirror.py,sha256=IprtAYPDylHTJUUPV31SPKWqoPjdbUn5SfhvYo5BJZ8,7853
 velocity/payment/base_adapter.py,sha256=eyGo_pkTyc71qyKQ72VZql4WFtc9lp6-cLJEhHoRCE4,35760
-velocity/payment/braintree_adapter.py,sha256=tj5PNwiKpf3UwOEkou9z750WOgHP7x4pwpMG0zExhag,41647
+velocity/payment/braintree_adapter.py,sha256=IsdDu8VpmbXHafDMq6YcBGBuxO7FdOG6ALhtLSdPABw,42792
 velocity/payment/braintree_mirror.py,sha256=7SIRiIjv8HVXMFEKFOLqOWMJ46U1-64lkkTKH9hOp9Q,8497
 velocity/payment/charge_rules.py,sha256=rWgP_M-0LesQ-lMK1-IbIC8CNHvrxzf3bUlT4bNzbG0,1782
 velocity/payment/money.py,sha256=kqGTCs6wt1nlKELAtHAdiQi8HjKrI9-QSp56cyIhfbY,5785
@@ -219,13 +219,13 @@ velocity/payment/plaid_api.py,sha256=sCqQdulgRn8bFr4CpCPSQwrXcdkSUwjjWz1aS3J4u90
 velocity/payment/plaid_webhook.py,sha256=1PFTCScSqVVnyRnZhKMY2gAIn_2qg4UOrruv-wzbyMQ,13637
 velocity/payment/redact.py,sha256=aaCuQyffZG3Nb9QBEJqfkeEc7MtUxZscpDhdea6zc4o,2767
 velocity/payment/schema.py,sha256=mF8CnaIFCL4qe7z32ty1yItY1My4wD6mEAvsgZamdLI,9221
-velocity/payment/stripe_adapter.py,sha256=6EmVBZZchg2s3Teya0eQGA_8pvSK_teizr036U9G-50,68627
+velocity/payment/stripe_adapter.py,sha256=jt0QbxI6oRBSyopx8yBGB5Nv_6Llz7IKGq1ZgZ6C1Kg,69204
 velocity/payment/stripe_mirror.py,sha256=6GKJk_PjAgySqFEuxbcuV423OfuGXupVTiGu9QwS5W8,12320
 velocity/testing/__init__.py,sha256=WtYMDHgCLxOq6mlemcOYV5Y9HqF_2QQgSfuAjFRg69Q,731
 velocity/testing/fake_db.py,sha256=phgdulk5owf3noUDpEfI7yFsVcKxRGZ82f2BJPYnaiU,53226
-velocity_python-0.2.7.dist-info/licenses/LICENSE,sha256=aoN245GG8s9oRUU89KNiGTU4_4OtnNmVi4hQeChg6rM,1076
-velocity_python-0.2.7.dist-info/METADATA,sha256=jAHTQgrhvkAti0u-f01xNGRUki6kHB7euSsM3l-iPBY,17782
-velocity_python-0.2.7.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-velocity_python-0.2.7.dist-info/entry_points.txt,sha256=nXUKJHkOGQCSPoagdmMNd_qycrle1LVU-GhYknLGM1M,56
-velocity_python-0.2.7.dist-info/top_level.txt,sha256=JW2vJPmodgdgSz7H6yoZvnxF8S3fTMIv-YJWCT1sNW0,9
-velocity_python-0.2.7.dist-info/RECORD,,
+velocity_python-0.2.8.dist-info/licenses/LICENSE,sha256=aoN245GG8s9oRUU89KNiGTU4_4OtnNmVi4hQeChg6rM,1076
+velocity_python-0.2.8.dist-info/METADATA,sha256=39KY7Vt8KeztkbdTqotqSZDeCbFf3NO62M6GHFtN5Qg,17681
+velocity_python-0.2.8.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+velocity_python-0.2.8.dist-info/entry_points.txt,sha256=nXUKJHkOGQCSPoagdmMNd_qycrle1LVU-GhYknLGM1M,56
+velocity_python-0.2.8.dist-info/top_level.txt,sha256=JW2vJPmodgdgSz7H6yoZvnxF8S3fTMIv-YJWCT1sNW0,9
+velocity_python-0.2.8.dist-info/RECORD,,