4.39.0

Co-authored-by: David Johnson <[email protected]>

Author: braintreeps

.github/workflows/security.dependency-review.yml

@@ -0,0 +1,10 @@
+name: Security
+
+on:
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+jobs:
+  dependency-review:
+    uses: PayPal-Braintree/security-workflows/.github/workflows/dependency-review.yml@main

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## Unreleased
+* Add Bank Account Instant Verification functionality
+* Add `BankAccountInstantVerificationGateway` for creating JWTs
+* Add `BankAccountInstantVerificationJwt` response object
+* Add `BankAccountInstantVerificationJwtRequest` for JWT creation
+* Add `ach_mandate_text` and `ach_mandate_accepted_at` fields to `TransactionUsBankAccountRequest`
+* Add `INSTANT_VERIFICATION_ACCOUNT_VALIDATION` method to `UsBankAccountVerification.VerificationMethod`
+* Add support for US bank account ACH mandate fields in transaction requests
+* Add `ach_reject_reason` field to Transaction
+* Add `sender` and `receiver` to `transfer` in `Transaction`
+* Add `is_device_token` to ApplePayCard and ApplePayDetails
+
 ## 4.38.0
 * Add `upcoming_retry_date` field to Transaction
 * Add `remaining_file_evidence_storage` to Dispute
@@ -20,7 +32,7 @@
 * 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 
+* Add support for capturing payment facilitator and sub-merchant details with transactions
 * Remove marketplace features
 
 ## 4.34.0
@@ -34,11 +46,11 @@
 * Add support for creating and updating PayPal customer session
 * Add support for getting PayPal customer recommendations
 
-## 4.32.0 
-* Add recipient/contact info: `recipient_email`and `recipient_phone` to `Transaction` 
+## 4.32.0
+* Add recipient/contact info: `recipient_email`and `recipient_phone` to `Transaction`
 
 ## 4.31.0
-* Add `fail_on_duplicate_payment_method_for_customer` option to 
+* Add `fail_on_duplicate_payment_method_for_customer` option to
   * `ClientToken`
   * `PaymentMethod`
   * `CreditCard`
@@ -98,14 +110,14 @@
 * Fix unittest compatibility with Python 3.12 (Thanks @mgorny)
 
 ## 4.23.0
-* Deprecate `evidenceSubmittable` in Dispute 
+* Deprecate `evidenceSubmittable` in Dispute
 * Add missing `escape` calls in `generator` for:
   * list
   * bool
   * integer
   * datetime
 
-## 4.22.0 
+## 4.22.0
 * Add `processing_overrides` to `Transaction.sale` options
 
 ## 4.21.0

braintree/__init__.py

@@ -7,6 +7,9 @@
 from braintree.android_pay_card import AndroidPayCard
 from braintree.apple_pay_card import ApplePayCard
 from braintree.apple_pay_gateway import ApplePayGateway
+from braintree.bank_account_instant_verification_gateway import BankAccountInstantVerificationGateway
+from braintree.bank_account_instant_verification_jwt import BankAccountInstantVerificationJwt
+from braintree.bank_account_instant_verification_jwt_request import BankAccountInstantVerificationJwtRequest
 from braintree.blik_alias import BlikAlias
 from braintree.braintree_gateway import BraintreeGateway
 from braintree.client_token import ClientToken
@@ -56,10 +59,12 @@
 from braintree.plan import Plan
 from braintree.plan_gateway import PlanGateway
 from braintree.processor_response_types import ProcessorResponseTypes
+from braintree.receiver import Receiver
 from braintree.resource_collection import ResourceCollection
 from braintree.risk_data import RiskData
 from braintree.samsung_pay_card import SamsungPayCard
 from braintree.search import Search
+from braintree.sender import Sender
 from braintree.sepa_direct_debit_account import SepaDirectDebitAccount
 from braintree.settlement_batch_summary import SettlementBatchSummary
 from braintree.signature_service import SignatureService
@@ -78,9 +83,11 @@
 from braintree.transaction_gateway import TransactionGateway
 from braintree.transaction_line_item import TransactionLineItem
 from braintree.transaction_search import TransactionSearch
+from braintree.transaction_us_bank_account_request import TransactionUsBankAccountRequest
 from braintree.transfer import Transfer
 from braintree.unknown_payment_method import UnknownPaymentMethod
 from braintree.us_bank_account import UsBankAccount
+from braintree.us_bank_account_verification import UsBankAccountVerification
 from braintree.validation_error_collection import ValidationErrorCollection
 from braintree.venmo_account import VenmoAccount
 from braintree.venmo_profile_data import VenmoProfileData

braintree/bank_account_instant_verification_gateway.py

@@ -0,0 +1,43 @@
+from braintree.bank_account_instant_verification_jwt import BankAccountInstantVerificationJwt
+from braintree.successful_result import SuccessfulResult
+from braintree.error_result import ErrorResult
+from braintree.exceptions.unexpected_error import UnexpectedError
+from braintree.util.graphql_client import GraphQLClient
+
+
+class BankAccountInstantVerificationGateway(object):
+    def __init__(self, gateway):
+        self.gateway = gateway
+        self.config = self.gateway.config
+        self.graphql_client = self.gateway.graphql_client
+
+    CREATE_JWT_MUTATION = """
+        mutation CreateBankAccountInstantVerificationJwt($input: CreateBankAccountInstantVerificationJwtInput!) {
+            createBankAccountInstantVerificationJwt(input: $input) {
+                jwt
+            }
+        }
+    """
+
+    def create_jwt(self, request):
+        try: 
+            variables = dict({"input": request.to_graphql_variables()})
+            response = self.graphql_client.query(self.CREATE_JWT_MUTATION, variables)
+            
+            if "errors" in response:
+                errors = GraphQLClient.get_validation_errors(response)
+                return ErrorResult(self.gateway, {"errors": errors, "message": "Validation errors were found"})
+
+            data = response.get("data", {})
+            result = data.get("createBankAccountInstantVerificationJwt", {})
+            
+            jwt = result.get("jwt")
+
+            if jwt is None:
+                raise UnexpectedError("Couldn't parse response: missing jwt")
+
+            jwt_object = BankAccountInstantVerificationJwt(jwt)
+            return SuccessfulResult({"bank_account_instant_verification_jwt": jwt_object})
+
+        except (KeyError, TypeError) as e:
+            raise UnexpectedError("Couldn't parse response: " + str(e))

braintree/bank_account_instant_verification_jwt.py

@@ -0,0 +1,13 @@
+from braintree.attribute_getter import AttributeGetter
+
+class BankAccountInstantVerificationJwt(AttributeGetter):
+    def __init__(self, jwt):
+        self.jwt = jwt
+
+    @property
+    def jwt(self):
+        return self._jwt
+
+    @jwt.setter
+    def jwt(self, value):
+        self._jwt = value

braintree/bank_account_instant_verification_jwt_request.py

@@ -0,0 +1,40 @@
+class BankAccountInstantVerificationJwtRequest(object):
+    def __init__(self):
+        self._business_name = None
+        self._return_url = None
+        self._cancel_url = None
+
+    def business_name(self, business_name):
+        self._business_name = business_name
+        return self
+
+    def return_url(self, return_url):
+        self._return_url = return_url
+        return self
+
+    def cancel_url(self, cancel_url):
+        self._cancel_url = cancel_url
+        return self
+
+        
+    def get_business_name(self):
+        return self._business_name
+        
+    def get_return_url(self):
+        return self._return_url
+        
+    def get_cancel_url(self):
+        return self._cancel_url
+        
+
+    def to_graphql_variables(self):
+        input_data = {}
+    
+        if self._business_name is not None:
+            input_data["businessName"] = self._business_name
+        if self._return_url is not None:
+            input_data["returnUrl"] = self._return_url
+        if self._cancel_url is not None:
+            input_data["cancelUrl"] = self._cancel_url
+
+        return input_data

braintree/braintree_gateway.py

@@ -1,6 +1,7 @@
 from braintree.add_on_gateway import AddOnGateway
 from braintree.address_gateway import AddressGateway
 from braintree.apple_pay_gateway import ApplePayGateway
+from braintree.bank_account_instant_verification_gateway import BankAccountInstantVerificationGateway
 from braintree.client_token_gateway import ClientTokenGateway
 from braintree.configuration import Configuration
 from braintree.credit_card_gateway import CreditCardGateway
@@ -47,6 +48,7 @@ def __init__(self, config=None, **kwargs):
         self.add_on = AddOnGateway(self)
         self.address = AddressGateway(self)
         self.apple_pay = ApplePayGateway(self)
+        self.bank_account_instant_verification = BankAccountInstantVerificationGateway(self)
         self.client_token = ClientTokenGateway(self)
         self.credit_card = CreditCardGateway(self)
         self.customer = CustomerGateway(self)

braintree/error_codes.py

@@ -585,6 +585,8 @@ class Transaction(object):
         TransactionIsNotEligibleForAdjustment = "915219"
         TransactionMustBeInStateAuthorized = "915218"
         TransactionSourceIsInvalid = "915133"
+        TransferTypeIsInvalid = "97501"
+        TransferDetailsAreRequired = "97510"
         TypeIsInvalid = "91523"
         TypeIsRequired = "91524"
         UnsupportedVoiceAuthorization = "91539"

braintree/payment_method.py

@@ -91,6 +91,12 @@ def signature(type):
             },
             {
                 "three_d_secure_pass_thru": three_d_secure_pass_thru
+            },
+            {
+                "us_bank_account": [
+                    "ach_mandate_text",
+                    "ach_mandate_accepted_at"
+                ]
             }
 
         ]

braintree/receiver.py

@@ -0,0 +1,5 @@
+from braintree.attribute_getter import AttributeGetter
+
+class Receiver(AttributeGetter):
+    def __init__(self, attributes):
+        AttributeGetter.__init__(self, attributes)