braintree/braintree_php
Braintree PHP Client Library
6.37.0
51M downloads/mo
#730 most downloaded on Packagist
braintree/braintree_php
What this package is like to depend on
Last release 18 days ago
05 Aug 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 141 of 143 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
144 releases · first in 2012
10 releases in the last 12 months
see the full history below
Release timeline
144 releases · Jul 2012 to Aug 2026
2013
2015
2017
2019
2021
2023
2025
Releases
latest 60 of 144-
6.37.005 Aug 2026Release notes
Open source →- Fix path traversal vulnerability in
DisputeandAddressgateways by validating that IDs used in request paths do not contain path separators or relative-path segments - Add
PAYPAL_ACCOUNT_EMAIL_FORMAT_IS_INVALID (92963)andPAYPAL_ACCOUNT_EMAIL_IS_TOO_LONG (92964)validation error codes - Add
preferredPaymentMethodTokentoClientToken::generate
- Fix path traversal vulnerability in
-
6.36.015 Jun 2026Release notes
Open source →- Deprecate
debugIdonTransaction\PayPalDetails,Transaction\LocalPaymentDetails, andTransaction\SepaDirectDebitAccountDetails - Add
accountReferenceNumberTypeto sender and receiver in transfer onTransaction - Add
CannotCloneThirdPartyCofNetworkTokenTransaction (915274)transaction validation error code
- Deprecate
-
6.35.027 May 2026Release notes
Open source →- Add
mastercardTransactionLinkIdtoTransactionandVerification - Fix webhook signature verification vulnerability when using OAuth Connect
- Add
-
6.34.030 Apr 2026 -
6.33.115 Apr 2026 -
6.33.009 Apr 2026Release notes
Open source →- Add Local Payment Context support with
LocalPaymentGateway->create()andLocalPaymentGateway->find()methods - Add support for MBWAY and CRYPTO payment types
- Add
acquirerReferenceNumberto transaction search object - Remove merchant create functionality
- Remove
accountFundingTransactionfromTransactionrequest - Add
apiRequestKey(idempotency) support forTransaction::sale(),Transaction::credit(),Transaction::submitForSettlement(),Transaction::submitForPartialSettlement(),Transaction::void(), andTransaction::refund() - Add
surchargeAmountto transaction object
- Add Local Payment Context support with
-
6.32.002 Feb 2026Release notes
Open source →- 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
acceptPartialAuthorizationtoTransactionGatewayandpartiallyAuthorizedtoTransaction - Deprecate transactions for
visa_checkout_cardand maintain search functionality - Add
achTypetooptions->usBankAccountinTransaction::sale() - Add
achTypeandrequestedAchTypetoTransaction
-
6.31.011 Dec 2025Release notes
Open source →- Filter CreditCardVerification::search() to only return credit card verifications
- Add
middleNameto sender and receiver, anddateOfBirthto sender in transfer onTransaction - Remove unused error code
AdjustmentAmountMustBeGreaterThanZero
-
6.30.023 Oct 2025Release notes
Open source →- Add
processingMerchantCategoryCodetoTransactionGateway - Add missing
transfervalidation error codes inTransaction
- Add
-
6.29.015 Oct 2025Release notes
Open source →- Add Bank Account Instant Verification functionality
- Add
BankAccountInstantVerificationGatewayfor creating JWT tokens - Add
BankAccountInstantVerificationJwtandBankAccountInstantVerificationJwtRequestclasses - Add
bankAccountInstantVerification()method to main Gateway class - Add ACH mandate support for US Bank Account transactions
- Add
achMandateTextandachMandateAcceptedAtfields to Transaction and PaymentMethod create signatures - Add
usBankAccountparameter support for ACH mandate details - Add
INSTANT_VERIFICATION_ACCOUNT_VALIDATIONas a new US Bank Account verification method - Add
senderandreceivertotransferinTransaction - Add
achRejectReasonfield toTransaction - Add
isDeviceTokenandmerchantTokenIdentifiertoApplePayCardandApplePayDetails - Add
paymentAccountReferencetoApplePayCardDetails,GooglePayCardDetails,CreditCardDetailsandCreditCardVerification
-
6.28.005 Aug 2025Release notes
Open source →- Add
upcomingRetryDateto Transaction - Add
remainingFileEvidenceStoragetoDispute - Add
transaction_retriedwebhook - Add
transfer typeto Transaction
- Add
-
6.27.026 Jun 2025 -
6.26.028 May 2025Release notes
Open source →- Add
accountInformationInquiryto:CreditCard.createandCreditCard.updatePaymentMethod.createandPaymentMethod.updateCreditCardVerification.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, andpurchasefrom the bin data to credit card responses
- Add
-
6.25.030 Apr 2025Release notes
Open source →- Remove marketplace features
- Add support for capturing payment facilitator and sub-merchant details with transactions
-
6.24.028 Feb 2025Release notes
Open source →- Add support for
PayPalPaymentResourcerequests - Add prepaid_reloadable from bin data in credit card responses
- Add support for
-
6.23.029 Jan 2025Release notes
Open source →- Add support for creating and updating PayPal customer session
- Add support for getting PayPal customer recommendations
-
6.22.023 Jan 2025Release notes
Open source →- Add recipient/contact info:
recipient_emailandrecipient_phonetoTransaction
- Add recipient/contact info:
-
6.21.031 Oct 2024Release notes
Open source →- Add
fail_on_duplicate_payment_method_for_customeroption toClientTokenPaymentMethodCreditCard
- Add
blik_aliasesto LocalPaymentCompleted webhook - Deprecate
SamsungPayCard - Updated expiring pinned vendor SSL certificates
- Add
-
6.20.019 Sep 2024Release notes
Open source →- Add
payer_name,bicandiban_last_charsto LocalPaymentCompleted webhook - Fixes "Array to String conversion" error when an international phone number is included in customer details
- Add
editPaypalVaultIdto PayPalAccount - Add
aniFirstNameResponseCodeandaniLastNameResponseCodeto CreditCardVerification - Add
shippingTaxAmountto Transaction - Add
networkTokenizationAttributesparameter toTransaction.sale - Add
CREDIT_CARD_NETWORK_TOKENIZATION_ATTRIBUTE_CRYPTOGRAM_IS_REQUIREDto validation error codes.
- Add
-
6.19.023 Jul 2024Release notes
Open source →- Add
foreignRetailerto Transaction - Add
internationalPhonetoAddressandCustomer - Add
fundingSourceDescriptionto PayPalAccount - Add missing
GooglePayCarderror code - Add
REFUND_FAILEDto WebhookNotification - Add
final_captureto TransactionsubmitForPartialSettlement - Deprecate
paypalTrackingIdin favor ofpaypalTrackerId
- Add
-
6.18.026 Mar 2024Release notes
Open source →- Deprecate
CreditCard::creditin favor ofTransaction::credit - Deprecate
CreditCard::salein favor ofTransaction::sale - Add
domainsparameter support toClientToken::generate - Refactor key validation in
ClientTokenGateway
- Deprecate
-
6.17.006 Mar 2024Release notes
Open source →- Add
UNDER_REVIEWDispute Status - Add
DISPUTE_UNDER_REVIEWWebhookNotification - Add
debitNetworksupportTransactionandTransactionSearch - Add
process_debit_as_credittoTransactionOptionsCreditCardRequest
- Add
-
6.16.009 Jan 2024Release notes
Open source →- Deprecate
threeDSecureTokenin favor ofthreeDSecureAuthenticationId - Deprecate
venmoSdkSession,venmoSdkPaymentMethodCode, andisVenmoSdk() - Add
PICKUP_IN_STOREtoShippingMethodenum - Add to
CreditCardVerificationcreate requestexternalVaultpaymentMethodNonceriskDatathreeDSecureAuthenticationIdthreeDSecurePassThru
- Add
phoneNumbertoAddress,CreditCardGateway,PaymentMethodGatewayandCustomerGateway - Add
packagestoTransaction - Add
packageTrackingmethod toTransactionGatewayto make request to add tracking information to transactions - Add check for empty
liabilityShiftinRiskData - Add
imageUrl,upcCode, andupcTypetolineItemsinTransactionGateway
- Deprecate
-
6.15.008 Nov 2023Release notes
Open source →- Add
billingAddressandshippingAddresstoVenmoProfileDataforPaymentMethodCustomerDataUpdatedwebhook - Add
MetaCheckoutCardandMetaCheckoutTokenpayment methods - Add
MetaCheckoutCardDetailsandMetaCheckoutTokenDetailsto Transaction object - Add
verificationAddOnsandadditionalProcessorResponsetoPaymentMethodCreatefor ACH Network Check - Add
dateOfBirthandcountryCodetoindustry_data
- Add
-
6.14.018 Oct 2023Release notes
Open source →- Add
arrivalDateandticketIssuerAddressto Transaction object - Add
SUBSCRIPTION_BILLING_SKIPPEDWebhookNotification
- Add
-
6.13.030 Aug 2023Release notes
Open source →- Add
retry_idsandretry_transaction_idto Transaction object - Add
processing_overridestoTransaction.saleoptions
- Add
-
6.12.031 May 2023Release notes
Open source →- Add subscriptions for SEPA direct debit account
- Add
merchant_advice_codeandmerchant_advice_code_texttoTransaction
-
6.11.206 Apr 2023Release notes
Open source →TestingGatewaymethods return type isResult\Errorfor validation errors.
-
6.11.118 Jan 2023Release notes
Open source →- Resolved various dynamic property warnings for PHP 8.2 (thanks to @mvoelker & @markdavidsonEE)
-
6.11.011 Jan 2023Release notes
Open source →- Add
preDisputeProgramtoDisputeandDisputeSearch - Add
AUTO_ACCEPTEDDispute Status - Add
DISPUTE_AUTO_ACCEPTEDWebhookNotification - Add
EXCESSIVE_RETRYtoGatewayRejectionReason
- Add
-
6.10.009 Nov 2022Release notes
Open source →- Add
SEPADirectDebitAccountpayment method - Add
SEPADirectDebitAccountDetailsto transaction object - Add
SEPA_DIRECT_DEBIT_ACCOUNTto payment instrument type - Add SEPA Direct Debit specific error codes
- Add SEPA Direct Debit array to customer object
- Deprecate
chargebackProtectionLeveland addprotectionLeveltoDisputeandDisputeSearch
- Add
-
6.9.103 Oct 2022Release notes
Open source →- Address PHP 8.2 deprecation warnings due to string interpolation patterns. (thanks @Ayesh)
-
6.9.025 Jul 2022Release notes
Open source →- Add
TRANSACTION_REASON_CODEto search for transaction that have any ach return response with reason code associated. - Add
reasonCodecriteria toTransactionSearch - Add
achReturnResponsesCreatedAtcriteria toTransactionSearch - Add
LiabilityShiftclass andliabilityShiftto RiskData - Add support for
ExchangeRateQuoteAPI - Fix various PHP 8.1
nullwarnings (thanks @simoheinonen & @robbieaverill)
- Add
-
6.8.001 Apr 2022 -
6.7.023 Feb 2022 -
6.6.017 Feb 2022 -
6.5.120 Dec 2021 -
6.5.012 Nov 2021Release notes
Open source →- Add plan create/update/find API endpoint
- Add
TransactionReviewwebhook notification
-
6.4.121 Jul 2021Release notes
Open source →- Add
exchangeRateQuoteIdtoTransaction.sale - Add error code
EXCHANGE_RATE_QUOTE_ID_IS_TOO_LONG - Added the following fields to GooglePayCard and ApplePayCard:
commercialdebitdurbinRegulatedhealthcarepayrollprepaidproductIdcountryOfIssuanceissuingBank
- Add
LocalPaymentExpiredandLocalPaymentFundedwebhook notification support
- Add
-
6.4.021 Jul 2021Nothing published for this version
-
6.3.021 Jun 2021Release notes
Open source →- Add
paymentReaderCardDetailsparameter toTransaction.sale - Add error code
TRANSACTION_TAX_AMOUNT_IS_REQUIRED_FOR_AIB_SWEDISHfor attributetaxAmountintransactionkey for AIB:Domestic transactions in Sweden.
- Add
-
6.2.017 May 2021Release notes
Open source →- Add
chargebackProtectionLeveltoDisputeandDisputeSearch - Add
skipAdvancedFraudCheckingto:CreditCard.createandCreditCard.updatePaymentMethod.createandPaymentMethod.update
- Add
-
6.1.006 May 2021Release notes
Open source →- Add
paypalMessagestoDispute - Fix bug where
__issetmethods inInstanceandBaseclasses treatednullvalue as set (Thanks @sklodzio) - Add
tax_identifiersparameter toCustomer.createandCustomer.update - Add webhook sample for
GrantedPaymentMethodRevoked - Add sample webhook notifications for
SUBSCRIPTION_EXPIRED,SUBSCRIPTION_CANCELEDandSUBSCRIPTION_WENT_PAST_DUE(thanks @antonvolokha)
- Add
-
6.0.006 Apr 2021Release notes
Open source →- Add
LocalPaymentReversedwebhook - Add
adjustAuthorizationmethod to Transaction, for supporting multiple authorizations on a single transaction - Add
storeIdandstoreIdsto Transaction search - Add
merchantAccountIdparameter to Transaction refund - Parameters that supported DateTime objects can also support DateTimeImmutable objects (closes #278)
- Add
toArrayfunction to Base and Instance classes (resolves #289) - Add
jsonSerializeto Instance class - Breaking Changes:
- Require PHP 7.3 or higher
- Rename
AndroidPayCardtoGooglePayCard - Rename
AndroidPayCardDetailstoGooglePayCardDetails - 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_INVALIDandRISK_DATA_CUSTOMER_BROWSER_IS_TOO_LONGerror codes - Remove
customer_ipandcustomer_browsersnake case parameters in favor of camel casecustomerIpandcustomerBrowseraccepted inCustomer#createandTransaction#sale - Remove
AmexExpressCheckoutCardandAmexExpressCheckoutCardDetails - Remove
MasterpassCardandMasterpassCardDetails - Remove deprecated parameters:
deviceSessionIdfrom CreditCardGateway#update, CreditCardGateway#create, CustomerGateway#create, CustomerGateway#update, PaymentMethodGateay#update, and TransactionGateway#createfraudMerchantIdfrom CreditCardGateway#update, CreditCardGateway#create, CustomerGateway#create, CustomerGateway#update, PaymentMethodGateay#update, and TransactionGateway#create
- Add
-
5.5.025 Jan 2021Release notes
Open source →- Add
scaExemptionto Transaction sale - Deprecate
deviceSessionIdandfraudMerchantIdinCreditCardGateway,CustomerGateway,PaymentMethodGateway, andTransactionGatewayclasses - Add
installmentsto Transaction sale - Add
counttoinstallments
- Add
-
5.4.009 Nov 2020Release notes
Open source →- Add
AcquirerReferenceNumbertoTransaction - Add
billingAgreementIdtoPayPalDetails - Deprecate
recurringin Transaction sale - Deprecate
tagin Dispute add text evidence
- Add
-
5.3.102 Oct 2020Release notes
Open source →- Deprecate
masterpassCardandamexExpressCheckoutCardpayment methods - Deprecate
amexExpressCheckoutCardDetails
- Deprecate
-
5.3.005 Aug 2020Release notes
Open source →- Add
RISK_THRESHOLDtoGatewayRejectionReasonconstants - Add
networkTransactionIdtoCreditCardVerification - Add
processedWithNetworkTokentoTransaction - Add
isNetworkTokenizedtoCreditCard - Add
productSkutoTransaction - Add
phoneNumberandshippingMethodtoAddress - Add
customerDeviceId,customerLocationZip, andcustomerTenuretoRiskData - Add error codes
TRANSACTION_PRODUCT_SKU_IS_INVALIDTRANSACTION_SHIPPING_METHOD_IS_INVALIDTRANSACTION_SHIPPING_PHONE_NUMBER_IS_INVALIDTRANSACTION_BILLING_PHONE_NUMBER_IS_INVALIDRISK_DATA_CUSTOMER_BROWSER_IS_TOO_LONGRISK_DATA_CUSTOMER_DEVICE_ID_IS_TOO_LONGRISK_DATA_CUSTOMER_LOCATION_ZIP_INVALID_CHARACTERSRISK_DATA_CUSTOMER_LOCATION_ZIP_IS_INVALIDRISK_DATA_CUSTOMER_LOCATION_ZIP_IS_TOO_LONGRISK_DATA_CUSTOMER_TENURE_IS_TOO_LONGRISK_DATA_CUSTOMER_TENURE_IS_INVALID
- Add
-
5.2.015 Jun 2020Release notes
Open source →- Add
retrieval_reference_numbertoTransaction - 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, andsslVersionwere not being set on Gateway or Configuration objects.
- Add
-
5.1.012 May 2020Release notes
Open source →- Add
threeDSecurePassThruparameters toCustomer.create,PaymentMethod.create,CreditCard.create,Customer.update,PaymentMethod.updateandCreditCard.update - Add
recurringCustomerConsentandrecurringMaxAmounttoauthenticationInsightOptionsforPaymentMethodNonce.create - Add
DOCUMENT_UPLOAD_FILE_IS_EMPTYerror code - phpDocs fixes (thanks @pupitooo)
- Add
-
5.0.025 Mar 2020Release notes
Open source →- Add
DISPUTE_ACCEPTED,DISPUTE_DISPUTED, andDISPUTE_EXPIREDwebhook constants - Breaking Changes:
- Upgrade API version to retrieve declined refund transactions
- Throw
RequestTimeoutinstead ofTimeoutfor 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
-
4.8.012 Mar 2020Release notes
Open source →- Add
Authentication Insightto payment method nonce create - Add
threeDSecureAuthenticationIdsupport to transaction sale - Add ThreeDSecure test payment method nonces
- Add test
AuthenticationIds
- Add
-
4.7.020 Feb 2020Release notes
Open source →- Add
RefundAuthHardDeclinedandRefundAuthSoftDeclinedto validation errors - Add level 2 processing options
purchaseOrderNumber,taxAmount, andtaxExemptto Transaction submit for settlement - Add level 3 processing options
discountAmount,shippingAmount,shipsFromPostalCode, andlineItemsto Transaction submit for settlement
- Add
-
4.6.013 Jan 2020Release notes
Open source →- Add
isNetworkTokenizedtoAndroidPayCardandAndroidPayCardDetails - Add GraphQL ID to
CreditCardVerification,Customer,Dispute, andTransaction - Add support for PHP 7.4 (#262 thanks @slt)
- Add
threeDSecurePassThruparams to PaymentMethod update
- Add
-
4.5.028 Oct 2019Release notes
Open source →- Add
PROCESSOR_DOES_NOT_SUPPORT_MOTO_FOR_CARD_TYPEto validation errors - Make errors JSON serializable (#256 thanks @sebdesign)
- Add
-
4.4.002 Oct 2019Release notes
Open source →- Add
AMOUNT_NOT_SUPPORTED_BY_PROCESSORto validation errors - Forward
forwardedCommentstoprocessorComments
- Add
-
4.3.009 Aug 2019Release notes
Open source →- Add
PayPalHereDetailsto transactions - Add
network_response_codeandnetwork_response_texttoTransactionandCreditCardVerification - Add
xid,cavv,eciFlag,dsTransactionId, andthreeDSecureVersiontoThreeDSecureInfo - Add
threeDSecureInfotoCreditCardVerification - Add
GraphQLClienttoBraintreeGatewayclass
- Add
-
4.2.027 Jun 2019Release notes
Open source →- Add
captureIdtoLocalPaymentDetails - Add
debugIdtoLocalPaymentDetails - Add
refundIdtoLocalPaymentDetails - Add
transactionFeeAmounttoLocalPaymentDetails - Add
transactionFeeCurrencyIsoCodetoLocalPaymentDetails - Add
refundFromTransactionFeeAmounttoLocalPaymentDetails - Add
refundFromTransactionFeeCurrencyIsoCodetoLocalPaymentDetails - Add
threeDSecureVersion,authenticationResponse,directoryResponse,cavvAlgorithmanddsTransactionIdto 3DS pass thru fields - Add
payerInfotoPaymentMethodNoncedetails - Add
roomTaxfield to Transaction sale - Add
noShowfield to Transaction sale - Add
advancedDepositfield to Transaction sale - Add
fireSafefield to Transaction sale - Add
propertyPhonefield to Transaction sale - Add
additionalChargesfield to Transaction sale - Add
PostalCodeIsRequiredForCardBrandAndProcessorto validation errors
- Add
-
4.1.021 May 2019Release notes
Open source →- Add
revokedAtfield toPayPalAccount - Add support for
PAYMENT_METHOD_REVOKED_BY_CUSTOMERwebhook - Add
payment_method_noncefield toLocalPaymentCompletedwebhook - Add
transactionfield toLocalPaymentCompletedwebhook - Add
localPaymentDetailto transactions - Add
TOKEN_ISSUANCEgatewayRejectionReason enum toTransaction
- Add
-
4.0.006 May 2019Release notes
Open source →- 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
MerchantAccountGatewaycreation withapplicantDetails. Please useindividual,business, andfunding. - When a
Customeris created, thecustomFieldsproperty is always an array rather than potentiallynull. - Remove Transparent Redirect
- Remove
riskData,applePay,applePayCard,threeDSecure, andvenmo.profileIdsnakecase attributes - HTTPS requests throw an
SSLCertificateexception when related to SSL, otherwise aConnectionexception is thrown. - Rename
DownForMaintenceException toServiceUnavailable. ThrowTimeoutexception for transaction search errors instead ofDownForMaintenance. - Add
RequestTimeoutandGatewayTimeoutexceptions. - Add
revokedAtfield toPayPalAccount - Add support for
PAYMENT_METHOD_REVOKED_BY_CUSTOMERwebhook