Skip to content

CHANGELOG.md

Latest commit

 

History

History
986 lines (772 loc) · 38.7 KB

CHANGELOG.md

File metadata and controls

986 lines (772 loc) · 38.7 KB

Changelog

6.33.1

  • Fixes syntax error in Version.php file

6.33.0

  • 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

6.32.0

  • 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

6.31.0

  • 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

6.30.0

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

6.29.0

  • 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

6.28.0

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

6.27.0

  • Add Session Id to Customer Recommendations Payload

6.26.0

  • 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

6.25.0

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

6.24.0

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

6.23.0

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

6.22.0

  • Add recipient/contact info: recipient_emailand recipient_phone to Transaction

6.21.0

  • 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

6.20.0

  • 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.

6.19.0

  • 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

6.18.0

  • 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

6.17.0

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

6.16.0

  • 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

6.15.0

  • 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

6.14.0

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

6.13.0

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

6.12.0

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

6.11.2

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

6.11.1

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

6.11.0

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

6.10.0

  • 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

6.9.1

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

6.9.0

  • 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)

6.8.0

  • Add retried to Transaction

6.7.0

  • Fix lint errors on unit test

6.6.0

  • Add PaymentMethodCustomerDataUpdated webhook notification support

6.5.1

  • Address PHP 8.1 Deprecation warnings

6.5.0

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

6.4.1

  • 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

6.3.0

  • 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.

6.2.0

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

6.1.0

  • 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)

6.0.0

  • 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

5.5.0

  • 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

5.4.0

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

5.3.1

  • Deprecate masterpassCard and amexExpressCheckoutCard payment methods
  • Deprecate amexExpressCheckoutCardDetails

5.3.0

  • 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

5.2.0

  • 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.

5.1.0

  • 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)

5.0.0

  • 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

4.8.0

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

4.7.0

  • 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

4.6.0

  • 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

4.5.0

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

4.4.0

  • Add AMOUNT_NOT_SUPPORTED_BY_PROCESSOR to validation errors
  • Forward forwardedComments to processorComments

4.3.0

  • 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

4.2.0

  • 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

4.1.0

  • 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

4.0.0

  • 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

3.40.0

  • 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

3.39.0

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

3.38.0

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

3.37.0

  • 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

3.36.0

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

3.35.0

  • 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

3.34.0

  • 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)

3.33.0

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

3.32.0

  • Add support for US Bank Account verifications API

3.31.0

  • 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

3.30.0

  • 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

3.29.0

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

3.28.0

  • 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

3.27.0

  • 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

3.26.1

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

3.26.0

  • 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

3.25.0

  • 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

3.24.0

  • 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!).

3.23.1

  • 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

3.23.0

  • 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

3.22.0

  • 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

3.21.1

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

3.21.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

3.20.0

  • Add option skip_advanced_fraud_check for transaction flows

3.19.0

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

3.18.0

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

3.17.0

  • Add 'UsBankAccount' payment method

3.16.0

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

3.15.0

  • Add 'default_payment_method' option for Customer

3.14.0

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

3.13.0

  • Add method of revoking OAuth access tokens.

3.12.0

  • 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

3.11.0

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

3.10.0

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

3.9.0

  • Add AccountUpdaterDailyReport webhook parsing

3.8.0

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

3.7.0

  • 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

3.6.1

  • Fix PSR-0 style namespacing when using Symfony

3.6.0

  • 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

3.5.0

  • Add support for raw ApplePay params on Transaction create

3.4.0

  • 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

3.3.0

  • 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

3.2.0

  • Add additional search criteria

3.1.0

  • 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

3.0.1

  • Add support for Android Pay

3.0.0

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

2.40.0

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

2.39.0

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

2.38.0

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

2.37.0

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

2.36.0

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

2.35.2

  • Fix E_STRICT errors
  • Expose subscription status details

2.35.1

  • Bugfix for auto loading files

2.35.0

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

2.34.0

  • 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

2.33.0

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

2.32.0

  • Add additionalProcessorResponse to Transaction

2.31.1

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

2.31.0

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

2.30.0

  • Add descriptor url support

2.29.0

  • 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

2.28.0

  • Adds support for v.zero SDKs.

2.27.2

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

2.27.1

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

2.27.0

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

2.26.0

  • Disbursement Webhooks

2.25.1

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

2.25.0

  • Merchant account find API

2.24.0

  • Merchant account update API
  • Merchant account create API v2

2.23.1

  • Update configuration URLs

2.23.0

  • Official Partnership support

2.22.2

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

2.22.1

  • Adds missing test contstant to library namespace

2.22.0

  • 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!)

2.21.0

  • Enable device data.

2.20.0

2.19.0

  • Adds channel field to transactions.

2.18.0

  • Adds country of issuance and issuing bank bin database fields

2.17.0

  • Adds verification search

2.16.0

  • 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

2.15.0

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

2.14.1

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

2.14.0

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

2.13.0

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

2.12.5

  • Exposes plan_id on transactions

2.12.4

  • Added error code for invalid purchase order number

2.12.3

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

2.12.2

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

2.12.1

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

2.12.0

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

2.11.0

  • Added Braintree_SettlementBatchSummary

2.10.1

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

2.10.0

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

2.9.0

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

2.8.0

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

2.7.0

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

2.6.1

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

2.6.0

  • 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

2.5.0

  • 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

2.4.0

  • 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

2.3.0

  • 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

2.2.0

  • 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

2.1.0

  • 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

2.0.0

  • 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

1.2.1

  • 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

1.2.0

  • 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

1.1.1

  • 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

1.1.0

  • Added recurring billing support

1.0.1

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

1.0.0

  • Initial release