4.42.0

Author: braintreeps

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 4.42.0 
+* Update requests to not create a new request for every session
+* Add `accept_partial_authorization` to Transaction Gateway and `partially_authorized` to Transaction
+* Deprecate transactions for `visa_checkout_card` and maintain search functionality
+* Add `ach_type` to `options` -> `us_bank_account` in `Transaction.create`
+* Add `ach_type` and `requested_ach_type` response fields to `Transaction`
+
 ## 4.41.0
 * Add extra fields in `sender` and `receiver` details in `transfer` to `Transaction`
 * Remove unused error code `AdjustmentAmountMustBeGreaterThanZero`

README.md

@@ -64,6 +64,30 @@ else:
         print("  message: " + error.message)
 ```
 
+## Resource Management (Optional)
+
+For long-running applications, you can optionally call `close()` to explicitly release HTTP connections when you're done with a gateway instance:
+
+```python
+gateway = braintree.BraintreeGateway(config)
+
+# Process transactions...
+result = gateway.transaction.sale({...})
+
+# When completely done with this gateway instance
+gateway.close()
+```
+
+**When to use `close()`:**
+- Long-running web applications that create/destroy gateway instances frequently
+- Applications with strict resource management requirements
+- High-traffic applications with many concurrent threads
+
+**When you don't need `close()`:**
+- Short-lived scripts (resources are cleaned up when the script exits)
+- Applications that create a single gateway instance at startup and reuse it
+- Most typical use cases (Python's garbage collector handles cleanup automatically)
+
 ## Developing
 
 1. Create a [virtualenv](https://virtualenv.pypa.io/) called `venv`:

braintree/braintree_gateway.py

@@ -76,3 +76,7 @@ def __init__(self, config=None, **kwargs):
         self.verification = CreditCardVerificationGateway(self)
         self.webhook_notification = WebhookNotificationGateway(self)
         self.webhook_testing = WebhookTestingGateway(self)
+
+    def close(self):
+        if self.config:
+            self.config.close()

braintree/configuration.py

@@ -127,6 +127,10 @@ def graphql_client(self):
     def http_strategy(self):
         return self._http_strategy
 
+    def close(self):
+        if self._http_strategy:
+            self._http_strategy.close()
+
     def has_client_credentials(self):
         return self.client_secret is not None and self.client_id is not None
 

braintree/transaction.py

@@ -139,6 +139,7 @@ def __repr__(self):
        "network_transaction_id",
        "order_id",
        "packages",
+       "partially_authorized",
        "payment_instrument_type",
        "payment_method_token",
        "plan_id",
@@ -475,6 +476,7 @@ def clone_signature():
     @staticmethod
     def create_signature():
         return [
+            "accept_partial_authorization",
             "account_funding_transaction",
             "amount",
             # NEXT_MAJOR_VERSION use google_pay_card in public API (map to android_pay_card internally)
@@ -584,6 +586,9 @@ def create_signature():
                         "venmo": [
                             "profile_id"
                         ],
+                        "us_bank_account": [
+                            "ach_type"
+                        ],
                     },
                     {
                         "adyen": [
@@ -925,6 +930,8 @@ def __init__(self, gateway, attributes):
             self.payment_facilitator = PaymentFacilitator(attributes.pop("payment_facilitator"))
         if "transfer" in attributes:
             self.transfer = Transfer(attributes.pop("transfer"))
+        if "processor_response_code" in attributes:
+            self.partially_authorized = attributes["processor_response_code"] == "1004"
 
     @property
     def vault_billing_address(self):

braintree/transaction_amounts.py

@@ -2,6 +2,7 @@ class TransactionAmounts(object):
     """ A class of constants for transaction amounts that will cause different statuses. """
 
     Authorize = "1000.00"
+    PartiallyAuthorized = "1004.00"
     Decline = "2000.00"
     HardDecline = "2015.00"
     Fail = "3000.00"

braintree/util/http.py

@@ -1,4 +1,5 @@
 import sys
+import threading
 import requests
 from base64 import encodebytes
 import json
@@ -58,6 +59,17 @@ def raise_exception_from_status(status, message=None):
     def __init__(self, config, environment=None):
         self.config = config
         self.environment = environment or self.config.environment
+        self._thread_local = threading.local()
+
+    def _get_session(self):
+        if not hasattr(self._thread_local, 'session'):
+            self._thread_local.session = requests.Session()
+        return self._thread_local.session
+
+    def close(self):
+        if hasattr(self._thread_local, 'session'):
+            self._thread_local.session.close()
+            del self._thread_local.session
 
     def post(self, path, params=None):
         return self._make_request("POST", path, Http.ContentType.Xml, params)
@@ -113,22 +125,23 @@ def http_do(self, http_verb, path, headers, request_body):
         else:
           verify = self.environment.ssl_certificate
 
-        with requests.Session() as session:
-            request = requests.Request(
-                method=http_verb,
-                url=full_path,
-                headers=headers,
-                data=data,
-                files=files)
-            prepared_request = request.prepare()
-            prepared_request.url = full_path
-            # there's a bug in requests module that requires we manually update proxy settings,
-            # see https://github.com/psf/requests/issues/5677
-            session.proxies.update(requests.utils.getproxies())
-
-            response = session.send(prepared_request,
-                verify=verify,
-                timeout=self.config.timeout)
+        session = self._get_session()
+
+        request = requests.Request(
+            method=http_verb,
+            url=full_path,
+            headers=headers,
+            data=data,
+            files=files)
+        prepared_request = request.prepare()
+        prepared_request.url = full_path
+        # there's a bug in requests module that requires we manually update proxy settings,
+        # see https://github.com/psf/requests/issues/5677
+        session.proxies.update(requests.utils.getproxies())
+
+        response = session.send(prepared_request,
+            verify=verify,
+            timeout=self.config.timeout)
 
         return [response.status_code, response.text]
 

braintree/version.py

@@ -1 +1 @@
-Version = "4.41.0"
+Version = "4.42.0"

braintree/visa_checkout_card.py

@@ -5,7 +5,10 @@
 
 class VisaCheckoutCard(Resource):
     """
-    A class representing Visa Checkout card
+    A class representing Visa Checkout card.
+
+    DEPRECATED: Visa Checkout is no longer supported for creating new transactions.
+    This class is retained for search functionality and historical transaction data only.
     """
     def __init__(self, gateway, attributes):
         Resource.__init__(self, gateway, attributes)

setup.py

@@ -12,7 +12,7 @@
 
 setup(
     name="braintree",
-    version="4.41.0",
+    version="4.42.0",
     description="Braintree Python Library",
     long_description=long_description,
     author="Braintree",