NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet · #2268 most downloaded on NuGet
Braintree Client Library
Last release 3 months ago
17 Jun 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
5 versions withdrawn
withdrawn after publishing
127 years old
141 releases · first in 1900
Deprecate DebugId on PayPalDetails, LocalPaymentDetails, and SepaDirectDebitAccountDetails
…to CustomerDetails in Transaction -Deprecate merchant create functionality -Add ApiRequestKey (idempotency) in TransactionRequest and TransactionRefun…
-Add Local Payment Context support with LocalPaymentContextGateway.Create and LocalPaymentContextGateway.Find methods -Add support for MBWAY and CRYPTO payment types -Add acquirerReferenceNumber to transaction search object -Add InternationalPhone to CustomerDetails in Transaction -Deprecate merchant create functionality -Add ApiRequestKey (idempotency) in TransactionRequest and TransactionRefundRequest -Add surchargeAmount to transaction object -Add Apple Pay verification functionality for customer and payment method creation -Add support for in-memory stream-based document uploads via new ContentStream and FileName properties on DocumentUploadRequest -Add MastercardTransactionLinkId to transaction and creditCardVerification object
One column per quarter.
-Add acceptPartialAuthorization in TransactionRequest and PartiallyAuthorized in Transaction -Deprecate transactions for visa_checkout_card and mainta…
-Add acceptPartialAuthorization in TransactionRequest and PartiallyAuthorized in Transaction -Deprecate transactions for visa_checkout_card and maintain search functionality -Add UsBankAccount to TransactionOptionsRequest -Add field AchType to TransactionOptionsUsBankAccountRequest -Add response field RequestedAchType, AchType to Transaction
Add ProcessingMerchantCategoryCode to TransactionRequest
ProcessingMerchantCategoryCode to TransactionRequesttransfer validation error codes in TransactionAdd ProcessingMerchantCategoryCode to TransactionRequest
ProcessingMerchantCategoryCode to TransactionRequesttransfer validation error codes in TransactionAdd Bank Account Instant Verification functionality Add BankAccountInstantVerificationGateway for creating JWT tokens Add BankAccountInstantVerificati
Add Bank Account Instant Verification functionality
Add BankAccountInstantVerificationGateway for creating JWT tokens
Add BankAccountInstantVerificationJwt response object
Add BankAccountInstantVerificationJwtRequest for JWT creation
Add AchMandate and AchMandateAcceptedAt fields to TransactionRequest
Add INSTANT_VERIFICATION_ACCOUNT_VALIDATION method to UsBankAccountVerificationMethod
Add AchRejectReason field to Transaction
Add sender and receiver to transfer in Transaction
Add IsDeviceToken to ApplePayCard and ApplePayDetails
Add PaymentAccountReference to ApplePayDetails, AndroidPayDetails, CreditCard, and CreditCardVerification
Add UpcomingRetryDate field to Transaction
Add Session Id to Customer Recommendations Payload
Add AccountInformationInquiry to:
AccountInformationInquiry to:
- Customer.create and Customer.update
- 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 responsesAdd support for capturing payment facilitator and sub-merchant details with transactions
Add support for PayPalPaymentResource requests
PayPalPaymentResource requestsprepaid_reloadable from the bin data to credit card responsesAdd support for creating and updating PayPal customer session
Add recipient/contact info: recipient_emailand recipient_phone to Transaction
recipient_emailand recipient_phone to TransactionAdd fail_on_duplicate_payment_method_for_customer option to
fail_on_duplicate_payment_method_for_customer option to
ClientTokenPaymentMethodCreditCardblik_aliases to LocalPaymentCompleted webhook and LocalPaymentDetailSamsungPayCardAdd PayerName, Bic and IbanLastChars to LocalPaymentCompleted webhook
PayerName, Bic and IbanLastChars to LocalPaymentCompleted webhookedit_paypal_vault_id to PayPalAccountAniFirstNameResponseCode and AniLastNameResponseCode to CreditCardVerificationShippingTaxAmount to Transaction and TransactionRequestnetworkTokenizationAttributes to TransactionCreditCardRequestNetworkTokenizationAttributesRequest classCREDIT_CARD_NETWORK_TOKENIZATION_ATTRIBUTE_CRYPTOGRAM_IS_REQUIREDDeprecate paypal_tracking_id in favor of paypal_tracker_id in PackageDetails
ThreeDSecureLookupRequest
MerchantInitiatedRequestTypePriorAuthenticationIdMerchantOnRecordNamePriorAuthenticationDetailsForeignRetailer to Transaction and TransactionRequestInternationalPhone to Address and CustomerfundingSourceDescription to PayPalAccountAndroidPayCard error codeREFUND_FAILED to WebhookKindFinalCapture to Transaction TransactionRequestpaypal_tracking_id in favor of paypal_tracker_id in PackageDetailsAdd domains parameter support to ClientTokenRequest
domains parameter support to ClientTokenRequestAdd UNDER_REVIEW to DisputeStatus
UNDER_REVIEW to DisputeStatusDISPUTE_UNDER_REVIEW to WebhookKindDebitNetwork to TransactionTransactionDebitNetwork enum to TransactionDebitNetwork to TransactionSearchRequest to search by debitNetworksProcessDebitAsCredit to TransactionOptionsCreditCardRequestAdd PackageTracking and PackageTrackingAsync methods to TransactionGateway to make request to add tracking information to transactions
PackageTracking and PackageTrackingAsync methods to TransactionGateway to make request to add tracking information to transactionsPackageDetails and PackageTrackingRequest classesUpcCode, UpcType, ImageUrl to TransactionLineItem and TransactionLineItemRequestDeprecate threeDSecureToken in favor of threeDSecureAuthenticationId
threeDSecureToken in favor of threeDSecureAuthenticationIdVenmoSdkSession, VenmoSdkPaymentMethodCode, and IsVenmoSdkPICKUP_IN_STORE to ShippingMethod enumExternalVault and RiskData to CreditCardVerificationRequestAdd DateOfBirth and CountryCode to IndustryDataRequest
DateOfBirth and CountryCode to IndustryDataRequestBillingAddress and ShippingAddress to VenmoProfileDataVerificationAddOns and AdditionalProcessorResponse to UsBankAccountVerificationMetaCheckoutCard and MetaCheckoutToken to payment methodMetaCheckoutCardDetails and MetaCheckoutTokenDetails to TransactionAdd SUBSCRIPTIONBILLINGSKIPPED webhook notification support
SUBSCRIPTIONBILLINGSKIPPED webhook notification supportimplicitlyVaultedPaymentMethodToken and implicitlyVaultedPaymentMethodGlobalId to LocalPaymentDetailsAdd MerchantTokenIdentifier, SourceCardLast4 to ApplePayCard and ApplePayDetails
MerchantTokenIdentifier, SourceCardLast4 to ApplePayCard and ApplePayDetailsThreeDSecureAuthenticationId to CustomerRequest and PaymentMethodRequestprocessing_overrides to Transaction.sale optionsTransactionRequest
ArrivalDateTicketIssuerAddressbyte[] to String content conversion for requests containing files in BraintreeServiceAdd MerchantAdviceCode and MerchantAdviceCodeText to Transaction
MerchantAdviceCode and MerchantAdviceCodeText to TransactioncardAddChallengeRequested to ThreeDSecureLookupRequestRetryIds and RetriedTransactionId to TransactionAdd subscriptions for SEPA direct debit account
ThreeDSecureLookupRequest
BrowserAcceptHeaderBrowserColorDepthBrowserJavaEnabledBrowserJavascriptEnabledBrowserLanguageBrowserScreenHeightBrowserScreenWidthBrowserTimeZoneDeviceChannelIpAddressUserAgentAdd IntendedTransactionSource to CreditCardVerificationRequest
IntendedTransactionSource to CreditCardVerificationRequestPaymentMethodNonce to CreditCardVerificationRequestThreeDSecureAuthenticationID to CreditCardVerificationRequestThreeDSecurePassThru to CreditCardVerificationRequestAddOns and DiscountsBump Newtonsoft.Json from 9.0.1 to 13.0.1
PreDisputeProgram to Dispute and DisputeSearchRequestAUTO_ACCEPTED to DisputeStatusDISPUTE_AUTO_ACCEPTED to WebhookKindEXCESSIVE_RETRY to GatewayRejectionReasonSepaDirectDebitAccount payment methodSepaDirectDebitAccountDetails and SepaDirectDebitReturnCode to transaction objectSepaDebitPayPalV2OrderId to transaction search request objectMandateType enum to payment method nonce details objectSEPA_DIRECT_DEBIT_ACCOUNT to payment instrument typePaymentMethodNonceDetailsSepaDirectDebit to payment method nonce detailsRequestedExemptionType to ThreeDSecureLookupRequestDeprecate ChargebackProtectionLevel and add ProtectionLevel to Dispute and DisputeSearch
ChargebackProtectionLevel and add ProtectionLevel to Dispute and DisputeSearchAdd AchReturnResponsesCreatedAt to TransactionSearchRequest to search for specific date for transaction that have any reason codes.
AchReturnResponsesCreatedAt to TransactionSearchRequest to search for specific date for transaction that have any reason codes.ReasonCode to TransactionSearchRequest to search for transactions that have return reason codes.TransactionSearchRequest.ANY_REASON_CODE to TransactionSearchRequest for reason code search that matches all reason codes.LiabilityShift to RiskDataAdd AchReturnCode to transaction object
AchReturnCode to transaction objectRetried to transaction objectAdd PaymentMethodCustomerDataUpdated webhook notification support
PaymentMethodCustomerDataUpdated webhook notification supportAdd plan create/update/find API endpoint
TransactionReview webhook notification supportAdd LocalPaymentExpired and LocalPaymentFunded webhook notification support
LocalPaymentExpired and LocalPaymentFunded webhook notification supportAdd error code TRANSACTION_TAX_AMOUNT_IS_REQUIRED_FOR_AIB_SWEDISH for attribute tax_amount in transaction key for AIB:Domestic Transactions in Sweden
TRANSACTION_TAX_AMOUNT_IS_REQUIRED_FOR_AIB_SWEDISH for attribute tax_amount in transaction key for AIB:Domestic Transactions in SwedenExchangeRateQuoteId to TransactionRequestEXCHANGE_RATE_QUOTE_ID_IS_TOO_LONG to ValidationErrorCodeAndroidPayCard and ApplePayCard:
CommercialDebitDurbinRegulatedHealthcarePayrollPrepaidProductIdCountryOfIssuanceIssuingBankPaypalDetails:
TaxIdTaxIdTypeAdd PaymentReaderCardDetails to TransactionCreditCardRequest
PaymentReaderCardDetails to TransactionCreditCardRequestSkipAdvancedFraudChecking to:
Customer.create and Customer.updateCreditCard.create and CreditCard.updatePaymentMethod.create and PaymentMethod.updateDataOnlyRequested to ThreeDSecureLookupRequestChargebackProtectionLevel to DisputeSearchAdd TaxIdentifiers to CustomerRequest
PayPalMessages to DisputeTaxIdentifiers to CustomerRequestGrantedPaymentMethodRevokedAdd StoreId and StoreIds to TransactionSearchRequest
StoreId and StoreIds to TransactionSearchRequestLocalPaymentReversed webhook notificationsTransaction.AdjustAuthorization method to support for multiple authorizations for a single transactionMerchantAccountId to TransactionRefundRequestPhoneNumber to Address (thanks @glennsdavis!)Add missing ExpirationMonth, ExpirationYear, and IsNetworkTokenized fields in PaymentMethodNonceDetails (thanks @glennsdavis for ExpirationMonth and E
ExpirationMonth, ExpirationYear, and IsNetworkTokenized fields in PaymentMethodNonceDetails (thanks @glennsdavis for ExpirationMonth and ExpirationYear!)ThreeDSecureAuthenticationInfo and ThreeDSecureLookupInfo classesAcsTransactionId, ParesStatus, ThreeDSecureTransactionId, Lookup, and Authentication to ThreeDSecureInfoDecisionReasons and TransactionRiskScore fields to RiskDataSubmitForSettlementAsync method to include TransactionRequest (thanks @edtyl3r!)Deprecate DeviceSessionId and FraudMerchantId in the CreditCardRequest and TransactionRequest classes
scaExemption to TransactionDeviceSessionId and FraudMerchantId in the CreditCardRequest and TransactionRequest classescurrencyIsoCode field to TransactionRequestverificationCurrencyIsoCode field to CreditCardOptionsRequest and PaymentMethodOptionsRequestCREDIT_CARD_OPTIONS_VERIFICATION_INVALID_PRESENTMENT_CURRENCYTRANSACTION_INVALID_PRESENTMENT_CURRENCYInstallments to TransactionRequestCount to InstallmentRequestInstallments and RefundedInstallments to TransactionAdjustment to InstallmentDeprecate Recurring in TransactionRequest
AcquirerReferenceNumber to TransactionBillingAgreementId to PayPalDetailsextensions to GraphQLResponseRecurring in TransactionRequestAdd InstallmentCount to DisputeTransaction on dispute webhooks
InstallmentCount to DisputeTransaction on dispute webhooksImplicitlyVaultedPaymentMethodToken and ImplicitlyVaultedPaymentMethodGlobalId to PayPalDetailsAdd isNetworkTokenized to CreditCard Breaking changes:
RequestTimeoutException and GatewayTimeoutExceptionRISK_THRESHOLD to GatewayRejectionReason constantsprocessedWithNetworkToken to TransactionisNetworkTokenized to CreditCard
Breaking changes:TargetFrameworksTransparentRedirect, iDEAL, Coinbase, and IbanAccount classesForwardedComments from DisputePayPalVaultWithoutUpgrade from PaymentMethodRequestSEPA_BANK_ACCOUNT_ACCOUNT_HOLDER_NAME_IS_REQUIREDSEPA_BANK_ACCOUNT_BIC_IS_REQUIREDSEPA_BANK_ACCOUNT_IBAN_IS_REQUIREDSEPA_MANDATE_ACCOUNT_HOLDER_NAME_IS_REQUIREDSEPA_MANDATE_BIC_INVALID_CHARACTERSEPA_MANDATE_BIC_IS_REQUIREDSEPA_MANDATE_BIC_LENGTH_IS_INVALIDSEPA_MANDATE_BIC_UNSUPPORTED_COUNTRYSEPA_MANDATE_BILLING_ADDRESS_CONFLICTSEPA_MANDATE_BILLING_ADDRESS_ID_IS_INVALIDSEPA_MANDATE_IBAN_INVALID_CHARACTERSEPA_MANDATE_IBAN_INVALID_FORMATSEPA_MANDATE_IBAN_IS_REQUIREDSEPA_MANDATE_IBAN_UNSUPPORTED_COUNTRYSEPA_MANDATE_LOCALE_IS_UNSUPPORTEDSEPA_MANDATE_TYPE_IS_REQUIREDTRANSACTION_AMOUNT_DOES_NOT_MATCH_IDEAL_PAYMENT_AMOUNTTRANSACTION_IDEAL_PAYMENT_NOT_COMPLETETRANSACTION_IDEAL_PAYMENTS_CANNOT_BE_VAULTEDTRANSACTION_MERCHANT_ACCOUNT_DOES_NOT_MATCH_IDEAL_PAYMENT_MERCHANT_ACCOUNTTRANSACTION_ORDER_ID_DOES_NOT_MATCH_IDEAL_PAYMENT_ORDER_IDTRANSACTION_ORDER_ID_IS_REQUIRED_WITH_IDEAL_PAYMENTGRANTED_PAYMENT_INSTRUMENT_UPDATEIDEAL_PAYMENT_COMPLETEIDEAL_PAYMENT_FAILEDDownForMaintenanceException to ServiceUnavailableExceptionUnexpectedException instead of DownForMaintenance when search response yields unexpected resultsUseStaticHttpClient configuration option for .NET Core integrationsMasterpassCard payment methodAmexExpressCheckoutCard payment methodEnumeration subclasses to C# Enum types (fixes #86):
CreditCardCardType (additionally, type MASTER_CARD was renamed to MASTERCARD)CreditCardCommercialCreditCardCustomerLocationCreditCardDebitCreditCardDurbinRegulatedCreditCardHealthcareCreditCardPayrollCreditCardPrepaidDisbursementTypeDisputeKindDisputeReasonDisputeStatusDocumentUploadKindFundingDestinationIndustryDataAdditionalChargeKindMerchantAccountStatusPaymentInstrumentTypePlanDurationUnitProcessorResponseTypeShippingMethodSubscriptionDurationUnitSubscriptionSourceSubscriptionStatusTransactionCreatedUsingTransactionEscrowStatusTransactionGatewayRejectionReasonTransactionIndustryTypeTransactionLineItemKindTransactionSourceTransactionStatusTransactionTypeUsBankAccountVerificationMethodUsBankAccountVerificationStatusVerificationStatusWebhookKindNothing published for this version
Add ThreeDSecurePassThru to CreditCard.create(), CreditCard.update(), Customer.create(), Customer.update(), PaymentMethod.create() and PaymentMethod.u
ThreeDSecurePassThru to CreditCard.create(), CreditCard.update(), Customer.create(), Customer.update(), PaymentMethod.create() and PaymentMethod.update()AuthenticationIdsDISPUTE_ACCEPTED, DISPUTE_DISPUTED, and DISPUTE_EXPIRED webhook constantsPaymentMethodNonce.CreateDOCUMENT_UPLOAD_FILE_IS_EMPTY error codeRetrievalReferenceNumber to TransactionExpect:100-Continue header from requests to stop sporadic failed requests.FromNonceAsync method to CreditCardGateway (#97 thanks @ronnieoverby)NetworkTransactionId to CreditCardVerificationProductSku to TransactionRequestPhoneNumber and ShippingMethod to AddressRequestCustomerDeviceId, CustomerLocationZip, and CustomerTenure to RiskDataRequestTRANSACTION_PRODUCT_SKU_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_LONGAdd RefundAuthHardDeclined and RefundAuthSoftDeclined to validation errors
RefundAuthHardDeclined and RefundAuthSoftDeclined to validation errorsPROCESSOR_DOES_NOT_SUPPORT_MOTO_FOR_CARD_TYPE to validation errorsisNetworkTokenized to AndroidPayCard and AndroidPayDetailsCreditCardVerification, Customer, Dispute, and TransactionThreeDSecureAuthenticationId to ThreeDSecureInfoThreeDSecureAuthenticationId support to Transaction.SaleAdd ProcessorComments to Disputes
ProcessorComments to DisputesForwardedCommentsAMOUNT_NOT_SUPPORTED_BY_PROCESSOR to validation errors- Add ThreeDSecureLookup (beta)
ThreeDSecureLookup (beta)Add GraphQLClient instance to BraintreeGateway class
GraphQLClient instance to BraintreeGateway classAdd PayPalHereDetails to transactions
PayPalHereDetails to transactionsCaptureId to LocalPaymentDetailsRefundId to LocalPaymentDetailsDebugId to LocalPaymentDetailsRefundFromTransactionFeeAmount to LocalPaymentDetailsRefundFromTransactionFeeCurrencyIsoCode to LocalPaymentDetailsTransactionFeeAmount to LocalPaymentDetailsTransactionFeeCurrencyIsoCode to LocalPaymentDetailsCavv, Xid, DsTransactionId, EciFlag, and ThreeDSecureVersion to ThreeDSecureInfoThreeDSecureVersion, AuthenticationResponse, DirectoryResponse, CavvAlgorithm, and DsTransactionId to 3DS pass thru fieldsPayerInfo to PaymentMethodNonceDetails classNetworkResponseCode and NetworkResponseText fields to Transaction and CreditCardVerificationThreeDSecureInfo to CreditCardVerificationAdd token_issuance gateway rejected status to support Venmo transactions
token_issuance gateway rejected status to support Venmo transactionspayment_method_nonce field to LocalPaymentCompleted webhooktransaction field to LocalPaymentCompleted webhookLocalPaymentDetails to transactionsRoomTax field to IndustryDataRequestNoShow field to IndustryDataRequestAdvancedDeposit field to IndustryDataRequestFireSafe field to IndustryDataRequestPropertyPhone field to IndustryDataRequestAdditionalChargeRequest class and add AdditionalCharges field to IndustryDataRequestPostalCodeIsRequiredForCardBrandAndProcessor to validation errorsRefundFromTransactionFeeAmount field to PayPalDetailsRefundFromTransactionFeeCurrencyIsoCode field to PayPalDetailsRevokedAt field to PayPalAccountPAYMENT_METHOD_REVOKED_BY_CUSTOMER webhookAdd AccountType field to Transaction, CreditCard, PaymentMethod, and CreditCardVerification
AccountType field to Transaction, CreditCard, PaymentMethod, and CreditCardVerificationRefundFromTransactionFeeAmount field to PayPalDetailsRefundFromTransactionFeeCurrencyIsoCode field to PayPalDetailsRevokedAt field to PayPalAccountPAYMENT_METHOD_REVOKED_BY_CUSTOMER webhookResolve an issue with PackageReleaseNotes in Braintree.csproj that prevented building the project
PackageReleaseNotes in Braintree.csproj that prevented building the projectAdd Error indicating pdf uploads too long for dispute evidence.
bin field to PaymentMethodNonceDetailsGrantedPaymentMethodRevoked webhook response objectsUsername and VenmoUserId to PaymentMethodNonceDetails.Allow PayPal payment ID and payer ID to be passed during transaction create
travel_flight support to industry-specific datafraudServiceProvider field to RiskDataUseStaticHttpClient to configuration to reuse the same http client instance in each requestAdd AuthorizationExpiresAt to Transaction
AuthorizationExpiresAt to TransactionProcessorResponseType to Transaction, AuthorizationAdjustment, and CreditCardVerificationAllow environemnt parsing to be case insensitive
LastFour to PaymentMethodNonceDetailsnetwork_transaction_id as new field on subfield transaction response.ExternalVaultRequest for TransactionRequestLocalPaymentCompleted webhook notifications.Add processor_response_code and processor_response_text to authorization adjustments subfield in transaction response.
processor_response_code and processor_response_text to authorization adjustments subfield in transaction response.Add MerchantId to ConnectedMerchantStatusTransitioned and ConnectedMerchantPayPalStatusChanged, and OauthApplicationClientId to OAuthAccessRevocation
MerchantId to ConnectedMerchantStatusTransitioned and ConnectedMerchantPayPalStatusChanged, and OauthApplicationClientId to OAuthAccessRevocation webhooksamount-won and amount-disputedFix CreditCard not correctly identifying Union Pay card type
Add support for US Bank Account verifications API
Your coding agent can read these notes before it upgrades. Set up the MCP server →