braintree 4.23.0 → 4.34.0

data/lib/braintree/error_codes.rb

@@ -116,7 +116,6 @@ module Braintree
         VerificationAmountFormatIsInvalid = "91740"
         VerificationAmountIsTooLarge = "91752"
         VerificationAmountNotSupportedByProcessor = "91741"
-        VerificationMerchantAccountCannotBeSubMerchantAccount = "91755"
         VerificationMerchantAccountIdIsInvalid = "91728"
         VerificationMerchantAccountIsForbidden = "91743"
         VerificationMerchantAccountIsSuspended = "91742"
@@ -191,6 +190,10 @@ module Braintree
       AndroidPayCardsAreNotAccepted = "83708"
     end
 
+    module PaymentFacilitator
+      PaymentFacilitatorNotApplicable = "97405"
+    end
+
     module PayPalAccount
       AuthExpired = "92911"
       CannotHaveBothAccessTokenAndConsentCode = "82903"
@@ -210,6 +213,47 @@ module Braintree
       TokenIsInUse = "92906"
     end
 
+    module PayPalPaymentResource
+      NonceExpired = "97301"
+      IdNotSupported = "97302"
+      NonceRequired = "97303"
+      InvalidEmail = "97304"
+      EmailTooLong = "97305"
+      ExpectedLineItemCollection = "97306"
+      ExpectedLineItemHash = "97307"
+      ExpectedLineItemDebit = "97308"
+      InvalidUnitAmount = "97309"
+      InvalidUnitTaxAmount = "97310"
+      IsoCodeRequired = "97311"
+      IsoCodeUnsupported = "97312"
+      ShippingFieldsMissing = "97313"
+      InvalidAmountBreakdown = "97314"
+      ExpectedShippingOptionCollection = "97315"
+      ShippingOptionsRequired = "97316"
+      ShippingOptionFieldsMissing = "97317"
+      InvalidShippingOptionType = "97318"
+      ShippingOptionIdReused = "97319"
+      TooManyShippingOptionsSelected = "97320"
+      ShippingOptionMustMatchBreakdown = "97321"
+      LineItemsShouldMatchTotal = "97322"
+      LineItemsTaxShouldMatchTotal = "97323"
+      PatchCallFailed = "97324"
+      InvalidAmount = "97325"
+      ShippingIdTooLong = "97326"
+      ShippingLabelTooLong = "97327"
+      ShippingFullNameTooLong = "97328"
+      ShippingAddressTooLong = "97329"
+      ShippingExtendedAddressTooLong = "97330"
+      ShippingLocalityTooLong = "97331"
+      ShippingRegionTooLong = "97332"
+      CountryCodeTooLong = "97333"
+      NationalNumberTooLong = "97334"
+      PostalCodeTooLong = "97335"
+      DescriptionTooLong = "97336"
+      CustomFieldTooLong = "97337"
+      OrderIdTooLong = "97338"
+    end
+
     module SepaDirectDebitAccount
       SepaDebitAccountPaymentMethodMandateTypeIsNotSupported = "87115"
       SepaDebitAccountPaymentMethodCustomerIdIsInvalid = "87116"
@@ -296,21 +340,16 @@ module Braintree
       BillingAddressConflict = "91530"
       BillingPhoneNumberIsInvalid = "915206"
       CannotBeVoided = "91504"
-      CannotCancelRelease = "91562"
       CannotCloneCredit = "91543"
-      CannotCloneMarketplaceTransaction = "915137"
       CannotCloneTransactionWithPayPalAccount = "91573"
       CannotCloneTransactionWithVaultCreditCard = "91540"
       CannotCloneUnsuccessfulTransaction = "91542"
       CannotCloneVoiceAuthorizations = "91541"
-      CannotHoldInEscrow = "91560"
-      CannotPartiallyRefundEscrowedTransaction = "91563"
       CannotRefundCredit = "91505"
       CannotRefundSettlingTransaction = "91574"
       CannotRefundUnlessSettled = "91506"
       CannotRefundWithPendingMerchantAccount = "91559"
       CannotRefundWithSuspendedMerchantAccount = "91538"
-      CannotReleaseFromEscrow = "91561"
       CannotSimulateTransactionSettlement = "91575"
       CannotSubmitForSettlement = "91507"
       CannotUpdateTransactionDetailsNotSubmittedForSettlement = "915129"
@@ -356,6 +395,7 @@ module Braintree
       PaymentMethodNonceUnknown = "91565"
       PaymentMethodTokenCardTypeIsNotAccepted = "91517"
       PaymentMethodTokenIsInvalid = "91518"
+      ProcessingMerchantCategoryCodeIsInvalid = "915265"
       ProcessorAuthorizationCodeCannotBeSet = "91519"
       ProcessorAuthorizationCodeIsInvalid = "81520"
       ProcessorDoesNotSupportAuths = "915104"
@@ -393,7 +433,6 @@ module Braintree
       ShipsFromPostalCodeInvalidCharacters = "915167"
       ShipsFromPostalCodeIsInvalid = "915166"
       ShipsFromPostalCodeIsTooLong = "915165"
-      SubMerchantAccountRequiresServiceFeeAmount = "91553"
       SubscriptionDoesNotBelongToCustomer = "91529"
       SubscriptionIdIsInvalid = "91528"
       SubscriptionStatusMustBePastDue = "91531"
@@ -421,12 +460,24 @@ module Braintree
       TransactionIsNotEligibleForAdjustment = "915219"
       TransactionMustBeInStateAuthorized = "915218"
       TransactionSourceIsInvalid = "915133"
+      TransactionTransferDetailsAreMandatory = "97510"
+      TransactionTransferDetailsAreNotApplicable = "97511"
+      TransactionTransferReceiverAccountReferenceNumberIsNotValid = "97509"
+      TransactionTransferReceiverFirstNameIsNotValid = "97507"
+      TransactionTransferReceiverLastNameIsNotValid = "97508"
+      TransactionTransferReceiverTaxIdIsNotValid = "97506"
+      TransactionTransferSenderAccountReferenceNumberIsNotValid = "97505"
+      TransactionTransferSenderFirstNameIsNotValid = "97503"
+      TransactionTransferSenderLastNameIsNotValid = "97504"
+      TransactionTransferSenderTaxIdIsNotValid = "97502"
+      TransactionTransferTypeIsInvalid = "97501"
       TypeIsInvalid = "91523"
       TypeIsRequired = "91524"
       UnsupportedVoiceAuthorization = "91539"
       UsBankAccountNonceMustBePlaidVerified = "915171"
       UsBankAccountNotVerified = "915172"
 
+
       module Options
         SubmitForSettlementIsRequiredForCloning = "91544"
         SubmitForSettlementIsRequiredForPayPalUnilateral = "91582"
@@ -598,110 +649,14 @@ module Braintree
     end
 
     module MerchantAccount
-      CannotBeUpdated = "82674"
-      Declined = "82626"
-      DeclinedFailedKYC = "82623"
-      DeclinedMasterCardMatch = "82622"
-      DeclinedOFAC = "82621"
-      DeclinedSsnInvalid = "82624"
-      DeclinedSsnMatchesDeceased = "82625"
-      IdCannotBeUpdated = "82675"
-      IdFormatIsInvalid = "82603"
-      IdIsInUse = "82604"
-      IdIsNotAllowed = "82605"
-      IdIsTooLong = "82602"
-      MasterMerchantAccountIdCannotBeUpdated = "82676"
-      MasterMerchantAccountIdIsInvalid = "82607"
-      MasterMerchantAccountIdIsRequired = "82606"
-      MasterMerchantAccountMustBeActive = "82608"
-      TosAcceptedIsRequired = "82610"
 
       module ApplicantDetails
-        AccountNumberIsInvalid = "82670"
-        AccountNumberIsRequired = "82614"
-        CompanyNameIsInvalid = "82631"
-        CompanyNameIsRequiredWithTaxId = "82633"
-        DateOfBirthIsInvalid = "82663"
-        DateOfBirthIsRequired = "82612"
         Declined = "82626"                   # Keep for backwards compatibility
         DeclinedFailedKYC = "82623"          # Keep for backwards compatibility
         DeclinedMasterCardMatch = "82622"    # Keep for backwards compatibility
         DeclinedOFAC = "82621"               # Keep for backwards compatibility
         DeclinedSsnInvalid = "82624"         # Keep for backwards compatibility
         DeclinedSsnMatchesDeceased = "82625" # Keep for backwards compatibility
-        EmailAddressIsInvalid = "82616"
-        EmailAddressIsRequired = "82665"
-        FirstNameIsInvalid = "82627"
-        FirstNameIsRequired = "82609"
-        LastNameIsInvalid = "82628"
-        LastNameIsRequired = "82611"
-        PhoneIsInvalid = "82636"
-        RoutingNumberIsInvalid = "82635"
-        RoutingNumberIsRequired = "82613"
-        SsnIsInvalid = "82615"
-        TaxIdIsInvalid = "82632"
-        TaxIdIsRequiredWithCompanyName = "82634"
-        TaxIdMustBeBlank = "82673"
-
-        module Address
-          LocalityIsRequired = "82618"
-          PostalCodeIsInvalid = "82630"
-          PostalCodeIsRequired = "82619"
-          RegionIsInvalid = "82664"
-          RegionIsRequired = "82620"
-          StreetAddressIsInvalid = "82629"
-          StreetAddressIsRequired = "82617"
-        end
-      end
-
-      module Individual
-        DateOfBirthIsInvalid = "82666"
-        DateOfBirthIsRequired = "82639"
-        EmailIsInvalid = "82643"
-        EmailIsRequired = "82667"
-        FirstNameIsInvalid = "82644"
-        FirstNameIsRequired = "82637"
-        LastNameIsInvalid = "82645"
-        LastNameIsRequired = "82638"
-        PhoneIsInvalid = "82656"
-        SsnIsInvalid = "82642"
-
-        module Address
-          LocalityIsRequired = "82658"
-          PostalCodeIsInvalid = "82662"
-          PostalCodeIsRequired = "82659"
-          RegionIsInvalid = "82668"
-          RegionIsRequired = "82660"
-          StreetAddressIsInvalid = "82661"
-          StreetAddressIsRequired = "82657"
-        end
-      end
-
-      module Business
-        DbaNameIsInvalid = "82646"
-        LegalNameIsInvalid = "82677"
-        LegalNameIsRequiredWithTaxId = "82669"
-        TaxIdIsInvalid = "82647"
-        TaxIdIsRequiredWithLegalName = "82648"
-        TaxIdMustBeBlank = "82672"
-        module Address
-          PostalCodeIsInvalid = "82686"
-          RegionIsInvalid = "82684"
-          StreetAddressIsInvalid = "82685"
-        end
-      end
-
-      module Funding
-        AccountNumberIsInvalid = "82671"
-        AccountNumberIsRequired = "82641"
-        DestinationIsInvalid = "82679"
-        DestinationIsRequired = "82678"
-        EmailIsInvalid = "82681"
-        EmailIsRequired = "82680"
-        MobilePhoneIsInvalid = "82683"
-        MobilePhoneIsRequired = "82682"
-        RoutingNumberIsInvalid = "82649"
-        RoutingNumberIsRequired = "82640"
       end
     end
 
@@ -767,7 +722,6 @@ module Braintree
         AmountFormatIsInvalid = "94202"
         AmountIsTooLarge = "94207"
         AmountNotSupportedByProcessor = "94203"
-        MerchantAccountCannotBeSubMerchantAccount = "94208"
         MerchantAccountIdIsInvalid = "94204"
         MerchantAccountIsForbidden = "94206"
         MerchantAccountIsSuspended = "94205"

data/lib/braintree/error_result.rb

@@ -12,7 +12,7 @@ module Braintree
 
     def initialize(gateway, data)
       @gateway = gateway
-      @params = data[:params]
+      @params = data[:params] if data[:params]
       @credit_card_verification = CreditCardVerification._new(data[:verification]) if data[:verification]
       @merchant_account = MerchantAccount._new(gateway, data[:merchant_account]) if data[:merchant_account]
       @message = data[:message]

data/lib/braintree/errors.rb

@@ -3,7 +3,8 @@ module Braintree
     include Enumerable
 
     def initialize(data = {})
-      @errors = ValidationErrorCollection.new(data.merge(:errors => []))
+      data = data.merge(:errors => []) unless data
+      @errors = ValidationErrorCollection.new(data)
     end
 
     def each(&block)

data/lib/braintree/gateway.rb

@@ -26,6 +26,10 @@ module Braintree
       ApplePayGateway.new(self)
     end
 
+    def bank_account_instant_verification
+      BankAccountInstantVerificationGateway.new(self)
+    end
+
     def client_token
       ClientTokenGateway.new(self)
     end
@@ -38,6 +42,10 @@ module Braintree
       CustomerGateway.new(self)
     end
 
+    def customer_session
+      CustomerSessionGateway.new(self, graphql_client)
+    end
+
     def discount
       DiscountGateway.new(self)
     end
@@ -74,6 +82,10 @@ module Braintree
       PayPalAccountGateway.new(self)
     end
 
+    def paypal_payment_resource
+      PayPalPaymentResourceGateway.new(self)
+    end
+
     def us_bank_account
       UsBankAccountGateway.new(self)
     end

data/lib/braintree/google_pay_card.rb

@@ -3,7 +3,10 @@ module Braintree
     include BaseModule
 
     attr_reader :bin
+    attr_reader :business
     attr_reader :commercial
+    attr_reader :consumer
+    attr_reader :corporate
     attr_reader :country_of_issuance
     attr_reader :created_at
     attr_reader :customer_id
@@ -18,7 +21,9 @@ module Braintree
     attr_reader :issuing_bank
     attr_reader :payroll
     attr_reader :prepaid
+    attr_reader :prepaid_reloadable
     attr_reader :product_id
+    attr_reader :purchase
     attr_reader :source_card_last_4
     attr_reader :source_card_type
     attr_reader :source_description

data/lib/braintree/graphql/enums/recommendations.rb

@@ -0,0 +1,9 @@
+# Represents available types of customer recommendations that can be retrieved using a PayPal customer session.
+
+#Experimental
+# This enum is experimental and may change in future releases.
+module Braintree
+  module Recommendations
+    PAYMENT_RECOMMENDATIONS = "PAYMENT_RECOMMENDATIONS"
+  end
+end

data/lib/braintree/graphql/enums/recommended_payment_option.rb

@@ -0,0 +1,10 @@
+# Represents available payment options related to PayPal customer session recommendations.
+
+#Experimental
+# This enum is experimental and may change in future releases.
+module Braintree
+  module RecommendedPaymentOption
+    PAYPAL = "PAYPAL"
+    VENMO = "VENMO"
+  end
+end

data/lib/braintree/graphql/inputs/create_customer_session_input.rb

@@ -0,0 +1,44 @@
+# Represents the input to request the creation of a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class CreateCustomerSessionInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :merchant_account_id
+        attr_reader :session_id
+        attr_reader :customer
+        attr_reader :domain
+        attr_reader :purchase_units
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @customer = attributes[:customer] ? CustomerSessionInput.new(attributes[:customer]) : nil
+            if attributes[:purchase_units]
+                @purchase_units = attributes[:purchase_units].map do |unit|
+            PayPalPurchaseUnitInput.new(unit)
+                end
+      end
+    end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["merchantAccountId"] = merchant_account_id if merchant_account_id
+            variables["sessionId"] = session_id if session_id
+            variables["domain"] = domain if domain
+            variables["customer"] = customer.to_graphql_variables if customer
+            variables["purchaseUnits"] = purchase_units.map(&:to_graphql_variables) if purchase_units
+            variables
+        end
+    end
+end
+
+

data/lib/braintree/graphql/inputs/customer_recommendations_input.rb

@@ -0,0 +1,40 @@
+# Represents the input to request PayPal customer session recommendations.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class CustomerRecommendationsInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :merchant_account_id
+        attr_reader :session_id
+        attr_reader :customer
+        attr_reader :purchase_units
+        attr_reader :domain
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @customer = attributes[:customer] ? CustomerSessionInput.new(attributes[:customer]) : nil
+            @purchase_units = attributes[:purchase_units] ? attributes[:purchase_units].map { |pu| PayPalPurchaseUnitInput.new(pu) } : nil
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["merchantAccountId"] = merchant_account_id if merchant_account_id
+            variables["sessionId"] = session_id if session_id
+            variables["customer"] = customer.to_graphql_variables if customer
+            variables["domain"] = domain if domain
+            variables["purchaseUnits"] = purchase_units.map(&:to_graphql_variables) if purchase_units
+            variables
+        end
+    end
+end
+
+

data/lib/braintree/graphql/inputs/customer_session_input.rb

@@ -0,0 +1,45 @@
+# Customer identifying information for a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class CustomerSessionInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :email
+        attr_reader :hashed_email
+        attr_reader :phone
+        attr_reader :hashed_phone
+        attr_reader :device_fingerprint_id
+        attr_reader :paypal_app_installed
+        attr_reader :venmo_app_installed
+        attr_reader :user_agent
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @phone = attributes[:phone] ? PhoneInput.new(attributes[:phone]) : nil
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["email"] = email if email
+            variables["hashedEmail"] = hashed_email if hashed_email
+            variables["phone"] = phone.to_graphql_variables if phone
+            variables["hashedPhone"] = hashed_phone if hashed_phone
+            variables["deviceFingerprintId"] = device_fingerprint_id if device_fingerprint_id
+            variables["paypalAppInstalled"] = paypal_app_installed if paypal_app_installed
+            variables["venmoAppInstalled"] = venmo_app_installed if venmo_app_installed
+            variables["userAgent"] = user_agent if user_agent
+            variables
+        end
+    end
+end
+
+

data/lib/braintree/graphql/inputs/monetary_amount_input.rb

@@ -0,0 +1,28 @@
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class MonetaryAmountInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :value
+        attr_reader :currency_code
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["value"] = value if value
+            variables["currencyCode"] = currency_code if currency_code
+            variables
+        end
+    end
+end

data/lib/braintree/graphql/inputs/paypal_payee_input.rb

@@ -0,0 +1,28 @@
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class PayPalPayeeInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :email_address
+        attr_reader :client_id
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["emailAddress"] = email_address if email_address
+            variables["clientId"] = client_id if client_id
+            variables
+        end
+    end
+end

data/lib/braintree/graphql/inputs/paypal_purchase_unit_input.rb

@@ -0,0 +1,31 @@
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class PayPalPurchaseUnitInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :amount
+        attr_reader :payee
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            unless attributes[:amount]
+                raise ArgumentError, "Expected hash to contain a :amount"
+            end
+            set_instance_variables_from_hash(attributes)
+            @payee = attributes[:payee] ? PayPalPayeeInput.new(attributes[:payee]) : nil
+            @amount = attributes[:amount] ? MonetaryAmountInput.new(attributes[:amount]) : nil
+        end
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+        def to_graphql_variables
+            variables = {}
+            variables["amount"] = amount.to_graphql_variables if amount
+            variables["payee"] = payee.to_graphql_variables if payee
+            variables
+        end
+    end
+end

data/lib/braintree/graphql/inputs/phone_input.rb

@@ -0,0 +1,34 @@
+# Phone number input for PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class PhoneInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :country_phone_code
+        attr_reader :phone_number
+        attr_reader :extension_number
+
+        def initialize(attributes)
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["countryPhoneCode"] = country_phone_code if country_phone_code
+            variables["phoneNumber"] = phone_number if phone_number
+            variables["extensionNumber"] = extension_number if extension_number
+            variables
+        end
+    end
+end
+
+

data/lib/braintree/graphql/inputs/update_customer_session_input.rb

@@ -0,0 +1,42 @@
+# Represents the input to request an update to a PayPal customer session.
+
+#Experimental
+# This class is experimental and may change in future releases.
+module Braintree
+    class UpdateCustomerSessionInput
+        include BaseModule
+
+        attr_reader :attrs
+        attr_reader :merchant_account_id
+        attr_reader :session_id
+        attr_reader :customer
+        attr_reader :purchase_units
+
+        def initialize(attributes)
+            unless attributes[:session_id]
+                raise ArgumentError, "Expected hash to contain a :session_id"
+            end
+            @attrs = attributes.keys
+            set_instance_variables_from_hash(attributes)
+            @customer = attributes[:customer] ? CustomerSessionInput.new(attributes[:customer]) : nil
+            @purchase_units = attributes[:purchase_units] ? attributes[:purchase_units].map { |pu| PayPalPurchaseUnitInput.new(pu) } : nil
+        end
+
+        def inspect
+            inspected_attributes = @attrs.map { |attr| "#{attr}:#{send(attr).inspect}" }
+            "#<#{self.class} #{inspected_attributes.join(" ")}>"
+        end
+
+        def to_graphql_variables
+            variables = {}
+            variables["merchantAccountId"] = merchant_account_id if merchant_account_id
+            variables["sessionId"] = session_id if session_id
+            variables["customer"] = customer.to_graphql_variables if customer
+            variables["purchaseUnits"] = purchase_units.map(&:to_graphql_variables) if purchase_units
+            variables
+        end
+
+    end
+end
+
+