NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #815 most downloaded on Packagist
Braintree PHP Client Library
Last release 17 days ago
16 Sep 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
145 releases · first in 2012
Remove deprecated GRANTED_PAYMENT_INSTRUMENT_UPDATE
GRANTED_PAYMENT_INSTRUMENT_UPDATEMerchantAccountGateway creation with applicantDetails. Please use individual, business, and funding.Customer is created, the customFields property is always an array rather than potentially null.riskData, applePay, applePayCard, threeDSecure, and venmo.profileId snakecase attributesSSLCertificate exception when related to SSL, otherwise a Connection exception is thrown.DownForMaintence Exception to ServiceUnavailable. Throw Timeout exception for transaction search errors instead of DownForMaintenance.RequestTimeout and GatewayTimeout exceptions.revokedAt field to PayPalAccountPAYMENT_METHOD_REVOKED_BY_CUSTOMER webhookOne column per quarter.
Deprecate GRANTED_PAYMENT_INSTRUMENT_UPDATE and add GRANTOR_UPDATED_GRANTED_PAYMENT_METHOD and RECIPIENT_UPDATED_GRANTED_PAYMENT_METHOD
GRANTED_PAYMENT_INSTRUMENT_UPDATE and add GRANTOR_UPDATED_GRANTED_PAYMENT_METHOD and RECIPIENT_UPDATED_GRANTED_PAYMENT_METHODaccountType field to TransactionGateway, CreditCardGateway, PaymentMethodGateway, and CreditCardVerification.refundFromTransactionFeeAmount field to PayPalDetailsrefundFromTransactionFeeCurrencyIsoCode field to PayPalDetailsAdd bin field to paymentMethodNonceDetails
bin field to paymentMethodNonceDetailsGrantedPaymentMethodRevoked webhook response objectsAdd fraudServiceProvider field in riskData
fraudServiceProvider field in riskDataAdd processorResponseType to Transaction, AuthorizationAdjustment, and CreditCardVerification.
processorResponseType to Transaction, AuthorizationAdjustment, and CreditCardVerification.authorizationExpiresAt to Transactiontravel_flight support to industry-specific dataFix dispute results in transactions not showing the correct status sometimes
externalVault option to transaction saleLocalPaymentCompleted webhookAdd subscription charged unsuccessfully sample webhook to webhook testing gateway
processor_response_code and processor_response_text to authorization adjustments subfield in transaction response.echo (thanks @cmeon)Allow payee ID to be passed in options params for transaction create
merchant_id to ConnectedMerchantStatusTransitioned and ConnectedMerchantPayPalStatusChanged Auth webhooksamount-won and amount-disputed (closes #225)Fix WebhookTestingGateway to use local configuration
Add support for US Bank Account verifications API
Fix issue where webhook verification would fail due to missing global public key configuration value
Add oauthAccessRevocation to WebhookNotifications
oauthAccessRevocation to WebhookNotificationsprofileId in Transaction#create options for VenmoAccountscustomerId, disbursementDate, and effectiveDateCustomerGateway::find backward compatiblesepaMandateType and sepaMandateAcceptanceLocation params from ClientTokenGatewayAdd support for association_filter_id in Customer#find
association_filter_id in Customer#findtimeout and acceptGzipEncoding values on construction of Configuration instancesDeprecate TRANSACTION_LINE_ITEM_DISCOUNT_AMOUNT_MUST_BE_GREATER_THAN_ZERO error in favor of TRANSACTION_LINE_ITEM_DISCOUNT_AMOUNT_CANNOT_BE_NEGATIVE.
shippingAmount, discountAmount, and shipsFromPostalCodetax_amount field on transaction line_itemssourceMerchantId property to WebhookNotifications if presentTRANSACTION_LINE_ITEM_DISCOUNT_AMOUNT_MUST_BE_GREATER_THAN_ZERO error in favor of TRANSACTION_LINE_ITEM_DISCOUNT_AMOUNT_CANNOT_BE_NEGATIVE.TRANSACTION_LINE_ITEM_UNIT_TAX_AMOUNT_MUST_BE_GREATER_THAN_ZERO error in favor of TRANSACTION_LINE_ITEM_UNIT_TAX_AMOUNT_CANNOT_BE_NEGATIVE.Braintree\Transaction\LineItem in favor of Braintree\TransactionLineItem.findAll static method to TransactionLineItem classprofile_id in Transaction#create options for VenmoAccountsAdd support for Level 3 summary parameters: shippingAmount, discountAmount, and shipsFromPostalCode
shippingAmount, discountAmount, and shipsFromPostalCodeDisputeGateway::addTextEvidence (Beta release)Deprecate OAuthGateway::computeSignature
OAuthGateway::computeSignatureAddress deprecation warnings for create_function with PHP 7 (#193, thanks @chrisdeeming)
cardHolderName to CreditCardDetails (#201, thanks @Samistine)options -> paypal -> shipping for creating & updating customers as well as creating payment methodsoptions -> paypal -> description for creating and updating subscriptionsbinData to PaymentMethodNoncebin to ApplePayCarddeviceDataCaptured field in riskDataAdd submitForSettlement option to Subscription::retryCharge
submitForSettlement option to Subscription::retryChargeeci_indicator for Transaction sale with raw Apple Pay parametersaccept method for the Dispute APIaddTextEvidence method for the Dispute APIaddFileEvidence method for the Dispute APIfinalize method for the Dispute APIfind method for the Dispute APIremoveEvidence method for the Dispute APIsearch method for the Dispute APIAdd AuthorizationAdjustment class and authorizationAdjustments to Transaction
authorizationAdjustments to TransactionIDEAL_PAYMENT to PaymentInstrumentTypePAYMENT_METHOD_NO_LONGER_SUPPORTED will be returned for Coinbase operations.ApplePay for web domain registration.Fix token generator return type - thanks @jjok!
Add ConnectedMerchantStatusTransitioned and ConnectedMerchantPayPalStatusChanged Auth webhooks
CreditCardVerification and CustomerAdd option to disable Accept-Encoding: gzip header for Google App Engine
merchantAccount->all would attempt to fetch too many pages of merchant accountsAdd back in options->three_d_secure to transaction params that was accidentally removed in v3.14.0
options->three_d_secure to transaction params that was accidentally removed in v3.14.0Allow optional configuration of SSL version
var_dump with print_r. Thanks, @mnlgmerchantAccount->allAdd option skip_advanced_fraud_check for transaction flows
skip_advanced_fraud_check for transaction flowsAdd multi-currency updates to merchants onboarded through Braintree Auth
Fix UsBankAccount support for Customers
UsBankAccount support for CustomersGrant api to support options hashAdd 'UsBankAccount' payment method
Add authenticated proxy functionality
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->thre…
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 method of revoking OAuth access tokens.
Support for Too Many Requests response codes
update_detailsRemove final from classes. Thanks, @ibrahimlawal!
Add start-date and end-date to SUBSCRIPTION_CHARGED_SUCCESSFULLY test webhook response
Add AccountUpdaterDailyReport webhook parsing
Add support for options in submit_for_settlement transaction flows
submit_for_settlement transaction flowsAllow order_id and descriptor to be passed in for Transaction submit_for_settlement
Fix PSR-0 style namespacing when using Symfony
Add support for AMEX Express Checkout
dateWon, dateOpened, kind)Add support for raw ApplePay params on Transaction create
Add sourceDescription method to Android Pay and Apple Pay payment methods
Add new test payment method nonces
* Add additional search criteria
Validate that configuration is valid before verifying webhooks
* Add support for Android Pay
Validate webhook challenge payload
__toString() on objects that contain a \DateTimeNothing published for this version
Add missing criteria to credit card verification search
Add 3DS info to the server side
Update payment instrument types and test nonces
Nothing published for this version
Add 3D Secure transaction fields
Surface Apple Pay payment instrument name in responses
Expose subscription status details
* Bugfix for auto loading files
Allow PayPal fields in transaction.options.paypal
Add risk_data to Transaction and Verification with Kount decision and id
Allow descriptor to be passed in Funding Details options params for Merchant Account create and update.
Add additionalProcessorResponse to Transaction
Your coding agent can read these notes before it upgrades. Set up the MCP server →