4.36.0

Co-authored-by: Kevin Laguerre <[email protected]>

Author: braintreeps

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 4.36.0
+* Add `account_information_inquiry` to:
+  * `CreditCardVerification.create`
+  * `PaymentMethod.create` and `PaymentMethod.update`
+  * `CreditCard.create` and `CreditCard.update`
+* Enhancements to PayPal customer recommendations
+  * Create a session and get recommendations in one call
+  * Hash customer email and phone number
+* Add business, consumer, corporate, purchase from bin data in credit card responses
+
 ## 4.35.0
 * Add support for capturing payment facilitator and sub-merchant details with transactions 
 * Remove marketplace features

README.md

@@ -14,7 +14,7 @@ The Braintree Python SDK is tested against Python versions 3.5.3 and 3.12.0.
 _The Python core development community has released [End-of-Life branches](https://devguide.python.org/devcycle/#end-of-life-branches) for Python versions 2.7 - 3.4, and are no longer receiving [security updates](https://devguide.python.org/#branchstatus). As a result, Braintree no longer supports these versions of Python._
 
 ## Versions
-> :warning: **The SSL certificates for Python SDK versions older than 4.31.0 are set to expire by June 31, 2025. If you do not update your SDK to the latest version with the updated certificates by June 31, 2025, 100% of your impacted traffic will fail**
+> :warning: **The SSL certificates for Python SDK versions older than 3.40.0 are set to expire by March 30, 2026. If you do not update your SDK to the latest version with the updated certificates by March 30, 2026, 100% of your impacted traffic will fail**
 
 Braintree employs a deprecation policy for our SDKs. For more information on the statuses of an SDK check our [developer docs](https://developer.paypal.com/braintree/docs/reference/general/server-sdk-deprecation-policy).
 

braintree/__init__.py

@@ -39,6 +39,7 @@
 from braintree.liability_shift import LiabilityShift
 from braintree.local_payment_completed import LocalPaymentCompleted
 from braintree.local_payment_reversed import LocalPaymentReversed
+from braintree.monetary_amount import MonetaryAmount
 from braintree.merchant import Merchant
 from braintree.merchant_account import MerchantAccount
 from braintree.merchant_account_gateway import MerchantAccountGateway 

braintree/credit_card.py

@@ -128,6 +128,7 @@ class DebitNetwork(Enum):
         Star_Access = "STAR_ACCESS"
 
     Commercial = CountryOfIssuance = Debit = DurbinRegulated = \
+            Business = Consumer = Corporate = Purchase = \
             Healthcare = IssuingBank = Payroll = Prepaid = PrepaidReloadable = ProductId = CardTypeIndicator
 
     @staticmethod
@@ -235,6 +236,7 @@ def signature(type):
         ]
 
         options = [
+            "account_information_inquiry",
             "fail_on_duplicate_payment_method",
             "fail_on_duplicate_payment_method_for_customer",
             "make_default",

braintree/credit_card_verification.py

@@ -83,7 +83,7 @@ def create_signature():
                 "status"
             ]
         options_params = [
-                "account_type", "amount", "merchant_account_id"
+                "account_type", "amount", "merchant_account_id", "account_information_inquiry"
             ]
         risk_data_params = [
                 "customer_browser",

braintree/customer_session_gateway.py

@@ -10,10 +10,10 @@
     CustomerRecommendations,
     CustomerRecommendationsInput,
     CustomerRecommendationsPayload,
+    RecommendedPaymentOption,
     PaymentOptions,
 )
 
-
 class CustomerSessionGateway:
     """
     Creates and manages PayPal customer sessions.
@@ -109,59 +109,60 @@ def update_customer_session(self, update_customer_session_input: UpdateCustomerS
         variables = dict({"input": update_customer_session_input.to_graphql_variables()})
         return self._execute_mutation(mutation, variables, "updateCustomerSession")
 
-    def get_customer_recommendations(self, customer_recommendations_input: CustomerRecommendationsInput):
+    def get_customer_recommendations(self, get_customer_recommendations_input: CustomerRecommendationsInput):
         """
         Retrieves customer recommendations associated with a customer session.
 
         Example:
 
           recommendations_input = (
             CustomerRecommendationsInput
-              .builder(session_id, [Recommendations.PAYMENT_RECOMMENDATIONS])
+              .builder()
+              .session_id(session_id)
               .build()
           )
 
           result = gateway.customer_session.get_customer_recommendations(recommendations_input)
          
           if result.is_success:
-            print(result.customer_recommendations)
+            print(result.customer_recommendations.recommendations.payment_recommendations)
 
         Args:
-            CustomerRecommendationsInput: Input object for retrieving customer recommendations.
+            GenerateCustomerRecommendationsInput: Input object for retrieving customer recommendations.
         
         Returns:
-            (Successful|Error)Result: A result object containing a CustomerRecommendationsPayload and a success flag if successful, or errors otherwise.
+            (Successful|Error)Result: A result object containing a GenerateCustomerRecommendationsPayload and a success flag if successful, or errors otherwise.
 
         Raises:
             UnexpectedError: If there is an unexpected error during the process.
         """
         query = """
-            query CustomerRecommendations($input: CustomerRecommendationsInput!) {
-                customerRecommendations(input: $input) {
+            mutation GenerateCustomerRecommendations($input: GenerateCustomerRecommendationsInput!) {
+                generateCustomerRecommendations(input: $input) {
                   isInPayPalNetwork
-                  recommendations {
-                    ... on PaymentRecommendations {
-                      paymentOptions {
-                        paymentOption
-                        recommendedPriority
-                      }
-                    }
+                  paymentRecommendations{
+                    paymentOption
+                    recommendedPriority
                   }
                 }
               }
         """
-        variables = dict({"input": customer_recommendations_input.to_graphql_variables()})
-
+        variables = dict({"input": get_customer_recommendations_input.to_graphql_variables()})
         response = self.graphql_client.query(query, variables)
         errors = GraphQLClient.get_validation_errors(response)
+
         if errors:
             return ErrorResult(self.gateway, {"errors": errors, "message": "Validation errors were found."})
         try:
-            recommendations_payload = self._extract_customer_recommendations_payload(response)
-            return SuccessfulResult({"customer_recommendations": recommendations_payload})
+            recommendations_payload = response["data"]
+            customer_recommendations = CustomerRecommendationsPayload(
+                response = recommendations_payload
+            )
+            return SuccessfulResult({"customer_recommendations": customer_recommendations})
         except KeyError:
             raise UnexpectedError("Couldn't parse response")
 
+    
     def _execute_mutation(self, mutation: str, variables: Dict, operation: str):
         response = self.graphql_client.query(mutation, variables)
         errors = GraphQLClient.get_validation_errors(response)
@@ -171,23 +172,4 @@ def _execute_mutation(self, mutation: str, variables: Dict, operation: str):
             session_id = response["data"][operation]["sessionId"]
             return  SuccessfulResult({"session_id": session_id})
         except KeyError:
-            raise UnexpectedError("Couldn't parse response")
-
-    def _extract_customer_recommendations_payload(self, response):
-        customer_recommendations = response["data"]["customerRecommendations"]
-
-        is_in_paypal_network = customer_recommendations["isInPayPalNetwork"]
-        recommendations = [] if customer_recommendations["recommendations"] is None else customer_recommendations["recommendations"]["paymentOptions"]
-        payment_options = [
-            PaymentOptions(
-                    recommendation_data["paymentOption"],
-                    recommendation_data["recommendedPriority"]
-            ) 
-            for recommendation_data in recommendations
-        ]
-
-        recommendations_union = CustomerRecommendations(payment_options)
-        return CustomerRecommendationsPayload(is_in_paypal_network, recommendations_union)
-
-
-
+            raise UnexpectedError("Couldn't parse response")

braintree/exchange_rate_quote.py

@@ -1,5 +1,5 @@
 from braintree.attribute_getter import AttributeGetter
-from braintree.montary_amount import MontaryAmount
+from braintree.monetary_amount import MonetaryAmount
 
 class ExchangeRateQuote(AttributeGetter):
     def __init__(self,attributes):

braintree/exchange_rate_quote_payload.py

@@ -1,5 +1,5 @@
 from braintree.exchange_rate_quote import ExchangeRateQuote
-from braintree.montary_amount import MontaryAmount
+from braintree.monetary_amount import MonetaryAmount
 
 class ExchangeRateQuotePayload(object):
     def __init__(self, data):
@@ -11,10 +11,10 @@ def __init__(self, data):
                 quote_amount_obj = quote_obj.get("quoteAmount")
                 base_attrs = {"value":base_amount_obj.get("value"),
                               "currency_code":base_amount_obj.get("currencyCode")}
-                base_amount = MontaryAmount(base_attrs)
+                base_amount = MonetaryAmount(base_attrs)
                 quote_attrs = {"value":quote_amount_obj.get("value"),
                                "currency_code":quote_amount_obj.get("currencyCode")}
-                quote_amount = MontaryAmount(quote_attrs)
+                quote_amount = MonetaryAmount(quote_attrs)
                 attributes = {"id":quote_obj.get("id"),
                               "exchange_rate":quote_obj.get("exchangeRate"),
                               "trade_rate":quote_obj.get("tradeRate"),

braintree/graphql/__init__.py

@@ -1,17 +1,21 @@
 from braintree.graphql.enums import (
     RecommendedPaymentOption,
-    Recommendations
+    Recommendations, 
 )
 from braintree.graphql.inputs import (
     PhoneInput,
     CustomerSessionInput,
     CreateCustomerSessionInput,
     UpdateCustomerSessionInput,
     CustomerRecommendationsInput,
+    MonetaryAmountInput, 
+    PayPalPayeeInput,
+    PayPalPurchaseUnitInput,
 )
 from braintree.graphql.types import (
     CustomerRecommendationsPayload,
-    PaymentOptions
+    PaymentOptions, 
+    PaymentRecommendation
 )
 from braintree.graphql.unions import (
     CustomerRecommendations

braintree/graphql/enums/__init__.py

@@ -1,2 +1,2 @@
 from braintree.graphql.enums.recommended_payment_option import RecommendedPaymentOption
-from braintree.graphql.enums.recommendations import Recommendations
+from braintree.graphql.enums.recommendations import Recommendations