Braintree Php Laravel Package

• Address PHP 8.2 deprecation warnings due to string interpolation patterns. (thanks @Ayesh)

• Add TRANSACTION_REASON_CODE to search for transaction that have any ach return response with reason code associated.
• Add reasonCode criteria to TransactionSearch
• Add achReturnResponsesCreatedAt criteria to TransactionSearch
• Add LiabilityShift class and liabilityShift to RiskData
• Add support for ExchangeRateQuoteAPI
• Fix various PHP 8.1 null warnings (thanks @simoheinonen & @robbieaverill)

• Add retried to Transaction

• Fix lint errors on unit test

• Add PaymentMethodCustomerDataUpdated webhook notification support

• Address PHP 8.1 Deprecation warnings

• Add plan create/update/find API endpoint
• Add TransactionReview webhook notification

• Add exchangeRateQuoteId to Transaction.sale
• Add error code EXCHANGE_RATE_QUOTE_ID_IS_TOO_LONG
• Added the following fields to GooglePayCard and ApplePayCard:
  • commercial
  • debit
  • durbinRegulated
  • healthcare
  • payroll
  • prepaid
  • productId
  • countryOfIssuance
  • issuingBank
• Add LocalPaymentExpired and LocalPaymentFunded webhook notification support

• Add mastercardTransactionLinkId to Transaction and Verification
• Fix webhook signature verification vulnerability when using OAuth Connect

• Add support for apple pay card verifications

• Fixes syntax error in Version.php file

• Add Local Payment Context support with LocalPaymentGateway->create() and LocalPaymentGateway->find() methods
• Add support for MBWAY and CRYPTO payment types
• Add acquirerReferenceNumber to transaction search object
• Remove merchant create functionality
• Remove accountFundingTransaction from Transaction request
• Add apiRequestKey (idempotency) support for Transaction::sale(), Transaction::credit(), Transaction::submitForSettlement(), Transaction::submitForPartialSettlement(), Transaction::void(), and Transaction::refund()
• Add surchargeAmount to transaction object

• Add JsonSerializable interface to Instance class for proper JSON encoding support
• Fix PHP 8.5 curl_close() deprecation warning by using version-conditional cleanup
• Add acceptPartialAuthorization to TransactionGateway and partiallyAuthorized to Transaction
• Deprecate transactions for visa_checkout_card and maintain search functionality
• Add achType to options -> usBankAccount in Transaction::sale()
• Add achType and requestedAchType to Transaction

• Filter CreditCardVerification::search() to only return credit card verifications
• Add middleName to sender and receiver, and dateOfBirth to sender in transfer on Transaction
• Remove unused error code AdjustmentAmountMustBeGreaterThanZero

• Add processingMerchantCategoryCode to TransactionGateway
• Add missing transfer validation error codes in Transaction

• Add paymentReaderCardDetails parameter to Transaction.sale
• Add error code TRANSACTION_TAX_AMOUNT_IS_REQUIRED_FOR_AIB_SWEDISH for attribute taxAmount in transaction key for AIB:Domestic transactions in Sweden.

• Add Bank Account Instant Verification functionality
• Add BankAccountInstantVerificationGateway for creating JWT tokens
• Add BankAccountInstantVerificationJwt and BankAccountInstantVerificationJwtRequest classes
• Add bankAccountInstantVerification() method to main Gateway class
• Add ACH mandate support for US Bank Account transactions
• Add achMandateText and achMandateAcceptedAt fields to Transaction and PaymentMethod create signatures
• Add usBankAccount parameter support for ACH mandate details
• Add INSTANT_VERIFICATION_ACCOUNT_VALIDATION as a new US Bank Account verification method
• Add sender and receiver to transfer in Transaction
• Add achRejectReason field to Transaction
• Add isDeviceToken and merchantTokenIdentifier to ApplePayCard and ApplePayDetails
• Add paymentAccountReference to ApplePayCardDetails, GooglePayCardDetails, CreditCardDetails and CreditCardVerification

• Add upcomingRetryDate to Transaction
• Add remainingFileEvidenceStorage to Dispute
• Add transaction_retried webhook
• Add transfer type to Transaction

• Add Session Id to Customer Recommendations Payload

• Add accountInformationInquiry to:
  • CreditCard.create and CreditCard.update
  • PaymentMethod.create and PaymentMethod.update
  • CreditCardVerification.create
• Enhancements to PayPal customer recommendations
  • Create a session and get recommendations in one call
  • Hash customer email and phone number
• Add business, consumer, corporate, and purchase from the bin data to credit card responses

• Remove marketplace features
• Add support for capturing payment facilitator and sub-merchant details with transactions

• Add support for PayPalPaymentResource requests
• Add prepaid_reloadable from bin data in credit card responses

• Add support for creating and updating PayPal customer session
• Add support for getting PayPal customer recommendations

• Add recipient/contact info: recipient_emailand recipient_phone to Transaction

• Add fail_on_duplicate_payment_method_for_customer option to
  • ClientToken
  • PaymentMethod
  • CreditCard
• Add blik_aliases to LocalPaymentCompleted webhook
• Deprecate SamsungPayCard
• Updated expiring pinned vendor SSL certificates

• Add payer_name, bic and iban_last_chars to LocalPaymentCompleted webhook
• Fixes "Array to String conversion" error when an international phone number is included in customer details
• Add editPaypalVaultId to PayPalAccount
• Add aniFirstNameResponseCode and aniLastNameResponseCode to CreditCardVerification
• Add shippingTaxAmount to Transaction
• Add networkTokenizationAttributes parameter to Transaction.sale
• Add CREDIT_CARD_NETWORK_TOKENIZATION_ATTRIBUTE_CRYPTOGRAM_IS_REQUIRED to validation error codes.

• Add chargebackProtectionLevel to Dispute and DisputeSearch
• Add skipAdvancedFraudChecking to:
  • CreditCard.create and CreditCard.update
  • PaymentMethod.create and PaymentMethod.update

• Add foreignRetailer to Transaction
• Add internationalPhone to Address and Customer
• Add fundingSourceDescription to PayPalAccount
• Add missing GooglePayCard error code
• Add REFUND_FAILED to WebhookNotification
• Add final_capture to Transaction submitForPartialSettlement
• Deprecate paypalTrackingId in favor of paypalTrackerId

• Deprecate CreditCard::credit in favor of Transaction::credit
• Deprecate CreditCard::sale in favor of Transaction::sale
• Add domains parameter support to ClientToken::generate
• Refactor key validation in ClientTokenGateway

• Add UNDER_REVIEW Dispute Status
• Add DISPUTE_UNDER_REVIEW WebhookNotification
• Add debitNetwork support Transaction and TransactionSearch
• Add process_debit_as_credit to TransactionOptionsCreditCardRequest

• Deprecate threeDSecureToken in favor of threeDSecureAuthenticationId
• Deprecate venmoSdkSession, venmoSdkPaymentMethodCode, and isVenmoSdk()
• Add PICKUP_IN_STORE to ShippingMethod enum
• Add to CreditCardVerification create request
  • externalVault
  • paymentMethodNonce
  • riskData
  • threeDSecureAuthenticationId
  • threeDSecurePassThru
• Add phoneNumber to Address, CreditCardGateway, PaymentMethodGateway and CustomerGateway
• Add packages to Transaction
• Add packageTracking method to TransactionGateway to make request to add tracking information to transactions
• Add check for empty liabilityShift in RiskData
• Add imageUrl, upcCode, and upcType to lineItems in TransactionGateway

• Add billingAddress and shippingAddress to VenmoProfileData for PaymentMethodCustomerDataUpdated webhook
• Add MetaCheckoutCard and MetaCheckoutToken payment methods
• Add MetaCheckoutCardDetails and MetaCheckoutTokenDetails to Transaction object
• Add verificationAddOns and additionalProcessorResponse to PaymentMethodCreate for ACH Network Check
• Add dateOfBirth and countryCode to industry_data

• Add arrivalDate and ticketIssuerAddress to Transaction object
• Add SUBSCRIPTION_BILLING_SKIPPED WebhookNotification

• Add retry_ids and retry_transaction_id to Transaction object
• Add processing_overrides to Transaction.sale options

• Add subscriptions for SEPA direct debit account
• Add merchant_advice_code and merchant_advice_code_text to Transaction

• TestingGateway methods return type is Result\Error for validation errors.

• Resolved various dynamic property warnings for PHP 8.2 (thanks to @mvoelker & @markdavidsonEE)

• Add preDisputeProgram to Dispute and DisputeSearch
• Add AUTO_ACCEPTED Dispute Status
• Add DISPUTE_AUTO_ACCEPTED WebhookNotification
• Add EXCESSIVE_RETRY to GatewayRejectionReason

• Add SEPADirectDebitAccount payment method
• Add SEPADirectDebitAccountDetails to transaction object
• Add SEPA_DIRECT_DEBIT_ACCOUNT to payment instrument type
• Add SEPA Direct Debit specific error codes
• Add SEPA Direct Debit array to customer object
• Deprecate chargebackProtectionLevel and add protectionLevel to Dispute and DisputeSearch

• Add paypalMessages to Dispute
• Fix bug where __isset methods in Instance and Base classes treated null value as set (Thanks @sklodzio)
• Add tax_identifiers parameter to Customer.create and Customer.update
• Add webhook sample for GrantedPaymentMethodRevoked
• Add sample webhook notifications for SUBSCRIPTION_EXPIRED, SUBSCRIPTION_CANCELED and SUBSCRIPTION_WENT_PAST_DUE (thanks @antonvolokha)

• Add LocalPaymentReversed webhook
• Add adjustAuthorization method to Transaction, for supporting multiple authorizations on a single transaction
• Add storeId and storeIds to Transaction search
• Add merchantAccountId parameter to Transaction refund
• Parameters that supported DateTime objects can also support DateTimeImmutable objects (closes #278)
• Add toArray function to Base and Instance classes (resolves #289)
• Add jsonSerialize to Instance class
• Breaking Changes:
  • Require PHP 7.3 or higher
  • Rename AndroidPayCard to GooglePayCard
  • Rename AndroidPayCardDetails to GooglePayCardDetails
  • Remove Configuration#isAuthenticatedInstanceProxy method in favor of Configuration#isAuthenticatedProxy
  • Remove Configuration#isUsingInstanceProxy method in favor of Configuration#isUsingProxy
  • Remove TRANSACTION_EXTERNAL_VAULT_CARD_TYPE_IS_INVALID and RISK_DATA_CUSTOMER_BROWSER_IS_TOO_LONG error codes
  • Remove customer_ip and customer_browser snake case parameters in favor of camel case customerIp and customerBrowser accepted in Customer#create and Transaction#sale
  • Remove AmexExpressCheckoutCard and AmexExpressCheckoutCardDetails
  • Remove MasterpassCard and MasterpassCardDetails
  • Remove deprecated parameters:
    • deviceSessionId from CreditCardGateway#update, CreditCardGateway#create, CustomerGateway#create, CustomerGateway#update, PaymentMethodGateay#update, and TransactionGateway#create
    • fraudMerchantId from CreditCardGateway#update, CreditCardGateway#create, CustomerGateway#create, CustomerGateway#update, PaymentMethodGateay#update, and TransactionGateway#create

• Add scaExemption to Transaction sale
• Deprecate deviceSessionId and fraudMerchantId in CreditCardGateway, CustomerGateway, PaymentMethodGateway, and TransactionGateway classes
• Add installments to Transaction sale
• Add count to installments

• Add AcquirerReferenceNumber to Transaction
• Add billingAgreementId to PayPalDetails
• Deprecate recurring in Transaction sale
• Deprecate tag in Dispute add text evidence

• Deprecate masterpassCard and amexExpressCheckoutCard payment methods
• Deprecate amexExpressCheckoutCardDetails

• Add RISK_THRESHOLD to GatewayRejectionReason constants
• Add networkTransactionId to CreditCardVerification
• Add processedWithNetworkToken to Transaction
• Add isNetworkTokenized to CreditCard
• Add productSku to Transaction
• Add phoneNumber and shippingMethod to Address
• Add customerDeviceId, customerLocationZip, and customerTenure to RiskData
• Add error codes
  • TRANSACTION_PRODUCT_SKU_IS_INVALID
  • TRANSACTION_SHIPPING_METHOD_IS_INVALID
  • TRANSACTION_SHIPPING_PHONE_NUMBER_IS_INVALID
  • TRANSACTION_BILLING_PHONE_NUMBER_IS_INVALID
  • RISK_DATA_CUSTOMER_BROWSER_IS_TOO_LONG
  • RISK_DATA_CUSTOMER_DEVICE_ID_IS_TOO_LONG
  • RISK_DATA_CUSTOMER_LOCATION_ZIP_INVALID_CHARACTERS
  • RISK_DATA_CUSTOMER_LOCATION_ZIP_IS_INVALID
  • RISK_DATA_CUSTOMER_LOCATION_ZIP_IS_TOO_LONG
  • RISK_DATA_CUSTOMER_TENURE_IS_TOO_LONG
  • RISK_DATA_CUSTOMER_TENURE_IS_INVALID

• Add retrieval_reference_number to Transaction
• Fix class alias issue where Exceptions could not be thrown for missing libraries or older PHP versions.
• Fix issue where proxyHost, proxyPort, proxyType, proxyUser, proxyPassword, and sslVersion were not being set on Gateway or Configuration objects.

• Add threeDSecurePassThru parameters to Customer.create, PaymentMethod.create, CreditCard.create, Customer.update, PaymentMethod.update and CreditCard.update
• Add recurringCustomerConsent and recurringMaxAmount to authenticationInsightOptions for PaymentMethodNonce.create
• Add DOCUMENT_UPLOAD_FILE_IS_EMPTY error code
• phpDocs fixes (thanks @pupitooo)

• Add DISPUTE_ACCEPTED, DISPUTE_DISPUTED, and DISPUTE_EXPIRED webhook constants
• Breaking Changes:
  • Upgrade API version to retrieve declined refund transactions
  • Throw RequestTimeout instead of Timeout for transaction search
  • Drop PSR-0 Support and remove class aliases
  • Remove EuropeBankAccount and IbanBankAccount modules
  • Remove deprecated SEPA error codes
  • Remove paypalVaultWithoutUpgrade
  • Invalid transaction IDs are validated by the gateway and not the SDK

• Add Authentication Insight to payment method nonce create
• Add threeDSecureAuthenticationId support to transaction sale
• Add ThreeDSecure test payment method nonces
• Add test AuthenticationIds

• Add RefundAuthHardDeclined and RefundAuthSoftDeclined to validation errors
• Add level 2 processing options purchaseOrderNumber, taxAmount, and taxExempt to Transaction submit for settlement
• Add level 3 processing options discountAmount, shippingAmount, shipsFromPostalCode, and lineItems to Transaction submit for settlement

• Add isNetworkTokenized to AndroidPayCard and AndroidPayCardDetails
• Add GraphQL ID to CreditCardVerification, Customer, Dispute, and Transaction
• Add support for PHP 7.4 (#262 thanks @slt)
• Add threeDSecurePassThru params to PaymentMethod update

• Add PROCESSOR_DOES_NOT_SUPPORT_MOTO_FOR_CARD_TYPE to validation errors
• Make errors JSON serializable (#256 thanks @sebdesign)

• Add AMOUNT_NOT_SUPPORTED_BY_PROCESSOR to validation errors
• Forward forwardedComments to processorComments

• Add PayPalHereDetails to transactions
• Add network_response_code and network_response_text to Transaction and CreditCardVerification
• Add xid, cavv, eciFlag, dsTransactionId, and threeDSecureVersion to ThreeDSecureInfo
• Add threeDSecureInfo to CreditCardVerification
• Add GraphQLClient to BraintreeGateway class

• Add captureId to LocalPaymentDetails
• Add debugId to LocalPaymentDetails
• Add refundId to LocalPaymentDetails
• Add transactionFeeAmount to LocalPaymentDetails
• Add transactionFeeCurrencyIsoCode to LocalPaymentDetails
• Add refundFromTransactionFeeAmount to LocalPaymentDetails
• Add refundFromTransactionFeeCurrencyIsoCode to LocalPaymentDetails
• Add threeDSecureVersion, authenticationResponse, directoryResponse, cavvAlgorithm and dsTransactionId to 3DS pass thru fields
• Add payerInfo to PaymentMethodNonce details
• Add roomTax field to Transaction sale
• Add noShow field to Transaction sale
• Add advancedDeposit field to Transaction sale
• Add fireSafe field to Transaction sale
• Add propertyPhone field to Transaction sale
• Add additionalCharges field to Transaction sale
• Add PostalCodeIsRequiredForCardBrandAndProcessor to validation errors

• Add revokedAt field to PayPalAccount
• Add support for PAYMENT_METHOD_REVOKED_BY_CUSTOMER webhook
• Add payment_method_nonce field to LocalPaymentCompleted webhook
• Add transaction field to LocalPaymentCompleted webhook
• Add localPaymentDetail to transactions
• Add TOKEN_ISSUANCE gatewayRejectionReason enum to Transaction

• Add support for PHP 7 (Thanks to @briandotdev)
• Require PHP 7.2 or higher
• Remove support for HHVM and PHP 5
• Update to PHPUnit 7
• Remove deprecated GRANTED_PAYMENT_INSTRUMENT_UPDATE
• Remove deprecated Coinbase payment method
• Remove deprecated iDEAL payment method
• Remove deprecated MerchantAccountGateway creation with applicantDetails. Please use individual, business, and funding.
• When a Customer is created, the customFields property is always an array rather than potentially null.
• Remove Transparent Redirect
• Remove riskData, applePay, applePayCard, threeDSecure, and venmo.profileId snakecase attributes
• HTTPS requests throw an SSLCertificate exception when related to SSL, otherwise a Connection exception is thrown.
• Rename DownForMaintence Exception to ServiceUnavailable. Throw Timeout exception for transaction search errors instead of DownForMaintenance.
• Add RequestTimeout and GatewayTimeout exceptions.
• Add revokedAt field to PayPalAccount
• Add support for PAYMENT_METHOD_REVOKED_BY_CUSTOMER webhook

• Add AccountUpdaterDailyReport webhook parsing

• Add payment method revoke
• Add support for options in submit_for_settlement transaction flows
• Add verification create API
• Update https certificate bundle

• Add VenmoAccount
• Allow order_id and descriptor to be passed in for Transaction submit_for_settlement
• Add facilitator details onto transactions
• Add check webhook constant

• Fix PSR-0 style namespacing when using Symfony

• Add support for proxy servers
• Add PSR-4 namespacing support
• Add support for AMEX Express Checkout
• Add support for new fields in dispute webhooks (dateWon, dateOpened, kind)
• Add transaction data to sucessful subscription webhook

• Add support for raw ApplePay params on Transaction create

• Deprecate GRANTED_PAYMENT_INSTRUMENT_UPDATE and add GRANTOR_UPDATED_GRANTED_PAYMENT_METHOD and RECIPIENT_UPDATED_GRANTED_PAYMENT_METHOD
• Add accountType field to TransactionGateway, CreditCardGateway, PaymentMethodGateway, and CreditCardVerification.
• Add Hiper and Hipercard test numbers.
• Add refundFromTransactionFeeAmount field to PayPalDetails
• Add refundFromTransactionFeeCurrencyIsoCode field to PayPalDetails

• Add sourceDescription method to Android Pay and Apple Pay payment methods
• Add new Android Pay test nonces
• Add billing agreement ID to PayPal Account
• Support amex rewards transactions

• Add bin field to paymentMethodNonceDetails
• Add Error indicating pdf uploads too long for dispute evidence.
• Add GrantedPaymentMethodRevoked webhook response objects

• Add fraudServiceProvider field in riskData
• Fix issue where merchant reporting calls would throw an exception in PHP 7 (#236)

• Add processorResponseType to Transaction, AuthorizationAdjustment, and CreditCardVerification.
• Add authorizationExpiresAt to Transaction
• Add support for additional PayPal options when vaulting a PayPal Order during customer update
• Allow PayPal payment ID and payer ID to be passed during transaction create
• Add travel_flight support to industry-specific data

• Fix dispute results in transactions not showing the correct status sometimes
• Add externalVault option to transaction sale
• Add LocalPaymentCompleted webhook

• Add subscription charged unsuccessfully sample webhook to webhook testing gateway
• Add processor_response_code and processor_response_text to authorization adjustments subfield in transaction response.
• Fix issue where result objects could not be printed with echo (thanks @cmeon)
• Add Samsung Pay support

• Allow payee ID to be passed in options params for transaction create
• Add merchant_id to ConnectedMerchantStatusTransitioned and ConnectedMerchantPayPalStatusChanged Auth webhooks
• Fix webhook testing sample xml for dispute webhooks to include amount-won and amount-disputed (closes #225)

• Fix WebhookTestingGateway to use local configuration
• Add Disbursement type field and methods

• Add support for US Bank Account verifications API

• Fix issue where webhook verification would fail due to missing global public key configuration value
• Fix issue where webhook testing did not work on instantiated gateway
• Add support for VCR compelling evidence dispute representment

• Add oauthAccessRevocation to WebhookNotifications
• Add support for profileId in Transaction#create options for VenmoAccounts
• Add support for dispute search by customerId, disbursementDate, and effectiveDate
• Make CustomerGateway::find backward compatible
• Remove sepaMandateType and sepaMandateAcceptanceLocation params from ClientTokenGateway

• Add new test payment method nonces
• Allow passing description on PayPal transactions
• Add methods to change transaction settlement status in sandbox
• Fix issue where customer with an id of 0 could not be found
• Add Europe Bank Account functionality

• Add support for association_filter_id in Customer#find
• Add support for setting timeout and acceptGzipEncoding values on construction of Configuration instances

• Add support for Level 3 summary parameters: shippingAmount, discountAmount, and shipsFromPostalCode
• Add support for tax_amount field on transaction line_items
• Add sourceMerchantId property to WebhookNotifications if present
• Deprecate TRANSACTION_LINE_ITEM_DISCOUNT_AMOUNT_MUST_BE_GREATER_THAN_ZERO error in favor of TRANSACTION_LINE_ITEM_DISCOUNT_AMOUNT_CANNOT_BE_NEGATIVE.
• Deprecate TRANSACTION_LINE_ITEM_UNIT_TAX_AMOUNT_MUST_BE_GREATER_THAN_ZERO error in favor of TRANSACTION_LINE_ITEM_UNIT_TAX_AMOUNT_CANNOT_BE_NEGATIVE.
• Deprecate Braintree\Transaction\LineItem in favor of Braintree\TransactionLineItem.
• Add findAll static method to TransactionLineItem class
• Add support for profile_id in Transaction#create options for VenmoAccounts

• Add support for Level 3 summary parameters: shippingAmount, discountAmount, and shipsFromPostalCode
• Add support for transaction line items
• Add support for tagged evidence in DisputeGateway::addTextEvidence (Beta release)
• Update https certificate bundle

• Deprecate OAuthGateway::computeSignature
• Fix spec to expect PayPal transactions to move to settling rather than settled
• Fix AchMandate acceptedAt attribute parsing

• Add support for upgrading a PayPal future payment refresh token to a billing agreement
• Address deprecation warnings for create_function with PHP 7 (#193, thanks @chrisdeeming)
• Add cardHolderName to CreditCardDetails (#201, thanks @Samistine)
• Add GrantedPaymentInstrumentUpdate webhook support
• Allow paypal => options params to be passed in camel case
• Add ability to create a transaction from a shared nonce
• Implement JsonSerializable on Braintree Objects for easier logging (#200, thanks @hfmikep)
• Fix spec to expect PayPal transaction to settle immediately after successful capture
• Add options -> paypal -> shipping for creating & updating customers as well as creating payment methods
• Add options -> paypal -> description for creating and updating subscriptions
• Add binData to PaymentMethodNonce
• Add bin to ApplePayCard
• Add deviceDataCaptured field in riskData

• Add submitForSettlement option to Subscription::retryCharge
• Support eci_indicator for Transaction sale with raw Apple Pay parameters
• Add accept method for the Dispute API
• Add addTextEvidence method for the Dispute API
• Add addFileEvidence method for the Dispute API
• Add finalize method for the Dispute API
• Add find method for the Dispute API
• Add removeEvidence method for the Dispute API
• Add search method for the Dispute API
• Add DocumentUpload

• Add AuthorizationAdjustment class and authorizationAdjustments to Transaction
• Add iDEAL webhook support
• Add IDEAL_PAYMENT to PaymentInstrumentType
• Create Braintree class to be PSR compliant
• Coinbase is no longer a supported payment method. PAYMENT_METHOD_NO_LONGER_SUPPORTED will be returned for Coinbase operations.
• Add ApplePay for web domain registration.
• Add facilitated details to Transaction if present
• Update link to transaction api documentation (thanks @qoheleth-tech!).
• Fix TransactionGateway return types (thanks @jjok!).
• Update return type for client token (thanks @jlaswell!).

• Fix token generator return type - thanks @jjok!
• Improve error reporting for connection issues - thanks @montymxb!
• Add support for additional PayPal options when vaulting a PayPal Order

• Add Visa Checkout support
• Add ConnectedMerchantStatusTransitioned and ConnectedMerchantPayPalStatusChanged Auth webhooks
• Add new properties to CreditCardVerification and Customer
• Add SDK support for skip AVS and skip CVV

• Add option to disable Accept-Encoding: gzip header for Google App Engine
• Fix a bug where merchantAccount->all would attempt to fetch too many pages of merchant accounts

• Add back in options->three_d_secure to transaction params that was accidentally removed in v3.14.0

• Allow optional configuration of SSL version
• Replace var_dump with print_r. Thanks, @mnlg
• Add functionality to list all merchant accounts for a merchant with merchantAccount->all
• Stop sending account_description field from us bank accounts

• Add option skip_advanced_fraud_check for transaction flows

• Add additional search criteria

• Add multi-currency updates to merchants onboarded through Braintree Auth
• Raise an exception if fetching pages of results times out during a transaction search

• Fix UsBankAccount support for Customers
• Update Grant api to support options hash

• Add 'UsBankAccount' payment method

• Add authenticated proxy functionality
• Add constant for Venmo Account payment instrument type
• Add validation error for verifications with submerchants

• Add 'default_payment_method' option for Customer

Note: This version introduced an unintentional breaking change where the options->three_d_secure transaction parameter was changed to options->threeDSecure. Starting in v3.21.1, both case conventions are supported for backwards compatibility.

• Add OrderId to refund
• Add 3DS Pass thru support
• Expose IDs in resource collections
• Add leading slash to the namespace. Thanks, @bocharsky-bw
• Stop modifying DateTime parameters during XML generation. Thanks, @jodarove

• Add method of revoking OAuth access tokens.

• Add Transaction update_details
• Support for Too Many Requests response codes
• Add ability to count errors in ErrorCollection object. Thanks, @bocharsky-bw
• Improve Type Hinting

• Remove final from classes. Thanks, @ibrahimlawal!
• Add currency to Transaction search

• Add timeout attribute
• Add start-date and end-date to SUBSCRIPTION_CHARGED_SUCCESSFULLY test webhook response

• Add support for HHVM
• Validate that configuration is valid before verifying webhooks
• Make OAuth methods conform more to existing API
• Expose customer paymentMethods as an attribute

• Add support for Android Pay

• Deprecate PHP 5.2 and 5.3
• Validate webhook challenge payload
• Bugfix for calling __toString() on objects that contain a \DateTime

• Added a new transaction state, AUTHORIZATION_EXPIRED.
• Enabled searching by authorizationExpiredAt.

• Added next_billing_date and transaction_id to subscription search
• Added address_country_name to customer search
• Added new error codes

• Added Customer search
• Added dynamic descriptors to Subscriptions and Transactions
• Added level 2 fields to Transactions:
  • tax_amount
  • tax_exempt
  • purchase_order_number

• Added billingAddressId to allowed parameters for credit cards create and update
• Allow searching on subscriptions that are currently in a trial period using inTrialPeriod

• Added ability to perform multiple partial refunds on Braintree_Transactions
• Allow passing expirationMonth and expirationYear separately when creating Braintree_Transactions
• Added revertSubscriptionOnProrationFailure flag to Braintree_Subscription update that specifies how a Subscription should react to a failed proration charge
• Deprecated Braintree_Subscription nextBillAmount in favor of nextBillingPeriodAmount
• Deprecated Braintree_Transaction refundId in favor of refundIds
• Added new fields to Braintree_Subscription:
  • balance
  • paidThroughDate
  • nextBillingPeriodAmount

• Added Braintree_AddOns/Braintree_Discounts
• Enhanced Braintree_Subscription search
• Enhanced Braintree_Transaction search
• Added constants for Braintree_Result_CreditCardVerification statuses
• Added EXPIRED and PENDING statuses to Braintree_Subscription
• Allowed prorateCharges to be specified on Braintree_Subscription update
• Added Braintree_AddOn/Braintree_Discount details to Braintree_Transactions that were created from a Braintree_Subscription
• Removed 13 digit Visa Sandbox Credit Card number and replaced it with a 16 digit Visa
• Added new fields to Braintree_Subscription:
  • billingDayOfMonth
  • daysPastDue
  • firstBillingDate
  • neverExpires
  • numberOfBillingCycles

• Add missing criteria to credit card verification search
• Bugfix for autoloading files with Composer

• Added ability to specify country using countryName, countryCodeAlpha2, countryCodeAlpha3, or countryCodeNumeric (see ISO_3166-1)
• Added gatewayRejectionReason to Braintree_Transaction and Braintree_Verification
• Added unified message to result objects

• Add oauth functionality
• Add 3DS info to the server side

• Update payment instrument types and test nonces
• Add missing valid params to PaymentMethodGateway

• Add 3D Secure transaction fields
• Add ability to create nonce from vaulted payment methods

• Surface Apple Pay payment instrument name in responses
• Support Coinbase payment instruments

• Fix E_STRICT errors
• Expose subscription status details

• Bugfix for auto loading files

• Allow PayPal fields in transaction.options.paypal
• Add error code constants
• Internal refactoring

• Add risk_data to Transaction and Verification with Kount decision and id
• Add verification_amount an option when creating a credit card
• Add TravelCruise industry type to Transaction
• Add room_rate to Lodging industry type
• Add CreditCard#verification as the latest verification on that credit card
• Add ApplePay support to all endpoints that may return ApplePayCard objects
• Add prefix to sample Webhook to simulate webhook query params

• Allow descriptor to be passed in Funding Details options params for Merchant Account create and update.

• Add additionalProcessorResponse to Transaction

• Allow payee_email to be passed in options params for Transaction create

• Added paypal specific fields to transaction calls
• Added SettlementPending, SettlementDeclined transaction statuses

• Add descriptor url support

• Added unified Braintree_TransparentRedirect url and confirm methods and deprecated old methods
• Added functions to Braintree_CreditCard to allow searching on expiring and expired credit cards
• Allow card verification against a specified merchant account
• Added ability to update a customer, credit card, and billing address in one request
• Allow updating the paymentMethodToken on a subscription

• Allow credit card verification options to be passed outside of the nonce for PaymentMethod.create
• Allow billing_address parameters and billing_address_id to be passed outside of the nonce for PaymentMethod.create
• Add Subscriptions to paypal accounts
• Add PaymentMethod.update
• Add fail_on_duplicate_payment_method option to PaymentMethod.create

• Adds support for v.zero SDKs.

• Make webhook parsing more robust with newlines
• Add messages to InvalidSignature exceptions

• Updated secureCompare to correctly compare strings in consistent time
• Add better error messages around webhook verification

• Include Dispute information on Transaction
• Search for Transactions disputed on a certain date

• Disbursement Webhooks

• Fix factories on AddOn and Discount (thanks stewe)
• Allow billingAddressId on transaction create

• Merchant account find API

• Merchant account update API
• Merchant account create API v2

• Update configuration URLs

• Official Partnership support

• Add Partner Merchant Declined webhook
• use preg_callback_replace instead of preg_replace (thanks jonthornton!)

• Adds missing test contstant to library namespace

• Adds holdInEscrow method
• Add error codes for verification not supported error
• Add companyName and taxId to merchant account create
• Adds cancelRelease method
• Adds releaseFromEscrow functionality
• Adds phone to merchant account signature.
• Adds merchant account phone error code.
• Fix casing issues with Braintree_Http and Braintree_Util references (thanks steven-hadfield!)
• Fixed transaction initialization arguments to be optional (thanks karolsojko!)

• Enable device data.

• Fixed getting custom fields with valueForHtmlField. Thanks to Miguel Manso for the fix.
• Adds disbursement details to transactions.
• Adds image url to transactions.

• Prevent race condition when pulling back collection results -- search results represent the state of the data at the time the query was run
• Rename ResourceCollection's approximate_size to maximum_size because items that no longer match the query will not be returned in the result set
• Correctly handle HTTP error 426 (Upgrade Required) -- the error code is returned when your client library version is no long compatible with the gateway
• Add the ability to specify merchant_account_id when verifying credit cards
• Add subscription_id to transactions created from subscriptions

• Adds channel field to transactions.

• Adds country of issuance and issuing bank bin database fields

• Adds verification search

• Additional card information, such as prepaid, debit, commercial, Durbin regulated, healthcare, and payroll, are returned on credit card responses
• Allows transactions to be specified as recurring

• Adds prepaid field to credit cards (possible values include Yes, No, Unknown)

• Adds composer support (thanks till)
• Fixes erroneous version number
• Braintree_Plan::all() returns empty array if no plans exist

• Adds webhook gateways for parsing, verifying, and testing notifications

• Adds search for duplicate credit cards given a payment method token
• Adds flag to fail saving credit card to vault if card is duplicate

• Exposes plan_id on transactions

• Added error code for invalid purchase order number

• Fixed problematic case in ResourceCollection when no results are returned from a search.

• Fixed customer search, which returned customers when no customers matched search criteria

• Added new error message for merchant accounts that do not support refunds

• Added ability to retrieve all Plans, AddOns, and Discounts
• Added Transaction cloning

• Added Braintree_SettlementBatchSummary

• Wrap dependency requirement in a function, to prevent pollution of the global namespace

• Added subscriptionDetails to Transaction
• Added flag to store in vault only when a transaction is successful
• Added new error code

• Added transaction advanced search
• Added ability to partially refund transactions
• Added ability to manually retry past-due subscriptions
• Added new transaction error codes
• Allow merchant account to be specified when creating transactions
• Allow creating a transaction with a vault customer and new payment method
• Allow existing billing address to be updated when updating credit card
• Correctly handle xml with nil=true

• Updated success? on transaction responses to return false on declined transactions
• Search results now include Enumerable and will automatically paginate data
• Added credit_card[cardholder_name] to allowed transaction params and CreditCardDetails (thanks chrismcc)
• Fixed a bug with Customer::all
• Added constants for error codes

• Added methods to get both shallow and deep errors from a Braintree_ValidationErrorCollection
• Added the ability to make a credit card the default card for a customer
• Added constants for transaction statuses
• Updated Quick Start in README.md to show a workflow with error checking

• Added subscription search
• Provide access to associated subscriptions from CreditCard
• Switched from using Zend framework for HTTP requests to using curl extension
• Fixed a bug in Transparent Redirect when arg_separator.output is configured as & instead of &
• Increased http request timeout
• Fixed a bug where ForgedQueryString exception was being raised instead of DownForMaintenance
• Updated SSL CA files

• Added Braintree_Transaction::refund
• Added Braintree_Transaction::submitForSettlementNoValidate
• Fixed a bug in errors->onHtmlField when checking for errors on custom fields when there are none
• Added support for passing merchantAccountId for Transaction and Subscription

• Added recurring billing support

• Fixed bug with Braintree_Error_ErrorCollection.deepSize
• Added methods for accessing validation errors and params by html field name

• Initial release