All

<span>All Validation Errors</span>

All Validation ErrorsAnchorIcon

Account Funding TransactionAnchorIcon

CodeTextExplanation
97501Transfer type is invalid.

Transfer type is invalid.

97502Sender tax ID is not valid.

should only contain letters and numbers and cannot exceed 14 characters.

97503Sender first name is not valid.

Only alphanumeric characters and spaces allowed. Can be 1-255 characters long.

97504Sender last name is not valid.

Only alphanumeric characters and spaces allowed. Can be 1-255 characters long.

97505Sender account reference number is not valid.

Must contain only numeric characters and be 1-50 characters long.

97506Receiver tax ID is not valid.

should only contain letters and numbers and cannot exceed 14 characters.

97507Receiver first name is not valid.

Only alphanumeric characters and spaces allowed. Can be 1-255 characters long.

97508Receiver last name is not valid.

Only alphanumeric characters and spaces allowed. Can be 1-255 characters long.

97509Receiver account reference number is not valid.

Must contain only numeric characters and be 1-50 characters long.

97510Transfer details are required for this merchant account.

Transfer details are required for this merchant account.

97511Transfer details are not applicable for this merchant account.

Transfer details are not applicable for this merchant account.

97512The specified transfer type is not supported.

The specified transfer type is not supported.

Industry Data Additional ChargesAnchorIcon

CodeTextExplanation
96601Charge kind is invalid.

Charge kind must be one of `mini_bar`, `restaurant`, `gift_shop`, `telephone`, `laundry`, or `other`.

96602Charge kinds must be unique.

Only one additional charge can exist per kind.

96603Charge amount must be greater than zero.

The amount for the charge must be an amount greater than 0.00.

96604Charge amount format is invalid.

Charge amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the tax amount can't include decimal places.

96605Charge amount is too large.

Charge amount can't be longer than 9 digits.

96606Charge amount is required.

A charge amount must be set if an additional charge is specified.

AddressAnchorIcon

CodeTextExplanation
81801Addresses must have at least one field filled in.

At least one of the address attributes must be present, but it doesn't matter which one. This doesn't apply when creating transactions—billing and shipping address can be blank unless [AVS processing rules](/articles/guides/fraud-tools/basic/avs-cvv-rules) are configured to require billing street and postal.

81802Company is too long.

Maximum 255 characters.

81804Extended address is too long.

Maximum 255 characters.

81805First name is too long.

Maximum 255 characters.

81806Last name is too long.

Maximum 255 characters.

81807Locality is too long.

Maximum 255 characters.

81813Postal code can only contain letters, numbers, spaces, and hyphens.

Postal code must begin with a letter or number, and can only contain letters, numbers, spaces, and hyphens.

81808Postal code is required.

Applies when AVS rules are configured to require postal code.

81809Postal code may contain no more than 9 letter or number characters.

The length only applies to letters or numbers; it ignores spaces, hyphens, and all other special characters.

81810Region is too long.

Maximum 255 characters.

81811Street address is required.

Applies when creating a transaction or performing card verification when AVS rules are configured to require street address.

81812Street address is too long.

Maximum 255 characters.

81827US state codes must be two characters to meet PayPal Seller Protection requirements.

US state codes must be two characters to meet PayPal Seller Protection requirements.

81828Postal code is required for the card type and processor.

The processor you are using requires a postal code to be included for transactions on this card brand.

81829Billing address could not be deleted as it is associated to a vaulted payment instrument.

Address is a billing address.

81830International phone country code is invalid.

International phone country code needs to be 1-3 digits.

81831International phone national number is invalid.

International phone national number needs to be 4-12 digits.

91803Country name is not an accepted country.

We only accept [specific country names](/reference/general/countries).

91815Provided country information is inconsistent.

You can only specify one of country name, country code alpha2, country code alpha3 and country code numeric.

91816Country code (alpha3) is not an accepted country.

We only accept [specific alpha-3 values](/reference/general/countries#list-of-countries).

91817Country code (numeric) is not an accepted country.

We only accept [specific numeric values](/reference/general/countries#list-of-countries).

91814Country code (alpha2) is not an accepted country.

We only accept [specific alpha-2 values](/reference/general/countries#list-of-countries).

91818Customer has already reached the maximum of 50 addresses.

You will get this validation error when trying to add an address to a customer which has already reached the maximum of 50 addresses.

91819First name must be a string.

First name must be a string.

91820Last name must be a string.

Last name must be a string.

91821Company must be a string.

Company must be a string.

91822Street address must be a string.

Street address must be a string.

91823Extended address must be a string.

Extended address must be a string.

91824Locality must be a string.

Locality must be a string.

91825Region must be a string.

Region must be a string.

91826Postal code must be a string.

Postal code must be a string.

91828Address is invalid.

Address must provided in a [valid format](/reference/request/address/create).

Android Pay CardAnchorIcon

CodeTextExplanation
83701Expiration month is required.

Expiration month is required.

83703Virtual card number is required.

Virtual card number is required.

83704Virtual card number failed Luhn validation.

Virtual card number failed Luhn validation.

83705Google transaction ID is required.

Google transaction ID is required.

83706Source card type is required.

Source card type is required.

83707Source card last four is required.

Source card last four is required.

83708Android Pay cards are not accepted by this merchant account.

Android Pay cards are not accepted by this merchant account.

83709Customer ID is required.

Customer ID is required.

93710Token is taken.

Token is taken.

93712Cannot use a payment_method_nonce more than once.

Cannot use a payment_method_nonce more than once.

83713Customer ID is invalid.

Customer ID is invalid.

83714Virtual card type not accepted by this merchant account.

Virtual card type not accepted by this merchant account.

83715Billing address fields not supported for Android Pay cards.

Billing address fields not supported for Android Pay cards.

83716Number must be 12-19 digits.

Number must be 12-19 digits.

83717Number is not an accepted test number.

Number is not an accepted test number.

83718International issued Android Pay cards not supported.

International issued Android Pay cards not supported.

93719Billing Address format is invalid.

Billing Address format is invalid.

93720Expiration month is invalid.

It must be 1-12 or 01-12.

93721Expiration year is invalid.

The expiration year must be greater than 1975 and less than 2201.

Android Pay Network TokenAnchorIcon

CodeTextExplanation
83901Expiration month is required.

Expiration month is required.

83902Expiration year is required.

Expiration year is required.

83903Number is required.

Number is required.

83904Number failed Luhn validation.

Number failed Luhn validation.

83905Google transaction ID is required.

Google transaction ID is required.

83906Source card type is required.

Source card type is required.

83907Source card last four is required.

Source card last four is required.

83908Android Pay network tokens are not accepted by this merchant account.

Android Pay network tokens are not accepted by this merchant account.

83909Customer ID is required.

Customer ID is required.

93910Token is taken.

Token is taken.

93912Cannot use a payment_method_nonce more than once.

Cannot use a payment_method_nonce more than once.

83913Customer ID is invalid.

Customer ID is invalid.

83914Virtual card type not accepted by this merchant account.

Virtual card type not accepted by this merchant account.

83915Billing address fields not supported for Android Pay network tokens.

Billing address fields not supported for Android Pay network tokens.

83916Cryptogram is required.

Cryptogram is required.

83917Number must be 12-19 digits.

Number must be 12-19 digits.

83918Number is not an accepted test number.

Number is not an accepted test number.

83919Card brand is not supported for Android Pay Network Token payments.

The card brand provided does not support Android Pay Network Token payments.

83920International issued Android Pay network tokens not supported.

International issued Android Pay network tokens not supported.

93921Billing Address format is invalid.

Billing Address format is invalid.

93922Expiration month is invalid.

It must be 1-12 or 01-12.

93923Expiration year is invalid.

The expiration year must be greater than 1975 and less than 2201.

Apple PayAnchorIcon

CodeTextExplanation
83501Apple Pay cards are not accepted by this merchant account.

Apple Pay cards are not accepted by this merchant account.

83502A customer ID is required to vault an Apple Pay Card.

When storing an Apple Pay card in the vault, you must provide the customer ID of a customer already stored in the vault to whom the card will belong.

93503Apple Pay token is taken.

Payment method tokens must be unique across all payment method types.

93504Cannot use a payment_method_nonce more than once.

The [payment method nonce](/guides/payment-method-nonces) has already been used.

93505Unknown or expired payment_method_nonce.

The [payment method nonce](/guides/payment-method-nonces) has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

93506Payment method nonce locked.

**Deprecated**
The [payment method nonce](/guides/payment-method-nonces) must be unlocked before it is used.

83518Credit card type is not accepted by this merchant account.

The specified merchant account is not configured to accept cards from this payment network. Please specify the correct payment networks when initializing a PKPaymentRequest.

93507Payment method nonces cannot be used to update an existing Apple Pay Card.

A vaulted payment method cannot be updated with an Apple Pay nonce. Create a new payment method instead.

93508Number is required for Apple Pay Card

The Apple Pay `PKPaymentToken` payment data was malformed (did not contain a card number).

93509Expiration Month is required for Apple Pay Card

The Apple Pay `PKPaymentToken` payment data was malformed (did not contain an expiration month).

93510Expiration Year is required for Apple Pay Card

The Apple Pay `PKPaymentToken` payment data was malformed (did not contain an expiration year).

93511Cryptogram is required for Apple Pay Card

The Apple Pay `PKPaymentToken` payment data was malformed (did not contain a cryptogram). This is sometimes caused by misconfigured `merchantCapabilities` in the `PKPaymentRequest`. See [our recommendations](/guides/apple-pay/client-side#create-a-pkpaymentrequest) in the Apple Pay guide.

83512Apple Pay payment data decryption failed

The Apple Pay `PKPaymentToken` payment data could not be decrypted. This occurs when (a) the Apple Pay merchant id used in your iOS App entitlements does not match the values provided to Braintree; (b) the provisioning profile you used to sign your iOS App does not correspond to the iOS Developer Account with which the Apple Pay certificate was generated; (c) the payment data was not valid as it was received by the Gateway. [Contact us](/help?issue=acceptPaymentTypes) if you cannot resolve this error.

93513Apple Pay is disabled for this merchant

Your merchant account is not configured for Apple Pay support. [Contact us](/help?issue=acceptPaymentTypes) to configure and enable Apple Pay.

93514Apple Pay certificate, private key or merchant ID not configured

Your merchant account is not configured for Apple Pay support. [Contact us](/help?issue=acceptPaymentTypes) to configure and enable Apple Pay.

93517Certificate provided is not valid

Certificate provided is not valid.

93519Public key used to sign payment data does not match stored certificate

Public key used to sign payment data does not match stored certificate.

83520Payment data is malformed

Payment data is malformed.

93521Private key stored does not match private key used to encrypt payment data

Private key stored does not match private key used to encrypt payment data.

93522Certificate does not match stored key pair

The Apple Pay certificate you uploaded does not match the key pair we have stored for your account. Please download a new CSR from the Control Panel and create a new certificate for your Apple Pay merchant ID using this CSR.

93523Domain name is required.

You must specify a domain name.

93524An error occurred when validating your domain with Apple.

An error occurred when validating your domain with Apple. Please try again.

93525Domain verification with Apple failed. Please verify the file is available at the verification path and try again.

Domain verification with Apple failed. Please verify the file is available at the verification path and try again.

93526There was an issue contacting Apple, please try again later.

There was an issue contacting Apple, please try again later.

83527International issued Apple Pay cards not supported.

International issued Apple Pay cards not supported.

93528Customer ID is invalid.

Customer ID is invalid.

93529Billing Address format is invalid.

Billing Address format is invalid.

93530Expiration month is invalid.

It must be 1-12 or 01-12.

93531Expiration year is invalid.

The expiration year must be greater than 1975 and less than 2201.

Authorization AdjustmentAnchorIcon

CodeTextExplanation
95601Transaction must be submitted for settlement for the authorized amount.

Transaction cannot be adjusted and must be submitted for settlement for the authorized amount.

95602Failed to submit for settlement for an amount different than the authorized amount. Please submit for the authorized amount.

By submitting an amount other than the authorized amount, an adjustment needed to be performed on the transaction. This adjustment resulted in a hard decline and should not be retried.

95603Failed to submit for settlement for an amount different than the authorized amount. Please try again at a later time.

By submitting an amount other than the authorized amount, an adjustment needed to be performed on the transaction. This adjustment resulted in a soft decline and can be retried.

95604Failed to submit for settlement for an amount different than the authorized amount too many times. Please submit for the authorized amount.

**Deprecated**
By submitting an amount other than the authorized amount, an adjustment needed to be performed on the transaction. This adjustment has resulted in too many failures. Please try again later or submit for the authorized amount.

95605Amount submitted for adjust authorization must be greater than zero.

Amount submitted for adjust authorization must be greater than zero.

95606Adjustment amount should not be same as adjusted amount authorized.

Adjustment amount should not be same as adjusted amount authorized

95607Failed to adjust authorization for amount submitted.

The authorization adjustment failed. The adjustment resulted in a hard decline and should not be retried.

95608Failed to adjust authorization for amount submitted. Please try again at a later time.

The authorization adjustment failed. The adjustment resulted in a soft decline and can be retried.

Client TokenAnchorIcon

CodeTextExplanation
92801Cannot specify make_default without a customer_id

Cannot specify make_default without a customer_id

92802Cannot specify verify_card without a customer_id

Cannot specify verify_card without a customer_id

92803Cannot specify fail_on_duplicate_payment_method without a customer_id

Cannot specify fail_on_duplicate_payment_method without a customer_id

92804Customer specified by customer_id does not exist

Customer specified by customer_id does not exist

92805Cannot specify fail_on_duplicate_payment_method_for_customer without a customer_id

Cannot specify fail_on_duplicate_payment_method_for_customer without a customer_id

92806Unsupported client token version

Unsupported client token version

92808Cannot specify more than 5 client token domains

Cannot specify more than 5 client token domains

92809Client token domains must be valid domain names (RFC 1035), e.g. example.com

Client token domains must be valid domain names (RFC 1035), e.g. example.com

Credit cardAnchorIcon

CodeTextExplanation
91701Cannot provide both a billing address and a billing address ID.

When you create or update a credit card you can set the billing address using full billing address details, or you can set it to a billing address ID of an address already associated to the customer, but not both.

91702Billing address ID is invalid.

If setting the billing address on a credit card using an ID, the ID must be an ID of an address associated to the customer.

91704Customer ID is required.

When adding a credit card to an existing customer, the customer ID is required.

91705Customer ID is invalid.

When specifying the customer ID to add a credit card to an existing customer, the ID must be the ID a customer stored in the Vault.

91708Cannot provide expiration_date if you are also providing expiration_month and expiration_year.

You can provide the credit card expiration date as a single field, or as month and year separately, but not all 3.

91718Token is invalid (use only letters, numbers, '-', and '_').

If you're specifying the credit card token, you can use letters, numbers, '-', and '_'.

91719Credit card token is taken.

Credit card tokens have to be unique.

91720Credit card token is too long.

Maximum 36 characters.

91721Token is not an allowed token.

We reserve a few tokens: 'new' and 'all'.

91722Payment Method token is required.

When updating a credit card you can omit the token if you don't want to change it, but you can't set it to an empty string. If set to an empty string on creation, the gateway will generate a random token.

91744Billing address format is invalid.

Billing address format is invalid.

81723Cardholder name is too long.

Maximum 175 characters.

81703Credit card type is not accepted by this merchant account.

Applies when specifying a credit card in a sale or verification request. Not applicable when only storing in the Vault, since Vault records are not associated to specific merchant accounts.

81718Credit card number cannot be updated to an unsupported card type when it is associated to subscriptions.

Only applies when using recurring billing. If a credit card is being used for recurring billing subscriptions, the card can only be updated to a card type that is accepted by the merchant account that is being used for the subscriptions.

81706CVV is required.

CVV will only be required if CVV processing rules are configured to require it. If the rules are configured to require it, then CVV is required when storing a card in the Vault and performing card verification or when creating transactions.

81707CVV must be 4 digits for American Express and 3 digits for other card types.

CVV must be 4 digits for American Express and 3 digits for other card types.

81709Expiration date is required.

You must provide the expiration date either as a single field or as month and year separately.

81710Expiration date is invalid.

Valid formats are M/YY, M/YYYY, MM/YY, and MM/YYYY. The month must be 1-12 or 01-12.

81711Expiration year is invalid. It must be between 1975 and 2201.

The expiration year must be greater than 1975 and less than 2201.

81712Expiration month is invalid.

It must be 1-12 or 01-12.

81713Expiration year is invalid.

It must be between 1975 and 2201.

81714Credit card number is required.

You'll get this error if number is omitted or if it is an empty string.

81715Credit card number is invalid.

The credit card number must pass a Luhn-10 check.

81716Credit card number must be 12-19 digits.

Inclusive.

81717Credit card number is not an accepted test number.

Only [test numbers](/reference/general/testing#credit-card-numbers) can be used in the sandbox.

91723Update Existing Token is invalid.

Applies when [updating a customer and credit card](/reference/request/customer/update#update-customer-and-existing-credit-card) at the same time and specifying the token of the credit card to update. You'll get this error if the token specified is for a credit card that does not exist, or references a credit card that does not belong to the customer that is being updated.

81724Duplicate card exists in the vault.

Duplicate card exists in the vault.

81725Credit card must include number, payment_method_nonce, or venmo_sdk_payment_method_code.

Credit card must include number, payment_method_nonce, or venmo_sdk_payment_method_code.

91728Verification Merchant Account ID is invalid.

There must be a merchant account with this ID.

91729Update Existing Token is not allowed when creating a customer.

Update Existing Token is not allowed when creating a customer.

91730Verifications are not supported on this merchant account

This error occurs when a merchant account does not support credit card verification. This can also occur if your [API user](/articles/control-panel/important-gateway-credentials#api-credentials) does not have access to the merchant account used for the verification.

91731Cannot use a payment_method_nonce more than once.

The [payment method nonce](/guides/payment-method-nonces) has already been used once.

91732Unknown or expired payment_method_nonce.

The [payment method nonce](/guides/payment-method-nonces) has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

91733Payment method nonce locked.

**Deprecated**
The [payment method nonce](/guides/payment-method-nonces) must be unlocked before it is used.

91734Credit card type is not accepted by this merchant account.

Applies when specifying a credit card when creating a transaction, but not when only storing in the Vault since Vault records are not associated to specific merchant accounts.

91735Payment method nonces cannot be used to update an existing card.

A [payment method nonce](/guides/payment-method-nonces) cannot be used to update an existing credit card.

91738Payment method is not a credit card payment method.

This operation requires a credit card, and the payment method you specified is not a credit card.

91742Verification Merchant Account is suspended.

Verification Merchant Account is suspended.

91743The current user does not have access to the specified verification_merchant_account_id

The current user does not have access to the specified verification_merchant_account_id.

81736CVV verification failed.

CVV was incorrect or not supplied.

81737Postal code verification failed.

Postal code was incorrect or not supplied.

91739Verification amount cannot be negative.

The amount you specified for verification was less than zero.

91740Verification amount is invalid.

The amount you specified for verification had an invalid format.

91741Verification amount not supported by processor.

The processor you are using for verification does not allow the verification amount you specified.

91745Payment method params supplied are not valid for updating a credit card.

The payment method params you supplied are not valid for updating a credit card.

81750Credit card number is prohibited.

Cannot transact with an issuer on OFAC's prohibited list.

91752Verification amount is too large.

Verification amount is too large.

91755Verification Merchant Account ID cannot be a sub-merchant account.

Verifications cannot be created using sub-merchant accounts.

91756Customer ID cannot be updated.

Customer ID cannot be updated.

91759Magstripe details for a credit card must contain at least one of track 1 or track 2 data.

Magstripe details for a credit card must contain at least one of track 1 or track 2 data.

91761EMV data is invalid.

EMV data is invalid.

81762Credit card network tokenization attributes cryptogram is required.

You get this error if cryptogram is missing from the network tokenization attributes on a customer-initiated network token transaction.

81763Duplicate card exists in the vault for the customer.

Duplicate card exists in the vault for the customer.

81764Duplicate check for customer credit cards cannot be used when a customer has > 100 vaulted credit cards.

Duplicate check for customer credit cards cannot be used when a customer has > 100 vaulted credit cards.

CustomerAnchorIcon

CodeTextExplanation
91602Custom field is invalid:

Custom field keys must match the API name of a [custom field configured in the Control Panel](/articles/control-panel/custom-fields). The error message for this validation error will contain a list of the invalid keys.

91609Customer ID has already been taken.

Customer IDs have to be unique.

91610Customer ID is invalid (use only letters, numbers, '-', and '_').

Valid characters are letters, numbers, dashes, and underscores.

91611Customer ID is not an allowed ID.

We reserve a few words that can't be used as IDs. 'all' and 'new' currently cannot be used.

91612Customer ID is too long.

Maximum 36 characters.

91613Customer ID is required.

Customer ID is required when performing updates.

91617Nonce references a vaulted payment instrument - cannot be transferred between customers

Nonce references a vaulted payment instrument - cannot be transferred between customers.

91618Customer attribute must be a map of keys and values representing a customer.

Customer must be a well-formed object, not a string or integer.

91619Ambiguous usage of default payment method token.

Cannot set {{linkToReferenceRequest 'customer' 'update' param='default_payment_method_token'}} and {{linkToReferenceRequest 'customer' 'update' param='credit_card.options.make_default'}} in the same customer update request.

91620PayPal custom field must be less than 256 characters in length.

Maximum 255 characters.

91621PayPal description must be less than 256 characters in length.

Maximum 255 characters.

91622Order ID must be less than 256 characters in length.

Maximum 255 characters.

91623Amount format is invalid.

Amount must be formatted like '10' or '10.00'.

81601Company is too long.

Maximum 255 characters.

81603Custom field is too long:

Custom field values must be less than or equal to 255 characters. The error message for this validation error will contain a list of the custom fields that were too long.

81604Email is an invalid format.

Email must be a well-formed email address. If you are migrating from a system that does not have this constraint and want to record the email address in the Vault, you can use {{linkToReferenceRequest 'customer' 'create' param='custom_fields'}}

81605Email is too long.

Maximum 254 characters.

81606Email is required if sending a receipt.

This only applies when creating a transaction. If you specify that you want to send a receipt then the customer email will be required.

81607Fax is too long.

Maximum 255 characters.

81608First name is too long.

Maximum 255 characters.

81613Last name is too long.

Maximum 255 characters.

81614Phone is too long.

Maximum 255 characters.

81615Website is too long.

Maximum 255 characters.

81616Website is an invalid format.

Website must be well-formed. The `http://` at the beginning is optional. If you want to provide websites that may be not well-formed you can use {{linkToReferenceRequest 'customer' 'create' param='custom_fields'}}

91625International phone country code is invalid.

International phone country code needs to be 1-3 digits.

91626International phone national number is invalid.

International phone national number needs to be 4-12 digits.

91624Invalid Tax Identifier.

Country code and Identfier should be valid and not null.

DescriptorAnchorIcon

CodeTextExplanation
92201Company name/DBA section is invalid.

The company/DBA name passed in your [descriptor](/reference/request/transaction/sale#descriptor) does not meet the requirements set by your processor.

92202Phone number is invalid.

Typically, phone must be 10 - 14 characters and can only contain numbers, dashes, parentheses and periods. Some example phone numbers are: * 3125556666 * 312-555-6666 * (312)555-6666
However, your processor may impact the number of characters or format accepted. [Contact us](/help?issue=updateDescriptor) for more information on your processor's specific requirements.

92203Dynamic descriptors have not been enabled for this account. Please contact support at https://help.braintreepayments.com.

Dynamic descriptors have not been enabled for this account. [Contact us](/help?issue=updateDescriptor).

92204Descriptor format is invalid.

Descriptor name must be less than or equal to 15 characters and can only contain letters and numbers. This will be prefixed by the preset company name for this account.

92205International phone number is invalid.

**Deprecated**
Phone can only contain numbers, dashes and periods and must be less than or equal to 13 characters.

92206URL must be 13 characters or shorter.

The url/web address to a customer's statement must be less than or equal to 13 characters.

DisputeAnchorIcon

CodeTextExplanation
95701Evidence can only be attached to disputes that are in an Open state

Evidence can only be attached to disputes that are in an Open state.

95702Evidence can only be removed from disputes that are in an Open state

Evidence can only be removed from disputes that are in an Open state.

95703A document with kind other than Braintree::DocumentUpload::Kind::EvidenceDocument cannot be added to the dispute

A document with kind other than Braintree::DocumentUpload::Kind::EvidenceDocument cannot be added to the dispute.

95704Disputes can only be accepted when they are in an Open state

Disputes can only be accepted when they are in an Open state.

95705Disputes can only be finalized when they are in an Open state

Disputes can only be finalized when they are in an Open state.

95706The category you supplied on the evidence record is not valid

Invalid category provided.

95707Categorized evidence for date time categories must be in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (e.g. YYYY-MM-DDTHH:MM:SSZ).

Invalid categorized evidence date provided.

95708Categorized text evidence must be 50 characters or less

Maximum 50 characters.

95709ARN text evidence must be 30 characters or less

Acquirer reference numbers/trace IDs must be a maximum of 30 characters.

95710Prior transaction phone number must be 20 characters or less

Maximum 20 characters.

95711Only text evidence can be provided for this category

Only text evidence can be provided for this category.

95712Only document evidence can be provided for this category

Only document evidence can be provided for this category.

95713Category cannot be provided for this dispute's reason code

Category cannot be provided for this dispute's reason code; see [Evidence Requirements in the Disputes guide](/guides/disputes/evidence-requirements#identifying-disputes-that-require-compelling-evidence) for more details.

95714Only one evidence record with this category may exist on the dispute

Only one evidence record with this category may exist on the dispute.

95715The email provided is not valid

The email provided is not valid.

95716This file already has been used on the dispute

This file has already been used as evidence on this dispute.

95717Submitting proof of delivery requires a valid AVS match

Submitting proof of delivery requires that the disputed transaction has a valid AVS postal code match (M); see [AVS and CVV Response Codes](/reference/general/processor-responses/avs-cvv-responses#response-postal-code-matches-m) for more details.

95720Digital goods responses require two types of additional proof

At least two types of evidence categories groups are required when responding with a `DOWNLOAD_DATE_TIME`; see [Evidence Requirements in the Disputes guide](/guides/disputes/evidence-requirements#identifying-disputes-that-require-compelling-evidence) for more details.

95721Digital goods responses require a download date

`DOWNLOAD_DATE_TIME` required when responding with any digital goods validation categories.

95722ARN required for prior transaction responses

When providing any prior transaction category responses you must provide the `PRIOR_NON_DISPUTED_TRANSACTION_ID` or `PRIOR_NON_DISPUTED_TRANSACTION_ARN`.

95723Date time required for prior transaction responses

When providing any prior transaction category responses you must provide the `PRIOR_NON_DISPUTED_TRANSACTION_DATE_TIME`.

95724Date time required for recurring transaction responses

`RECURRING_TRANSACTION_DATE_TIME` categorized evidence required when providing a `RECURRING_TRANSACTION_ID` or `RECURRING_TRANSACTION_ARN`.

95725ARN required for recurring transaction responses

`RECURRING_TRANSACTION_ID` or `RECURRING_TRANSACTION_ARN` categorized evidence required when providing a `RECURRING_TRANSACTION_DATE_TIME`.

95726Valid evidence must be added before finalizing the dispute

You must provide valid evidence for this dispute; see [Evidence Requirements in the Disputes guide](/guides/disputes/evidence-requirements#identifying-disputes-that-require-compelling-evidence) for more details.

95727Prior undisputed transaction responses require one or more optional evidence categories

You must provide at least one optional type of evidence when responding with a `PRIOR_NON_DISPUTED_TRANSACTION_ID` (or `PRIOR_NON_DISPUTED_TRANSACTION_ARN`) and `PRIOR_NON_DISPUTED_TRANSACTION_DATE_TIME`; see [Evidence Requirements in the Disputes guide](/guides/disputes/evidence-requirements#identifying-disputes-that-require-compelling-evidence) for more details.

95728Evidence cannot be submitted when the dispute has a protectionLevel of effortless

Evidence cannot be submitted when the dispute has a protectionLevel of effortless.

95729You cannot accept a dispute when the dispute has a `protectionLevel` of `effortless`.

You cannot accept a dispute when the dispute has a `protectionLevel` of `effortless`.

95730You cannot finalize a dispute when the dispute has a `protectionLevel` of `effortless`.

You cannot finalize a dispute when the dispute has a `protectionLevel` of `effortless`.

95735Both carrier name and tracking number are required

Both carrier name and tracking number are required

95736ARN text evidence must only include numbers

ARN text evidence must only include numbers.

95737ARN for prior transaction responses should not be the same as the disputed transaction’s ARN

ARN for prior transaction responses should not be the same as the disputed transaction’s ARN.

95738Date must be prior to dispute

Date must be prior to dispute.

95739Aggregate evidence file size for dispute exceeded

Aggregate evidence file size for dispute exceeded.

Marketplace Document UploadAnchorIcon

CodeTextExplanation
84901Document upload 'kind' must be 'identity_document'.

Document upload {{langCase "kind"}} must be {{langCase "identity_document"}}.

84902File size is limited to 4 MB.

File size is limited to 4 MB.

External TransactionAnchorIcon

CodeTextExplanation
810001Amount is required.

Amount is required.

810002Amount cannot be negative.

Amount cannot be negative.

810003Amount is an invalid format.

Amount is an invalid format.

810004Currency code is required

Currency code is required

810005Currency code is invalid.

Currency code is invalid.

810006Payment method token is invalid.

Payment method token is invalid.

810007Cannot provide both payment_method_token and customer_id unless the payment_method belongs to the customer.

Cannot provide both payment_method_token and customer_id unless the payment_method belongs to the customer.

Industry DataAnchorIcon

CodeTextExplanation
93401Industry type is invalid.

Industry type is invalid.

93402Lodging data is empty.

Lodging data is empty.

93403Folio number is invalid.

Folio number is invalid.

93404Check in date is invalid.

Check in date is invalid.

93405Check out date is invalid.

Check out date is invalid.

93406Check out date must occur after the check in date.

Check out date must occur after the check in date.

93407Data fields are unknown.

Data fields are unknown.

93408Travel and Cruise data is empty.

Travel and Cruise data is empty.

93409Data fields are unknown.

Data fields are unknown.

93410Travel Package is invalid.

Travel Package is invalid.

93411Departure date is invalid.

Departure date is invalid.

93412Lodging check in date is invalid.

Lodging check in date is invalid.

93413Lodging check out date is invalid.

Lodging check out date is invalid.

93414Travel and Flight data is empty.

Travel and Flight data is empty.

93415Data fields are unknown.

Data fields are unknown.

93416Customer code is too long.

Customer code can't be longer than 17 characters.

93417Fare amount cannot be negative.

Fare amount can't be less than zero.

93418Fare amount is an invalid format.

Fare amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the fare amount can't include decimal places.

93419Fare amount is too large.

Fare amount can't be longer than 9 digits.

93420Fee amount cannot be negative.

Fare amount can't be less than zero.

93421Fee amount is an invalid format.

Fee amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the fee amount can't include decimal places.

93422Fee amount is too large.

Fee amount can't be longer than 9 digits.

93423Issued date is an invalid format.

Issued date is an invalid format.

93424Issuing carrier code is too long.

Issuing carrier code can't be longer than 4 characters.

93425Passenger middle initial is too long.

Passenger middle initial can't be longer than 1 character.

93426Restricted ticket is required.

You must specify if the ticket is restricted.

93427Tax amount cannot be negative.

Tax amount can't be less than zero.

93428Tax amount is an invalid format.

Tax amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the tax amount can't include decimal places.

93429Tax amount is too large.

Tax amount can't be longer than 9 digits.

93430Ticket number is too long.

Ticket number can't be longer than 15 characters.

93431Expected a collection of legs but none provided.

Expected a collection of legs but unrecognized data provided.

93432Too many legs.

A maximum of 12 legs can be provided.

93443Country code is too long.

Country code can't be longer than 3 characters.

93444Date of birth is an invalid format.

Date of birth is an invalid format.

Industry Data LegAnchorIcon

CodeTextExplanation
96301Arrival airport code is too long.

Arrival airport code can't be longer than 3 characters.

96302Arrival time is an invalid format.

Arrival time must be formatted like '08:00'.

96303Carrier code is too long.

Carrier code can't be longer than 2 characters.

96304Conjunction ticket is too long.

Conjunction ticket can't be longer than 14 characters.

96305Coupon number is too long.

Coupon number can't be longer than 1 character.

96306Departure airport code is too long.

Departure airport code can't be longer than 3 characters.

96307Departure time is an invalid format.

Departure time must be formatted like '08:00'.

96308Exchange ticket is too long.

Exchange ticket can't be longer than 15 characters.

96309Fare amount cannot be negative.

Fare amount can't be less than zero.

96310Fare amount is an invalid format.

Fare amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the fare amount can't include decimal places.

96311Fare amount is too large.

Fare amount can't be longer than 9 digits.

96312Fare basis code is too long.

Fare basis code can't be longer than 15 characters.

96313Fee amount cannot be negative.

Fee amount can't be less than zero.

96314Fee amount is an invalid format.

Fee amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the fee amount can't include decimal places.

96315Fee amount is too large.

Fee amount can't be longer than 9 digits.

96316Flight number is too long.

Flight number can't be longer than 5 characters.

96317Service class is too long.

Service class can't be longer than 2 characters.

96318Tax amount cannot be negative.

Tax amount can't be less than zero.

96319Tax amount is an invalid format.

Tax amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the tax amount can't include decimal places.

96320Tax amount is too large.

Tax amount can't be longer than 9 digits.

Braintree Auth Signup FlowAnchorIcon

CodeTextExplanation
93618Currency passed is not accepted.

The currency passed is not one of the [supported currencies](/guides/braintree-auth/multi-currency#currency-support).

93621Merchant account was not OAuth onboarded.

Merchant was not onboarded through [Braintree Auth](/guides/braintree-auth/overview).

93622Company name is not valid

The applicant's company name must contain only letters, numbers, and these characters: `&-!@#$()'./+,"`. The maximum length is 40 characters.

93623Partner not allowed to onboard merchants.

Partner not allowed to onboard merchants.

83601Email is required.

Email is required.

93602Email is invalid.

Email is invalid.

83603Merchant must have a country code (alpha2, alpha3, numeric or name)

Merchant must have a country code (alpha2, alpha3, numeric or name)

93604Country code (alpha3) is not an accepted country.

Country code (alpha3) is not an accepted country.

93605Country code (alpha3) is not a valid country

Country code (alpha3) is not a valid country

93606Country code (alpha2) is not an accepted country.

Country code (alpha2) is not an accepted country.

93607Country code (alpha2) is not a valid country

Country code (alpha2) is not a valid country

93608Country code (numeric) is not an accepted country.

Country code (numeric) is not an accepted country.

93609Country code (numeric) is not a valid country

Country code (numeric) is not a valid country

93610Country name is not an accepted country.

Country name is not an accepted country.

93611Country name is not a valid country

Country name is not a valid country

93612Provided country information is inconsistent.

Provided country information is inconsistent.

93613One or more payment methods passed are not accepted.

One or more payment methods passed are not accepted.

93614One or more currencies passed are not accepted.

One or more currencies passed are not accepted.

93615One or more payment methods passed are not allowed.

One or more payment methods passed are not allowed.

93616A merchant account already exists for that currency.

A merchant account already exists for that currency.

93617You must pass in a valid currency.

You must pass in a valid currency.

93619No merchant accounts exist for merchant.

No merchant accounts exist for merchant.

93620A merchant account already exists for the id.

A merchant account already exists for the id.

Marketplace MerchantAccountAnchorIcon

CodeTextExplanation
82602Applicant merchant id is too long.

The merchant account ID cannot be longer than 32 characters.

82603Applicant merchant id format is invalid.

You can only use letters, numbers, _ and - for the merchant account ID.

82604Applicant merchant id is in use.

Each merchant account ID needs to be unique.

82605Applicant merchant id is not allowed.

A merchant account ID may not be named 'all' or 'new.'

82606Master merchant account ID is required.

You must provide a [master merchant account ID](/guides/braintree-marketplace/onboarding#master-merchant-account-id-parameter) when creating a merchant account.

82607Master merchant account ID is invalid.

You'll get this error if we cannot find a master merchant account with the id specified.

82608Master merchant account must be active.

You'll get this error if the supplied [master merchant account ID](/guides/braintree-marketplace/onboarding#master-merchant-account-id-parameter) is not active.

82610Terms Of Service needs to be accepted. Applicant tos_accepted required.

You must indicate that the terms of service are accepted.

82675Merchant account id can not be updated.

You'll get this error if the ID cannot be updated.

82676Master merchant account id can not be updated.

You'll get this error if the [merchant account ID](/articles/control-panel/important-gateway-credentials#merchant-account-id) cannot be updated.

82674Merchant accounts with a status of pending or suspended cannot be updated.

The merchant account cannot be updated.

82609Applicant first name is required.

You must provide the first name of the applicant.

82637Individual first name is required.

Applicant first name is required.

82611Applicant last name is required.

You must provide the last name of the applicant.

82638Individual last name is required.

Applicant last name is required.

82612Applicant date of birth is required.

You must provide the applicant's date of birth.

82639Individual date of birth is required.

Individual date of birth is required.

82613Applicant routing number is required.

You must provide the applicant's bank routing number.

82640Funding routing number is required.

Funding routing number is required.

82614Applicant account number is required.

You must provide the applicant's bank account number.

82641Funding account number is required.

Funding account number is required.

82615Applicant SSN must be blank, last 4 digits, or full 9 digits.

The applicant's social security number must be valid (full 9 digits, with or without dashes, or last 4 digits).

82642Individual SSN must be full 9 digits if present.

Individual SSN must be full 9 digits if present.

82616Applicant email is invalid.

The applicant's email must be valid.

82643Individual email is invalid.

Individual email is invalid.

82627Applicant first name is invalid.

The applicant's first name must not contain '/', '\', '&', '<', '>' or any control characters.

82644Individual first name is invalid.

Individual first name is invalid.

82628Applicant last name is invalid.

The applicant's last name must not contain '/', '\', '&', '<', '>' or any control characters.

82645Individual last name is invalid.

Applicant last name is invalid.

82631Applicant company name is invalid.

The applicant's company name must contain only letters, numbers, and these characters: `&-!@#$()'./+,"`. The maximum length is 40 characters.

82632Applicant tax ID is invalid.

The applicant's tax id must be 9 digits long.

82688Business params provided in an invalid format.

You must provide the attributes for Business in the correct format.

82647Business tax ID is invalid.

Business tax ID is invalid.

82633Applicant company name is required with tax ID.

If the applicant's tax id is provided then the company name must be provided as well.

82634Applicant tax ID is required with company name.

If the applicant's company name is provided then the tax id must be provided as well.

82635Applicant routing number is invalid.

The applicant's bank routing number must be valid.

82649Funding routing number is invalid.

Funding routing number is invalid.

82650An unexpected error occurred trying to save the merchant account; support has been notified and is looking into the issue. You may safely retry this request

An unexpected error occurred trying to save the merchant account; Support has been notified and is looking into the issue. You may safely retry this request.

82652Business tax ID or Individual SSN is required.

Business tax ID or Individual SSN is required.

82621Applicant declined due to OFAC.

The applicant has failed an OFAC check. The OFAC search confirms whether a sub-merchant is on the criminal and terrorists watch lists collected from databases around the world.

82622Applicant declined due to MasterCard MATCH.

The applicant has failed a Mastercard MATCH check. The Mastercard MATCH File is a database file used by payment processing banks to identify specific merchants and principals who may been terminated for reasons like fraud or violation(s) of Visa and/or Mastercard rules.

82623Applicant declined due to failed KYC.

The applicant has failed a Know Your Customer check.

82624Applicant declined due to invalid SSN.

The applicant's social security number is invalid. If you provide a social security number, you must provide either the entire number or the last four digits.

82625Applicant declined due to SSN matching that of a deceased person.

The applicant has been declined because the social security number provided appears in a database of social security numbers belonging to deceased persons.

82626Applicant declined after review.

After review, the applicant has been declined.

82617Applicant street address is required.

You must provide the applicant's street address.

82657Individual street address is required.

Individual street address is required.

82618Applicant locality is required.

You must provide the applicant's city, town, or municipality.

82658Individual locality is required.

Individual locality is required.

82619Applicant postal code is required.

You must provide the applicant's postal code.

82659Individual postal code is required.

Individual postal code is required.

82620Applicant region is required.

You must provide the applicant's region.

82660Individual region is required.

Individual region is required.

82629Applicant street address is invalid.

You must provide a valid street address for the applicant that includes at least one digit.

82661Individual street address is invalid.

Individual street address is invalid.

82664Applicant region is invalid.

You must provide a valid region for the applicant. Only two-letter abbreviations are accepted, e.g. 'CA' but not 'California.'

82668Individual region is invalid.

Individual region is invalid.

82630Applicant postal code is invalid.

You must provide a valid postal code for the applicant.

82662Individual postal code is invalid.

Individual postal code is invalid.

82636Applicant phone is invalid.

The provided phone is not valid.

82656Individual phone is invalid.

Individual phone is invalid.

82663Applicant date of birth is invalid

You must provide a valid date of birth.

82666Individual date of birth is invalid.

Individual date of birth is invalid.

82670Applicant account number is invalid.

The provided bank account number is not valid.

82671Funding account number is invalid.

Funding account number is invalid.

82665Applicant email is required.

You must provide an email address.

82667Individual email is required.

Individual email is required.

82672Business tax ID must be blank unless business legal name is present.

The tax id must be blank if no company name/legal name is provided.

82673Applicant tax ID must be blank unless company name present.

Applicant tax ID must be blank unless company name present.

82646Business DBA name is invalid.

The provided DBA name is not valid. The applicant's company name must contain only letters, numbers, and these characters: `&-!@#$()'./+,"`. The maximum length is 40 characters.

82677Business legal name is invalid.

The provided legal name is not valid. The applicant's company name must contain only letters, numbers, and these characters: `&-!@#$()'./+,"`. The maximum length is 40 characters.

82669Business legal name is required with tax ID.

You must provide a legal name if a tax id has been provided.

82648Business tax ID is required with business legal name.

You must provide a tax id if a legal name has been provided.

82685Business street address is invalid.

The provided business street address is not valid. It must contain at least one digit.

82686Business postal code is invalid.

The provided business zip code is not valid. It must be 5 digits followed by an optional hyphen, space, and an additional 4 digits.

82684Business region is invalid.

The provided business region is not valid. Only two-letter abbreviations are accepted, e.g. 'CA' but not 'California.'

82679Funding destination is invalid.

You must provide a valid funding destination. Deprecated funding destinations are treated as invalid.

82678Funding destination is required.

You must provide a funding destination.

82681Funding email is invalid.

The provided funding email address is not valid.

82680Funding email is required when destination is email.

You must provide a funding email address when your funding destination is email.

82683Funding mobile phone is invalid.

The provided funding mobile phone is not valid. Phone must be 10 - 14 characters and can only contain numbers, parentheses, and periods.

82682Funding mobile phone is required when destination is mobile phone.

You must provide a funding mobile phone when your funding destination is mobile phone.

82687Individual params provided in an invalid format.

You must provide the attributes for Individual in the correct format.

82689Business locality is invalid.

The provided business address is not valid.

82690Individual locality is invalid.

The provided individual address is not valid.

82691Applicant locality is invalid.

The provided applicant address is not valid.

82692Birthdate invalid; applicant must be 13 or older

Applicant must be 13 or older.

Recurring Billing ModificationAnchorIcon

CodeTextExplanation
92001Quantity is invalid.

Quantity must be a number.

92002Amount is invalid.

Amount must be formatted like '10' or '10.00'.

92003Amount cannot be blank.

Blanks are not allowed.

92004Quantity cannot be blank.

Blanks are not allowed.

92005Number of billing cycles is invalid.

Number of billing cycles must be numeric.

92006Amount is invalid for currency.

Amount must be in a valid format for the currency.

92010Quantity must be greater than zero.

Quantity must be greater than 0.

92011Existing ID is invalid.

Modification ID must be associated with the subscription.

92012Existing ID is required.

Modification ID is required to update a modification.

92013Inherited From ID is invalid.

Modification with that inherited from ID is not available.

92014Inherited From ID is required.

Must provide an inherited from ID.

92015Cannot update a removed add-on or discount.

Cannot update and remove a modification at the same time.

92016Cannot remove add-on or discount if not already associated with subscription.

Cannot remove add-on or discount if not already associated with subscription.

92017Number of billing cycles cannot be blank.

Number Of Billing Cycles cannot be blank if the subscription expires.

92018Cannot specify both number of billing cycles and never expires as true.

Number of billing cycles is blank and never expires is not set to true.

92019Number of billing cycles must be greater than zero.

Number of billing cycles must be greater than 0.

92020Existing ID is not of the correct kind.

Existing ID must be of the type of modification that is being edited.

92021ID to remove is incorrect kind.

Existing ID must be of the type of modification that is being removed.

92022Cannot edit add-on or discount on a past due subscription.

Unable to edit modifications on subscriptions that are past due.

92023Amount is too large.

The amount cannot be greater than the maximum allowed by the processor. [Contact us](/help?issue=RecurringBillingQuestion) for your specific limit.

92024Cannot pass null modification.

Modification is missing from the API call.

92025ID to remove is invalid.

ID to remove is invalid.

OAuthAnchorIcon

CodeTextExplanation
93801Invalid grant:

The provided authorization code or refresh token is invalid due to one of the reasons described in the error message: * code not found * code has been used * code has expired * refresh token not found * refresh token is expired * refresh token is revoked A revoked refresh token might also mean that it was already used.

93802Invalid credentials:

Client authentication failed (e.g. unknown client, no client authentication included, or unsupported authentication method).

93803Invalid scope:

The requested scope is invalid, unknown, malformed, or exceeds the scope granted by the resource owner.

93804Invalid request:

The request is missing a required parameter, includes an unsupported parameter value (other than grant type), repeats a parameter, includes multiple credentials, utilizes more than one mechanism for authenticating the client, or is otherwise malformed.

93805Unsupported grant type:

The authorization grant type is not supported by the authorization server.

PayPalAnchorIcon

CodeTextExplanation
82901Incomplete PayPal account information.

You must specify an access token or a consent code for this operation.

82902Pre-Approved Payment enabled PayPal account required for vaulting.

When you vault a PayPal account, you must provide a [payment method nonce](/guides/payment-method-nonces) that was retrieved via the [Vault flow](/guides/paypal/vault).

82903Invalid PayPal account information.

You cannot specify both an access token and a consent code for this operation.

82904PayPal Accounts are not accepted by this merchant account.

Your account has not been enabled to accept PayPal.

82905A customer ID is required to vault a PayPal Account.

When adding a PayPal account to an existing customer, the customer ID is required.

92906PayPal Account token is taken.

PayPal account tokens have to be unique.

92907Cannot use a payment_method_nonce more than once.

A payment method nonce may only be consumed once.

92908Unknown or expired payment_method_nonce.

The [payment method nonce](/guides/payment-method-nonces) has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

92909Payment method nonce locked.

**Deprecated**
The [payment method nonce](/guides/payment-method-nonces) must be unlocked before it is used.

92910Error communicating with PayPal.

There was an error communicating with PayPal.

92911PayPal authentication expired.

**Deprecated**
The authentication you received from your user has expired.

92912Funding source selection was given without an access token.

You cannot specify a funding source without also specifying an access token.

92913Funding source object is invalid or missing required fields.

You sent an invalid or incomplete funding source specification.

92914Payment method nonces cannot be used to update an existing PayPal account.

A [payment method nonce](/guides/payment-method-nonces) cannot be used to update an existing PayPal account.

92915Payment method params supplied are not valid for updating a PayPal account.

The payment method params you supplied are not valid for updating a PayPal account.

92916Error executing PayPal order.

There was an error while executing the PayPal order.

92917Error executing PayPal billing agreement.

There was an error while executing the PayPal billing agreement.

92918Merchant setup must be completed before vaulting PayPal payment methods.

The merchant account used is not fully set up; PayPal payment methods cannot be vaulted until setup is completed.

92919This merchant account does not allow PayPal payments using the old Vault flow.

Your account does not have the old Vault flow enabled for PayPal payments. [Contact us](/help?issue=acceptPaymentTypes) to enable the old Vault flow.

92921Unable to retrieve billing agreement details from PayPal.

There was an error while attempting to retrieve the details of the billing agreement.

92922A PayPal Billing Agreement ID is required.

Your request must include a Billing Agreement ID.

92923The merchant account ID is not valid.

When included in the request, the merchant account ID must identify an existing merchant account.

92924An indirect merchant PayPal payer ID is required if and only if the specified merchant account is configured as an indirect merchant conduit.

You would already have a merchant account configured as an indirect merchant conduit to require the use of this field.

92925Payment method token is required.

A payment method token is required for a financing option request.

92926Amount is required.

An amount is required for a financing option request.

92927Currency code is required.

A currency code is required for a financing option request.

92928A two-letter country code is required.

A [two-letter country code](/reference/general/countries#list-of-countries) is required for a financing option request.

92929The vaulted payment method is missing a PayPal Billing Agreement ID.

A PayPal Billing Agreement ID is required for the financing option Billing Agreement flow.

92930Unable to retrieve financing options from PayPal.

There was an issue retrieving the financing options from PayPal.

82956The payer cannot pay for transaction.

The payer cannot pay for transaction. Contact the payer to find other ways to pay for transaction.

82957Payer account cannot be used for transaction.

Payer account cannot be used for transaction. Contact the payer for an alternate payment method.

82958Payee account is restricted.

Payee account is restricted. Contact PayPal customer support to get more information about the status of the account.

82959Payer account is restricted.

Payer account is restricted. Contact PayPal customer support to get more information about the status of the account.

92960Billing agreement token is invalid.

Billing agreement token is invalid.

PayPal Payment ResourceAnchorIcon

CodeTextExplanation
97301The provided payment method nonce is expired or consumed.

The [payment method nonce](/guides/payment-method-nonces) has either expired or consumed. Nonces are deleted upon expiration (3 hours after generation).

97302PayPal payment resource id is not supported.

The PayPal payment resource id stored in payment method nonce is not supported for the patch operations.

97303Payment method nonce is required.

The payment method nonce is requried for patch operations.

97304Payee email is an invalid format.

Email must be a well-formed email address.

97305Payee email is too long.

Maximum 254 characters.

97306Expected a collection of line items but different format provided.

Expected a collection of line items but unrecognized data provided.

97307Expected a hash object of line item but different format provided.

Expected a hash object of line item but unrecognized data provided.

97308Expected a debit type for each line item.

Line item type must be 'debit'.

97309Unit amount is an invalid format.

Unit amount must be formatted like '10', '10.00', or '10.0000'.

97310Unit tax Amount is an invalid format.

Unit tax amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the unit tax amount can't include decimal places.

97311currency_iso_code is required with amount provided.

currency_iso_code is required when amount provided.

97312currency_iso_code is not supported.

currency_iso_code is not supported by PayPal.

97313Some of required fields are missing from shipping address.

Some of required fields are missing from shipping address.

97314Amount breakdown is an invalid format.

Some of the fields in amount breakdown object are provided with invaid format.

97315Expected a collection of shipping options but different format provided.

Expected a collection of shipping options but unrecognized data provided.

97316Expected a collection of shipping options but none provided.

Expected a collection of shipping options but none provided.

97317Expected id, label, and selected shipping option fields to be provided.

Expected a list of required fields to be provided including id, label, and selected.

97318Shipping option type can only be SHIPPING, PICKUP_IN_STORE, or PICKUP_FROM_PERSON.

Shipping option type can only be SHIPPING, PICKUP_IN_STORE, or PICKUP_FROM_PERSON.

97319Expected an unique id for each shipping option.

An unique id is required for each shipping option.

97320Shipping option should have only one been selected.

The shipping options should have only been selected.

97321Selected Shipping option amount should match shipping in amount breakdown object.

Selected Shipping option amount should match shipping in amount breakdown object.

97322The accumulated item amount from line_items should match item_total in amount breakdown object.

The accumulated item amount from line_items should match item_total in amount breakdown object.

97323The accumulated tax amount from line_items should match tax_total in amount breakdown object.

The accumulated tax amount from line_items should match tax_total in amount breakdown object.

97324The PayPal patch payment resource call failed.

The PayPal patch payment resource call failed.

97325The specified amount has an invalid format.

The specified amount has an invalid format.

97326The shipping option id is too long.

The shipping option id is too long.

97327The shipping option label is too long.

The shipping option label is too long.

97328The combined shipping full name from first name and last name is too long.

The combined shipping full name from first name and last name is too long.

97329The shipping street address is too long.

The shipping street address is too long.

97330The shipping extended address is too long.

The shipping extended address is too long.

97331The shipping locality is too long.

The shipping locality is too long.

97332The shipping region is too long.

The Shipping region is too long.

97333The country code value in shipping international phone object is too long.

The country code value in shipping international phone object is too long.

97334The national number value in shipping international phone object is too long.

The national number value in shipping international phone object is too long.

97335The shipping postal code is too long.

The shipping postal code is too long.

97336The description is too long.

The description is too long.

97337The custom field is too long.

The custom field is too long.

97338The order id is too long.

The order id is too long.

97339Contact preference value is invalid.

Valid values are "NO_CONTACT_INFO", "RETAIN_CONTACT_INFO" and "UPDATE_CONTACT_INFO".

Payment MethodAnchorIcon

CodeTextExplanation
93101Payment method params are required.

A top level payment method parameter is missing.

93102Nonce is invalid.

The nonce that was received is not a valid nonce.

93103Nonce is required.

A nonce was not provided.

93104Customer ID is required.

A customer id was not provided.

93105Customer ID is invalid.

The customer id does not reference a customer.

93106Cannot forward a payment method of this type.

Only credit cards may be forwarded.

93107Cannot use a payment_method_nonce more than once.

A payment method nonce may only be consumed once.

93108Unknown or expired payment_method_nonce.

The [payment method nonce](/guides/payment-method-nonces) has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

93109Nonce is not vaultable.

Nonce is not vaultable.

93113PayPal custom field must be less than 256 characters in length.

Maximum 255 characters.

93114PayPal description must be less than 256 characters in length.

Maximum 255 characters.

93115Order ID must be less than 256 characters in length.

Maximum 255 characters.

93116Amount format is invalid.

Amount must be formatted like '10' or '10.00'.

93117This payment method is no longer supported.

This payment method is no longer supported.

93118PayPal refresh token is invalid.

PayPal has reported this refresh token is invalid.

93119Nonce is not a valid parameter when PayPal refresh token is provided.

Nonce is not a valid parameter when PayPal refresh token is provided.

93120PayPal merchant account required to vault refresh token.

A PayPal merchant account required to vault a refresh token. Enable PayPal in a new or existing merchant account and retry.

93121US bank account verification method is invalid.

Valid US bank account verification methods include `independent_check`, `network_check`, or `micro_transfers`.

93122US bank account is not accepted by merchant account.

A merchant account must support US bank accounts before a US bank account payment method can be created.

93125Cannot update Custom Action name of a saved payment method.

The Custom Action name cannot be modified.

93127Bank account has pending micro-transfers verification.

Bank account has pending micro-transfers verification.

93128Bank account token is taken.

Bank account tokens have to be unique.

93129Bank account is blocked. Please contact Braintree support for more information.

Bank account is blocked. Please contact Braintree support for more information.

93130Bank account ACH mandate text is required.

Bank account ACH mandate text is missing or is not a string.

93131Bank account ACH mandate accepted_at needs to be a string timestamp in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (e.g. YYYY-MM-DDTHH:mm:SSZ). Timestamp string will be interpreted as a UTC time.

Bank account ACH mandate accepted_at date is missing or is not a string UTC timestamp.

93132Bank account account_number is invalid.

Bank account account number is missing or does not contain 1-17 digits.

93133Bank account routing_number is invalid.

Bank account routing number is missing or does not contain 8 or 9 digits.

93134Bank account account_type is invalid.

Bank account account type is missing or is not one of "checking" or "savings".

93135Billing Address format is invalid.

Billing Address format is invalid.

93136Bank account first and last name must be present.

Bank account first and last name must be present.

93137Bank account full name (first and last name) or business name must be present.

Bank account full name (first and last name) or business name must be present.

93138Payment method token is too long.

Payment method token is too long.

93139Bank name is invalid.

Bank name is invalid.

93140A Fastlane payment method is required.

A Fastlane payment method is required.

93141Payment method is not enrolled for network tokenization.

Payment method is not enrolled for network tokenization.

93155Bank account ACH mandate is missing.

Bank account ACH mandate is missing.

93156To unlock network check bank verifications and ensure compliance with NACHA regulations, this feature needs to be enabled for your account. Please contact support for assistance.

Network check bank verification is not enabled for this merchant account.

931573 or more micro-transfers have been performed for this particular bank account.

3 or more micro-transfers have been performed for this particular bank account.

93158Micro-transfer verification cannot be completed at this time. Please contact Braintree support for assistance.

Micro-transfer verification cannot be completed at this time. Please contact Braintree support for assistance.

Risk ContextAnchorIcon

CodeTextExplanation
97001Account is not currently set up for sending risk context data.

Account is not currently set up for sending risk context data.

RiskDataAnchorIcon

CodeTextExplanation
94701Customer Browser is too long.

Maximum 255 characters.

CodeTextExplanation
82301Settlement Date is required

You must provide a settlement date as the first argument.

82302Settlement Date is invalid

The settlement date provided must be a valid date.

82303Group By Custom Field is not a valid custom field

The custom field provided must be valid.

Recurring BillingAnchorIcon

CodeTextExplanation
81901Cannot edit a canceled subscription.

After a subscription has been canceled it cannot be updated.

81902ID has already been taken.

Subscription IDs need to be unique.

81903Price cannot be blank.

If you provide a price, it can't be an empty string. If you omit the price, then the subscription will inherit the price from the plan.

81904Price is an invalid format.

Price must be formatted like '10' or '10.00'.

81905Subscription has already been canceled.

You can't cancel subscriptions that have already been canceled.

81906ID is invalid (use only letters, numbers, '-', and '_').

If specifying the ID for the subscription, you can only use letters, numbers, _ and -.

81907Trial Duration is an invalid format.

It must be 1-3 digits.

81908Trial Duration is required.

It's required if trial period is set to true.

81909Trial Duration Unit is invalid.

Valid values are "day" and "month".

81910Cannot edit an expired subscription.

You cannot edit a subscription with Expired status.

81911Trial Period is not a valid format.

It should be true or false.

81923Price is too large.

The subscription price cannot be greater than the maximum allowed by the processor. [Contact us](/help?issue=RecurringBillingQuestion) for your specific limit.

91901Merchant Account ID is invalid.

If specifying the merchant account to use to process transactions for this subscription it needs to be the ID for one of your merchant accounts.

91902Payment method token payment instrument type is not accepted by this merchant account.

When providing a payment method token, your merchant account must be configured to accept the payment method type represented by the token.

91903Payment method token is invalid.

You'll get this error if we can't find a payment method with the token specified.

91904Plan ID is invalid.

You'll get this error if we can't find a plan with the given ID.

91905Payment method token does not belong to the subscription's customer.

When updating a subscription and changing the payment method token, you can only use tokens associated to the same customer that the subscription is currently associated to.

91906Number Of Billing Cycles must be numeric.

It must be a number.

91907Number Of Billing Cycles must be greater than zero.

It must be greater than 0.

91908Cannot specify both number of billing cycles and never expires as true.

You cannot specify both number of billing cycles and never expires as true.

91909Number Of Billing Cycles is less than the current billing cycle.

You cannot edit a subscription and change the number of billing cycles to be below the current count of billing cycles.

91911Cannot add duplicate add-on or discount.

Add-Ons and Discounts must be unique, but you can change the quantity.

91912Number Of Billing Cycles cannot be blank if the subscription expires.

Blanks are not allowed.

91913Billing Day of Month must be numeric.

The billing date must be a number.

91914Billing Day of Month must be between 1 and 28, or 31.

The billing date must be 1-28 or 31 (for the last day of every month).

91915First Billing Date is invalid.

The first billing date is an incorrect format.

91916First Billing Date cannot be in the past.

The first billing date cannot be in the past.

91917Cannot specify more than one type of start date.

The type of start date can be only one of the following: start immediately, after a trial period, or on a specific day of the month.

91918Billing Day of Month cannot be updated.

The billing date cannot be updated.

91919First Billing Date cannot be updated.

First billing date cannot be updated.

91920Can only edit id, merchant account id, payment method token, and descriptor on a past due subscription.

You cannot edit any fields which could change the price on a past due subscription.

91921Invalid request format.

The add-ons and discounts are in an invalid format.

91922Cannot update subscription to a plan with a different billing frequency.

You will get this validation if you try to update the plan on a subscription and the billing cycle for the new plan is not the same as the billing cycle of the old plan.

91923Subscription Plan currency must be the same as the merchant account's currency.

Subscription Plan currency must be the same as the merchant account's currency.

91924Payment method nonce payment instrument type is not accepted by this merchant account.

The supplied payment method nonce represents a payment method of a type that is not accepted by this merchant account.

91925Payment method nonce is invalid.

The supplied payment method nonce was not in a valid format or is unknown.

91926Payment method nonce does not belong to the subscription's customer.

The payment method nonce used to create a subscription must be vaulted and must belong to the customer owning the subscription.

91927Payment method nonce represents an un-vaulted payment instrument.

You cannot create a subscription with a nonce representing an unvaulted payment instrument. Use the payment method nonce to create a vaulted payment method first.

91928Payment instrument type is not valid for subscriptions.

Payment instrument type is not valid for subscriptions.

91929Payment instrument type is not valid for subscriptions.

Payment instrument type is not valid for subscriptions.

91930Merchant Account does not support the given payment instrument type.

Merchant Account does not support the given payment instrument type.

91931Too many concurrent attempts to update this subscription. Try again later.

Too many concurrent attempts to update this subscription. Try again later.

919323D Secure enriched payment method nonce did not authenticate successfully.

The operation against the subscription failed because the 3D Secure enriched payment method nonce has a [failed status](/guides/3d-secure/server-side#status-codes).

91933Failed to replace modifications because one or more of the new records could not be saved.

An ActiveRecordRecordNotSaved error happened. It failed to replace modifications because one or more of the new records could not be saved.

91934Payment method must be specified.

Subscription cannot be created without a payment method.

ThreeDSecureAnchorIcon

CodeTextExplanation
94501Payment method nonce not found

We cannot find the original nonce you are attempting to upgrade for 3D Secure.

94502Nonce is already consumed

This nonce was previously consumed and cannot be used to upgrade 3D Secure.

94503Cannot 3D Secure a non-credit card payment instrument

3D Secure is not applicable because the transaction was created with an alternative payment method.

94504Unsupported card type

3D Secure was attempted using a card brand that is not supported by your merchant account.

94505Amount can be any number of digits optionally followed by a decimal point `.` and up to two decimal places following the decimal point. Commas `,` are not allowed.

The amount you specified must be a number greater than 0.

94506Amount too large

The amount exceeds the processor's transaction limit.

94507Nonce is already 3D Secure

Nonce is already 3D Secure.

94508An unexpected error occurred

Unexpected failure during Cardinal API operation.

94509Could not locate 3D Secure verification

Cannot find a 3D Secure verification matching the ID passed to the server.

94510Could not locate payment method nonce

An invalid payment method nonce was sent.

94511Payment method nonce has not been upgraded to a 3D Secure nonce

Payment method nonce has not been upgraded to a 3D Secure nonce.

94512Cardinal response missing required field: cavv

Cardinal response missing required field: cavv

94513Cardinal response missing required field: xid

Cardinal response missing required field: xid

94514Cardinal response missing required field: eci_flag

Cardinal response missing required field: eci_flag

94515Merchant account not 3D Secure enabled

Merchant account is not 3D Secure enabled.

94516Billing address first name is too long.

**Deprecated**
Maximum 50 characters.

94517Billing address last name is too long.

**Deprecated**
Maximum 50 characters.

94518Billing address line one is too long.

**Deprecated**
Maximum 50 characters.

94519Billing address line two is too long.

**Deprecated**
Maximum 50 characters.

94520Billing address city is too long.

**Deprecated**
Maximum 50 characters.

94521Customer email format is invalid.

**Deprecated**
Customer email format is invalid.

94522Customer email is too long.

**Deprecated**
Maximum 254 characters.

94523Customer mobile phone number format is invalid.

**Deprecated**
Phone must be 2 - 20 characters and can only contain numbers.

94524Billing phone number format is invalid.

**Deprecated**
Phone must be 2 - 20 characters and can only contain numbers.

94525Customer shipping method code is invalid.

**Deprecated**
Valid customer shipping method codes include '01', '02', '03', '04', '05', and '06'.

94526Billing Alpha2 country code is not accepted.

**Deprecated**
Must be [valid two-letter country code](/reference/general/countries#list-of-countries) and formatted as 'xx'.

94527Billing postal code format is invalid.

**Deprecated**
Billing postal code format is invalid.

94528Billing state code is invalid.

**Deprecated**
Billing code must be two alphabetical characters.

94529Billing given name format is invalid.

Must be a string. ASCII printable characters only. Maximum 50 characters.

94530Billing surname format is invalid.

Must be a string. ASCII printable characters only. Maximum 50 characters.

94531Billing line1 format is invalid.

Must be a string. Maximum 50 characters.

94532Billing line2 format is invalid.

Must be a string. Maximum 50 characters.

94533The authenticate result JWT signature did not verify.

There was an error when decoding the JSON Web Token (JWT). Either the signature did not verify, or an invalid JWT was passed.

94534Billing line3 format is invalid.

Must be a string. Maximum 50 characters.

94535Billing city format is invalid.

Must be a string. Maximum 50 characters.

94536Billing state format is invalid.

Must be a string. Maximum 50 characters.

94537Billing postal code format is invalid.

Must be a string. Maximum 10 characters.

94538Billing country code format is invalid.

Must be a valid [two-letter country code](/reference/general/countries#list-of-countries).

94539Billing phone number format is invalid.

Must be a number. Maximum 20 characters.

94540Work phone number format is invalid.

Must be a number. Maximum 25 characters.

94541Mobile phone number format is invalid.

Must be a number. Maximum 25 characters.

94542Email format is invalid.

Must be a string. Maximum 255 characters.

94543Shipping method format is invalid.

Possible values: 01, 02, 03, 04, 05, 06.

94544Shipping line1 format is invalid.

Must be a string. Maximum 50 characters.

94545Shipping line2 format is invalid.

Must be a string. Maximum 50 characters.

94546Shipping line3 format is invalid.

Must be a string. Maximum 50 characters.

94547Shipping state format is invalid.

Must be a string. Maximum 50 characters.

94548Shipping city format is invalid.

Must be a string. Maximum 50 characters.

94549Shipping country code format is invalid.

Must be a valid [two-letter country code](/reference/general/countries#list-of-countries).

94550Shipping postal code format is invalid.

Must be a string. Maximum 10 characters.

94551Shipping method indicator format is invalid.

Possible values: 01, 02, 03, 04, 05, 06, 07.

94552Authentication indicator format is invalid.

Possible values: 01, 02, 03, 04, 05, 06.

94553Product code format is invalid.

Possible values: AIR, GEN, DIG, SVC, RES, TRA, DSP, REN, GAS, LUX, ACC, TBD.

94554Delivery timeframe format is invalid.

Possible values: 01, 02, 03, 04.

94555Delivery email format is invalid.

Must be a string. Maximum 254 characters.

94556Reorder indicator format is invalid.

Possible values: 01, 02.

94557Preorder indicator format is invalid.

Possible values: 01, 02.

94558Preorder date format is invalid.

Must be a date in format 20190131.

94559Gift card amount format is invalid.

Must be a number. Maximum 15 characters.

94560Gift card currency code format is invalid.

Must be a valid currency code.

94561Gift card count format is invalid.

Must be a number. Maximum 2 characters.

94562Account age indicator format is invalid.

Possible values: 01, 02, 03, 04, 05.

94563Account create date format is invalid.

Must be a date in format 20190131.

94564Account change indicator format is invalid.

Possible values: 01, 02, 03, 04.

94565Account change date format is invalid.

Must be a date in format 20190131.

94566Account pwd change indicator format is invalid.

Possible values: 01, 02, 03, 04, 05.

94567Account pwd change date format is invalid.

Must be a date in format 20190131.

94568Shipping address usage indicator format is invalid.

Possible values: 01, 02, 03, 04.

94569Shipping address usage date format is invalid.

Must be a date in format 20190131.

94570Transaction count day format is invalid.

Must be a number. Maximum 3 characters.

94571Transaction count year format is invalid.

Must be a number. Maximum 3 characters.

94572Account purchases format is invalid.

Must be a number. Maximum 4 characters.

94573Fraud activity format is invalid.

Possible values: 01, 02.

94574Shipping name indicator format is invalid.

Possible values: 01, 02.

94575Payment account indicator format is invalid.

Possible values: 01, 02, 03, 04, 05.

94576Payment account age format is invalid.

Must be a date in format 20190131.

94578ACS window size format is invalid.

Possible values: 01, 02, 03, 04, 05.

94579SDK max timeout format is invalid.

Must be a number. Maximum 2 characters.

94581Address match format is invalid.

Possible values: Y, N.

94582Account ID format is invalid.

Must be a string. Maximum 64 characters.

94584IP address format is invalid.

Must be a string. Maximum 50 characters.

94586Order description format is invalid.

Must be a string. Maximum 256 characters.

94587Shipping given name format is invalid.

Must be a string. Maximum 50 characters.

94588Shipping surname format is invalid.

Must be a string. Maximum 50 characters.

94589Shipping phone format is invalid.

Must be a number. Maximum 20 characters.

94590Tax amount format is invalid.

Must be a number. Maximum 20 characters.

94591Override payment method format is invalid.

Possible values: NA, CR, DB, VSAVR, VSAVA.

94592User agent format is invalid.

Must be a string. Maximum 500 characters.

94598Installment format is invalid.

Must be a number. Maximum 3 characters.

94599Purchase date format is invalid.

Must be a date in format YYYYMMDDHHMMSS.

945100Recurring end format is invalid.

Must be a date in format YYYYMMDD.

945101Recurring frequency format is invalid.

Must be a number. Maximum 4 characters.

945102Add card attempts format is invalid.

Must be a number. Maximum 3 characters.

945103One of the additional info fields sent is invalid. Check the field-level docs in the latest client SDK references for correct field names.

For field-level requirements, see the latest [Android](http://www.javadoc.io/doc/com.braintreepayments.api/braintree), [iOS](https://braintree.github.io/braintree_ios/Classes/BTThreeDSecureRequest.html), or [JavaScript](https://braintree.github.io/braintree-web/current/ThreeDSecure.html) reference docs for the SDK version you're using.

945104The additional info sent is invalid. Check the field-level docs in the latest client SDK references for format requirements.

For field-level requirements, see the latest [Android](http://www.javadoc.io/doc/com.braintreepayments.api/braintree), [iOS](https://braintree.github.io/braintree_ios/Classes/BTThreeDSecureRequest.html), or [JavaScript](https://braintree.github.io/braintree-web/current/ThreeDSecure.html) reference docs for the SDK version you're using.

945105The customer information sent is invalid. Check the field-level docs in the latest client SDK references for format requirements.

For field-level requirements, see the latest [Android](http://www.javadoc.io/doc/com.braintreepayments.api/braintree), [iOS](https://braintree.github.io/braintree_ios/Classes/BTThreeDSecureRequest.html), or [JavaScript](https://braintree.github.io/braintree-web/current/ThreeDSecure.html) reference docs for the SDK version you're using.

945106The region cannot be provided without a corresponding country code.

A country code is necessary to disambiguate the provided region name.

945107Requesting a challenge and requesting an exemption are mutually exclusive options.

You cannot request a challenge and an exemption on the same request.

9451083D Secure is invalid

3D Secure is invalid

945112Amount is invalid. Negative values are not permitted.

Amount is invalid. Negative values are not permitted.

945113Requested exemption type is invalid.

Requested exemption type is invalid.

945114Cannot provide requested_exemption_type and challenge_requested in the same request.

Cannot provide requested_exemption_type and challenge_requested in the same request.

945115Custom field is invalid:

Custom field keys must match the API name of a custom field configured in the Control Panel. The error message for this validation error will contain a list of the invalid keys.

945116Custom field is too long:

Custom field values must be less than or equal to 255 characters. The error message for this validation error will contain a list of the custom fields that were too long.

945117Enrolled status is invalid.

Enrolled status is invalid.

945118Authentication trans status is invalid.

Authentication trans status is invalid.

945119Recurring frequency must be passed when the recurring authentication indicator is passed.

Recurring frequency must be passed when the recurring authentication indicator is passed.

945120Merchant Initiated Request Type is invalid.

Merchant Initiated Request Type is invalid.

945121Prior Authentication ID or Prior Authentication Details is needed for 3RI.

Prior Authentication ID or Prior Authentication Details is needed for 3RI.

945122Prior 3D Secure Authentication ID is invalid.

Prior 3D Secure Authentication ID is invalid.

945123Installment must be passed when the installment authentication indicator is passed.

Installment must be passed when the installment authentication indicator is passed.

945124Prior Authentication Method passed is invalid.

Prior Authentication Method passed is invalid.

945125Prior Authentication Time must be in a valid ISO-8601 timestamp format.

Prior Authentication Time must be in a valid ISO-8601 timestamp format.

945126Merchant on record name is needed for 3RI payment with multiple merchants.

Merchant on record name is needed for 3RI payment with multiple merchants.

9451273D secure verification metadata is missing.

3D secure verification metadata is missing.

945128External 3D secure authentication ID is missing.

External 3D secure authentication ID is missing.

9451293D secure with amount zero is not supported for this merchant account.

3D secure with amount zero is not supported for this merchant account.

TransactionAnchorIcon

CodeTextExplanation
81501Amount cannot be negative.

Even if creating a credit transaction, the amount should be given as x.xx, not -x.xx.

81502Amount is required.

You'll get this error if amount is not given or is blank.

81503Amount is an invalid format.

Amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount cannot include decimal places.

815245Payment method nonce is not vaultable. Valid number and/or expiration date must be provided.

The payment_method_nonce is not vaultable. Valid number and/or expiration date must be provided.

81528Amount is too large.

The amount cannot be greater than the maximum allowed by the processor. [Contact us](/help?issue=TransactionProcessingQuestion) for your specific limit.

81509Credit card type is not accepted by this merchant account.

The credit card card type must be accepted by your merchant account. Note that there is a different error code when you get this error when creating transactions using tokens (`91517`).

81527Custom field is too long:

Custom field values must be less than 255 characters. The error message for this validation error will contain a list of the custom fields that were too long.

91501Order ID is too long.

Order ID must be less than 255 characters.

91504Transaction can only be voided if status is authorized, submitted_for_settlement, or - for PayPal - settlement_pending.

Transaction can only be voided if status is authorized, submitted_for_settlement, or - for PayPal - settlement_pending.

91505Credit transactions cannot be refunded.

Only sale transactions can be refunded.

91506Cannot refund transaction unless it is settled.

Transaction status must be settled to refund it.

91507Cannot submit for settlement unless status is authorized.

Transaction status must be authorized to submit the transaction for settlement.

91508Cannot determine payment method.

You must specify the payment method to charge, either directly (by payment_method_nonce, payment_method_token, credit_card, paypal_account, etc.) or indirectly (by customer_id, subscription_id, etc.).

91526Custom field is invalid:

Custom field keys must match the API name of a custom field configured in the Control Panel. The error message for this validation error will contain a list of the invalid keys.

91510Customer ID is invalid.

You'll get this error if you create a transaction using a customer ID and the customer ID isn't in your Vault.

91511Customer does not have any credit cards.

When creating a transaction using a customer ID, we'll use the customer's default credit card. If the customer does not have any credit cards associated to it, you'll get this error.

91512Transaction has already been fully refunded.

You'll get this error if you create a refund on a transaction that has been fully refunded.

91513Merchant account ID is invalid.

If you specify the [merchant account ID](/articles/control-panel/important-gateway-credentials#merchant-account-id) to use to process a transaction and it does not match any of your merchant accounts, you'll get this error.

91514Merchant account is suspended.

You'll get this error if you try to create a transaction using a suspended merchant account.

91515Cannot provide both payment_method_token and credit_card attributes.

If you specify both a Vault token and a full credit card number you'll get this error.

91516Cannot provide both payment_method_token and customer_id unless the payment_method belongs to the customer.

If you specify both a customer ID and a payment method token when creating a transaction, the payment_method_token must belong to the customer ID.

91527Cannot provide both payment_method_token and subscription_id unless the payment_method belongs to the subscription.

If you specify both a payment method token and a subscription ID the subscription ID must be associated to the token given.

91517Payment instrument type is not accepted by this merchant account.

When providing a payment method token, your merchant account must be configured to accept the payment method type represented by the token.

91518Payment method token is invalid.

You'll get this error if the payment method token isn't in the Vault.

91519Processor authorization code cannot be set unless for a voice authorization.

You can only set the processor authorization code for voice authorization transactions.

91521Refund amount is too large.

You cannot refund more than the amount submitted for settlement.

91533The submitted funding source does not allow refunds.

Refunds are only supported by instant local payment transactions and select non-instant local payment transactions.

91538Cannot refund a transaction with a suspended merchant account.

You cannot refund a transaction associated with a suspended merchant account.

91522Settlement amount is too large.

{{> shared/settlement_adjustment }}

91529Cannot provide both subscription_id and customer_id unless the subscription belongs to the customer.

If you give both a customer ID and a subscription ID the subscription must be associated to the customer.

91528Subscription ID is invalid.

You'll get this error if the subscription ID given isn't one of your subscriptions.

91523Transaction type is invalid.

Valid transaction types are "sale" and "credit".

91524Transaction type is required.

We need to know if you want to create a sale or a credit.

91525Vault is disabled.

If you set the option to store in Vault, your Vault needs to be enabled.

91531Subscription status must be Past Due in order to retry.

A subscription must be in past due status in order to manually retry the charge.

91547Merchant account does not support refunds.

The merchant account account does not support refunds.

81531Amount must be greater than zero.

The amount of a transaction cannot be zero.

81534Tax amount cannot be negative.

The tax amount cannot be less than zero.

81535Tax amount is an invalid format.

Tax amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount cannot include decimal places.

81536Tax amount is too large.

The tax amount cannot be longer than 9 digits.

81571Failed to authenticate, please try a different form of payment.

Failed to authenticate, please try a different form of payment.

91537Purchase order number is too long.

The purchase order number cannot be larger than 12 characters for AIB and 17 characters for other all other processors.

91539Voice Authorization is not allowed for this card type

The specified card type does not support voice authorization codes.

91540Transaction cannot be cloned if payment method is stored in vault.

Instead, create a new transaction using the payment method's token.

91541Cannot clone voice authorization transactions.

Cloning voice authorizations is currently unsupported.

91542Unsuccessful transaction cannot be cloned.

Only transactions that were authorized or settled are cloneable.

91543Credits cannot be cloned.

You may only clone sale transactions.

91544Cannot clone transaction without submit_for_settlement flag.

You must specify whether or not to submit the cloned transaction for settlement upon creation.

91545Voice Authorizations are not supported for this processor.

Your processor does not support voice authorizations.

91546Credits are not supported by this processor.

Your processor does not support credits.

91548Purchase order number is invalid.

The purchase order number must be printable ASCII characters.

81520Processor authorization code must be 6 characters.

Processor authorization code must be 6 characters.

91549Cannot provide more than one of payment_method_token, payment_method_nonce, credit_card, and venmo_sdk_payment_method_code attributes.

Cannot provide more than one of payment_method_token, payment_method_nonce, credit_card, and venmo_sdk_payment_method_code attributes.

91550Channel is too long.

Channel is too long. This field is for use by **partners and shopping cart providers only**.

91551Settlement amount cannot be less than the service fee amount.

The settlement amount must be greater than or equal to the service fee amount.

91552Credits not allowed with service fee.

Service fees are allowed on sale transactions only.

91553Sub-merchant account requires a service fee.

Transactions for sub-merchant accounts need a service fee amount.

91554Amount cannot be negative.

Service fee amount must be greater than or equal to zero.

91555Amount is an invalid format.

Service fee amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount cannot include decimal places.

91556Service fee amount is larger than transaction amount.

Service fee amount must be less than the transaction amount.

91557Service fee not supported on master merchant account.

Transactions for a master merchant account cannot have a service fee amount.

91558Merchant account does not support MOTO transactions unless configured by processor.

This merchant account cannot be used for Mail Order/Telephone Order.

91559Cannot refund a transaction with a pending merchant account.

A Merchant Account must be Active in order to refund a transaction.

91560Transaction could not be held in escrow.

The Transaction cannot be held in escrow.

91561Cannot release a transaction that is not escrowed.

Cannot release a transaction that is not escrowed.

91562Release can only be cancelled if the transaction is submitted for release.

Release can only be canceled if the transaction is submitted for release.

91563Escrowed transactions cannot be partially refunded.

The Transaction must be fully refunded after being held in escrow.

91564Cannot use a payment_method_nonce more than once.

The [payment method nonce](/guides/payment-method-nonces) has already been consumed.

91565Unknown or expired payment_method_nonce.

The [payment method nonce](/guides/payment-method-nonces) has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

91567Payment instrument type is not accepted by this merchant account.

Payment instrument type is not accepted by this merchant account.

91568Three D Secure Token is invalid.

3D Secure token is invalid.

91569payment_method_nonce does not contain a valid payment instrument type.

payment_method_nonce does not contain a valid payment instrument type.

91572Current payment method does not support use_billing_for_shipping flag.

Current payment method does not support use_billing_for_shipping flag.

91575Cannot transition transaction to settled, settlement_confirmed, or settlement_declined

Cannot transition transaction to settled or settlement_declined.

91576PayPal is not enabled for your merchant account.

PayPal is not enabled for your merchant account.

91577Merchant account does not support payment instrument.

Merchant account does not support payment instrument.

91570Transaction data does not match data from Three D Secure verify call.

The credit card number and expiration date used for 3D Secure verification must match the values used to create the transaction.

91573Transaction cannot be cloned if payment method is a PayPal account.

Transaction cannot be cloned if payment method is a PayPal account.

91574Cannot refund a transaction transaction in settling status on this merchant account. Try again after the transaction has settled.

Cannot refund a transaction transaction in settling status on this merchant account. Try again after the transaction has settled.

91578Service fee can not be applied on PayPal transactions.

Service fee can not be applied on PayPal transactions.

91580PayPal custom field must be less than 256 characters in length.

PayPal custom field must be less than 256 characters in length.

91581Shipping address customer does not match customer in request.

Shipping address customer does not match customer in request.

91582PayPal unilateral transactions must also be submitted for settlement.

A unilateral payment is a payment that is made to a receiver who does not have a PayPal account.

91583This PayPal account was not vaulted with the required data

This PayPal account was not vaulted with the required data.

91584Merchant account must match the 3D Secure authorization merchant account.

The merchant account specified when creating the transaction must match the [merchant account specified when generating the client token](/guides/3d-secure/client-side#specify-a-merchant-account). If you do not specify a [merchant account ID](/articles/control-panel/important-gateway-credentials#merchant-account-id), your default merchant account will be used.

91585Amount must match the 3D Secure authorization amount.

The amount used for 3D Secure verification must match the amount used to create the transaction.

91586Shared billing address ID cannot be used in the same call as a standard billing address ID

Shared billing address ID cannot be used in the same call as a standard billing address ID.

91587Shared customer ID cannot be used in the same call as a standard customer ID

Shared customer ID cannot be used in the same call as a standard customer ID.

91588Shared payment method token cannot be used in the same call as a standard payment method token

Shared payment method token cannot be used in the same call as a standard payment method token.

91589Shared payment method token cannot be used in the same call as a non-shared identifier param

Shared payment method token cannot be used in the same call as a non-shared identifier param.

91590Shared identifier param cannot be used with non-shared payment method token

Shared identifier param cannot be used with non-shared payment method token.

91591Shared shipping address ID cannot be used in the same call as a standard shipping address ID

Shared shipping address ID cannot be used in the same call as a standard shipping address ID.

91592Shared payment methods cannot be vaulted

Shared payment methods cannot be vaulted.

91593Shared payment methods cannot be vaulted

Shared payment methods cannot be vaulted.

91594Shared shipping addresses cannot be vaulted

Shared shipping addresses cannot be vaulted.

91595Shared payment methods cannot be updated

Shared payment methods cannot be updated.

91597Cannot provide both shared_payment_method_token and shared_customer_id unless the payment_method belongs to the customer.

Cannot provide both shared_payment_method_token and shared_customer_id unless the payment_method belongs to the customer.

91598Payment instrument type is not accepted by this merchant account.

Payment instrument type is not accepted by this merchant account.

91599Shared Shipping address customer does not match customer in request.

Shared Shipping address customer does not match customer in request.

91596Shared payment method token is invalid.

Shared payment method token is invalid.

915100Shared Customer ID is invalid.

Shared Customer ID is invalid.

915103Cannot submit for partial settlement.

Cannot submit for partial settlement.

915101Payment instrument type is not accepted.

Payment instrument type is not accepted.

915102Partial settlements are not supported by this processor.

Partial settlements are not supported by this processor.

915104Delayed settlements are not supported for this processor. The submit for settlement option is required.

Delayed settlements are not supported for this processor. The submit for settlement option is required.

915105Merchant account does not support Amex rewards.

Merchant account does not support Amex rewards.

915106Points amount is too large.

Amex Pay with Points amount is too large.

915152request_id is required in a rewards payment request.

request_id is required in a rewards payment request.

915153points is required in a rewards payments required.

points is required in a rewards payments required.

915154currency_amount is required in a rewards payments required.

currency_amount is required in a rewards payments required.

915155currency_iso_code is required in a rewards payments required.

currency_iso_code is required in a rewards payments required.

915107Updating order_id on submit_for_settlement is not supported by this processor.

Updating order_id on submit_for_settlement is not supported by this processor.

915108Updating descriptor on submit_for_settlement is not supported by this processor.

Updating descriptor on submit_for_settlement is not supported by this processor.

915109PayPal supplementary data fields must be less than 4001 characters in length:

PayPal supplementary data fields must be less than 4001 characters in length.

915110Cannot clone facilitated transactions.

Cannot clone facilitated transactions.

915111PayPal supplementary data field count must be less than 101.

PayPal supplementary data field count must be less than 101.

915112Shared payment method token originated from another merchant and is not allowed to be shared

Shared payment method token originated from another merchant and is not allowed to be shared.

915113EciFlag is required.

ECI flag is required for 3D Secure Pass Thru transactions.

915114EciFlag is invalid.

The provided ECI flag is invalid. Valid ECI Flags are:

  • 00
  • 01
  • 02
  • 04
  • 05
  • 06
  • 07

915116Cavv is required for specified EciFlag.

CAVV is required for the specified ECI flag.

915119The version of 3D Secure authentication must be composed only of digits and separated by periods (e.g. `1.0.2`).

The version of 3D Secure authentication must be composed only of digits and separated by periods (e.g. `1.0.2`).

915131Merchant account does not support 3D Secure transactions for card type.

Merchant account has no active processor settings that support 3D Secure for this card type.

915156Third party vault status must be either `vaulted` or `will_vault`.

The vault status indicator passed with the transaction must be `vaulted` or `will_vault`.

915133Transaction source must be either `moto`, `recurring_first`, `recurring`, `installment_first`, `installment`, `estimated`, `estimated_moto`, or `unscheduled`.

The source passed with the transaction must be `moto`, `recurring_first`, `recurring`, `installment_first`, `installment`, `estimated`, `estimated_moto`, or `unscheduled`.

915134submit_for_settlement is required and must be true.

The payment method for this transaction does not support authorization with delayed settlement. Funds must be submitted for settlement upon creation.

915135shared_payment_method_nonce does not contain valid payment instrument type.

shared_payment_method_nonce does not contain valid payment instrument type.

915136Payment instrument type is not accepted by this merchant.

Payment instrument type is not accepted by this merchant.

915137Cannot clone Braintree Marketplace transactions via the API.

Braintree Marketplace transactions cannot be cloned via the API. If you wish to clone a Braintree Marketplace transaction, you must use the Braintree Control Panel.

915157Too many line items.

A maximum of 249 line items can be provided.

915158Expected a collection of line items but none provided.

Expected a collection of line items but unrecognized data provided.

915145Line items not allowed for this transaction.

The target transaction does not support line items.

915159Discount amount is an invalid format.

Discount amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount can't include decimal places.

915160Discount amount cannot be negative.

Discount amount can't be less than zero.

915161Discount amount is too large.

Discount amount can't be longer than 9 digits.

915162Shipping amount is an invalid format.

Shipping amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount can't include decimal places.

915163Shipping amount cannot be negative.

Shipping amount can't be less than zero.

915164Shipping amount is too large.

Shipping amount can't be longer than 9 digits.

915165Ships from postal code is too long.

Ships from postal code must not contain more than 9 letters and numbers.

915166Ships from postal code must be a string.

Ships from postal code must be a string.

915167Ships from Postal code can only contain letters, numbers, spaces, and hyphens.

Ships from Postal code can only contain letters, numbers, spaces, and hyphens.

915147Vaulted cards from this payment method can only be used for recurring transactions.

This payment method only allows recurring transactions from vaulted cards. All other transactions are not allowed with vaulted cards.

915148Transaction can not be voided if status of a PayPal partial settlement child transaction is settlement_pending.

Transaction can not be voided if status of a PayPal partial settlement child transaction is settlement_pending.

915149Too many concurrent attempts to refund this transaction. Try again later.

Too many concurrent attempts to refund this transaction. Try again later.

915151Too many concurrent attempts to void this transaction. Try again later.

Too many concurrent attempts to void this transaction. Try again later.

915168Device session id must be less than 256 characters.

The device session id provided is too long. It must be less than 256 characters.

915169Merchant account does not support 3D Secure.

The transacting merchant account must be configured to support 3D Secure. Either [specify a merchant account](/reference/request/transaction/sale#specify-merchant-account-id) that has 3D Secure enabled, or [contact us](/help?issue=FraudProtectionQuestion).

915170Venmo Profile ID does not exist.

The Venmo Profile associated with the `profile_id` does not exist.

915171US bank account payment_method_nonce must originate from Plaid or be vaulted prior to transaction.

US bank accounts must be verified before they can be charged. This can be done by either tokenizing with Plaid or vaulting the nonce and providing verification options.

915172US bank account payment method must be verified prior to transaction.

US bank accounts must be verified before they can be charged. This can be done by updating the payment method and providing verification options.

915173PayPal payee ID is not permitted for an un-vaulted PayPal nonce.

Use payee email for un-vaulted PayPal nonces.

915174PayPal payee ID is not permitted for a PayPal Order payment method.

Use payee email for PayPal Order payment methods.

915175Status must be either `vaulted` or `will_vault`.

See {{linkToReferenceRequest 'transaction' 'sale' param='external_vault.status'}} description for more information on the status.

915176External vault may only be used with credit card transactions.

An external vault may only be used with credit card transactions. The external vault is used to communicate how a credit card is being stored externally from Braintree.

915177Status must be `vaulted` when used with previous network transaction ID.

The network transaction ID is only needed when conducting a transaction using a stored credit card.

915178Temporarily blocked as bank account was closed or could not be located. Please contact Braintree Support if unblocking is required.

US bank account is temporarily blocked due to it being closed or not being located.

915179Previous network transaction ID must be a 15 digit number.

Previous network transaction ID must be a 15 digit number.

915180Merchant account id must match the subscription's merchant account.

Merchant account ID must match the subscription's merchant account.

915181Shared payment method nonce originated from another merchant and is not allowed to be shared

Shared payment method nonce originated from another merchant and is not allowed to be shared.

915183Cannot void a transaction that has already been captured.

PayPal has already captured funds for this transaction, so it can't be voided in the Braintree gateway.

915195Processor does not support MOTO transactions for this card type.

Processor does not support MOTO transactions for this card type.

915189Merchant account must match the merchant account used to create the payment.

Merchant account provided in the {{linkToReferenceRequest 'transaction' 'sale'}} call must match the merchant account used to create the payment by the client.

915190Fake payment method nonce cannot be used in production.

Test nonces can only be used in the sandbox.

915191Settlement failed with a soft processor decline.

The processor failed to capture funds for this transaction, but the authorization is still open. You may safely retry this request.

915192Local payment transaction has already been processed.

Local payment transaction has already been processed for the parameters provided in the {{linkToReferenceRequest 'transaction' 'sale'}} call.

815193Transaction amount not supported by processor.

The amount cannot be less than the minimum allowed by the processor. [Contact us](/help?issue=TransactionProcessingQuestion) for your specific limit.

915200Failed to refund transaction.

The authorization for the refund was [hard declined](/articles/control-panel/transactions/declines#handling-declines) by the issuer.

915201Failed to refund transaction. Please try again at a later time.

The authorization for the refund was [soft declined](/articles/control-panel/transactions/declines#handling-declines) by the issuer.

915205The three_d_secure_authentication_id was already used and cannot be processed more than once.

The three_d_secure_authentication_id was already used and cannot be processed more than once.

915207Refund limit exceeded. Please try using an alternate payment method.

The refund could not be completed successfully and the number of refund attempts has exceeded the limit. Please try using an alternate payment method.

915208The installment amounts are invalid.

The amount charged per installment is not supported in this region.

915209The specified number of installments are not supported in this region.

This transaction cannot be processed with the specified number of installments.

915210Installments are not supported in this region.

Installment data is currently not accepted in this region.

915211Installments may not be processed on debit cards in this region.

Installments are only supported on cards with a credit account in this region.

915212EMV data is invalid.

The EMV data is in an invalid format.

915215Cannot create offline decline without EMV payment method.

Transaction can only be created as an offline decline if it has an EMV payment method.

915216Cannot update EMV data unless the transaction is an EMV transaction and status is authorized.

EMV data can only be updated for an EMV transaction with an authorized status.

915217Cannot submit EMV contact transaction for settlement without a transaction certificate.

For an EMV contact transaction the application cryptogram must be the transaction certificate.

915218Transaction can only be adjusted when status is authorized.

Transaction can only be adjusted when status is authorized.

915219Transaction is not eligible for adjustment.

Transaction is not eligible for adjustment.

915220Incremental auth on transaction is not supported for this processor.

Incremental auth on transaction is not supported for this processor.

915221Partial auth reversal on transaction is not supported for this processor.

Partial auth reversal on transaction is not supported for this processor.

915222Processor does not support multi incremental auth adjustment.

Processor does not support multi incremental auth adjustment.

915223Offline decline transactions not supported by merchant account.

Offline decline transactions not supported by merchant account.

915224Payment initiated at is an invalid format.

Payment initiated at must be in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (e.g. YYYY-MM-DDTHH:MM:SSZ)."

815224Tax amount is required for domestic transactions in Sweden.

Tax amount is required for domestic transactions in Sweden.

915225Cashback amount cannot be negative.

Cashback amount cannot be negative.

915226Cashback amount is an invalid format.

Cashback amount is an invalid format.

915227Cashback amount is not allowed for this payment instrument.

Cashback amount is not allowed for this payment instrument.

915228Cashback amount is too large.

Cashback amount is too large.

915229Exchange Rate Quote ID is too long.

Exchange Rate Quote ID cannot be longer than 4000 characters.

915238Third party card-on-file network token cannot be vaulted.

Third party card-on-file network token cannot be vaulted.

915240Your account has not been configured with a processor that supports Third Party Card-On-File network tokens.

Your account has not been configured with a processor that supports Third Party Card-On-File network tokens.

815256This merchant account does not support 3DS transactions with third party card-on-file network tokens.

This merchant account does not support 3DS transactions with third party card-on-file network tokens.

915246Venmo requires that refunds are issued within 180 days of the sale. This refund can't be successfully processed.

Venmo requires that refunds are issued within 180 days of the sale. This refund can't be successfully processed.

915247Your account has not been configured with a processor that supports subscriptions with your chosen payment instrument type.

Your account has not been configured with a processor that supports subscriptions with your chosen payment instrument type.

915248Surcharge amount is an invalid format.

Surcharge amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount can't include decimal places.

915249Surcharge amount cannot be negative.

Surcharge amount can't be less than zero.

915250Surcharge amount is too large.

Surcharge amount can't be longer than 9 digits.

915251A connectivity error occurred when voiding. Please wait a moment and try again.

Encountered a connectivity error when voiding.

915252Shipping tax amount cannot be negative.

Shipping tax amount can't be less than zero.

915253Shipping tax amount is too large.

Shipping tax amount can't be longer than 9 digits.

915254Shipping tax amount is an invalid format.

Shipping amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount can't include decimal places.

915255Duplicate order ID detected.

Duplicate order ID detected.

915258Bank account ACH mandate is missing.

Bank account ACH mandate is missing.

915259Bank account ACH mandate accepted_at needs to be a string timestamp in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (e.g. YYYY-MM-DDTHH:mm:SSZ). Timestamp string will be interpreted as a UTC time.

Bank account ACH mandate accepted_at date is missing or is not a string UTC timestamp.

915260Bank account ACH mandate text is required.

Bank account ACH mandate text is missing or is not a string.

915262Bank account is temporarily blocked as customer advises not authorized. Please contact customer to remediate issue first then contact Braintree Support if unblocking is required.

US bank account is temporarily blocked as customer advises not authorized.

915263The standard entry class (SEC) code must be one of WEB, TEL, PPD, or CCD.

The standard entry class (SEC) code is invalid.

915264TEL is not a valid standard entry class (SEC) code for US bank credits.

The standard entry class (SEC) code is incompatible.

915265Processing merchant category code is invalid.

The merchant category code is not valid.

915266Transaction amount exceeds the payment method maximum amount.

The transaction amount exceeds the maximum amount allowed by the payment method nonce restrictions.

915267Transaction currency does not match the payment method currency.

The transaction currency does not match the currency restriction on the payment method nonce.

915268Valid values for ach_type are `standard` and `same_day`.

The ach_type must be either `standard` or `same_day`.

915269ach_type is not available for this merchant.

The specified ach_type is not available for this merchant.

915270The merchant category code associated with this transaction is not allowed for refund operations.

The merchant category code associated with this transaction is not allowed for refund operations.

915271Processing merchant category code is not supported.

The merchant category code is not supported for this merchant account.

Transaction Line ItemAnchorIcon

CodeTextExplanation
95801Commodity code is too long.

Commodity code can't be longer than 12 characters.

95803Description is too long.

Description can't be longer than 127 characters.

95804Discount amount is an invalid format.

Discount amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount can't include decimal places.

95805Discount amount is too large.

Discount amount is too large.

95806Discount amount cannot be negative.

Discount amount can't be less than zero.

95807Kind must be 'debit' or 'credit'.

Kind must be 'debit' or 'credit'.

95808Kind is required.

Kind is required, and must be 'debit' or 'credit'.

95809Product code is too long.

Product code can't be longer than 12 characters, or 127 characters for PayPal transactions.

95810Quantity is in an invalid format.

Quantity must be formatted like '10' or '10.0000'.

95811Quantity is required.

Quantity is required.

95812Quantity is too large.

Quantity can't be longer than 12 digits.

95813Total amount is an invalid format.

Total amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the amount can't include decimal places.

95814Total amount is required.

Total amount is required.

95815Total amount is too large.

Total amount can't be longer than 11 digits.

95816Total amount must be greater than zero. Zero is allowed for PayPal transactions.

Total amount can't be less than zero.

95817Unit amount is an invalid format.

Unit amount must be formatted like '10', '10.00', or '10.0000'.

95818Unit amount is required.

Unit amount is required.

95819Unit amount is too large.

Unit amount can't be longer than 12 digits.

95820Unit amount must be greater than zero. Zero is allowed for PayPal transactions.

Unit amount must be greater than zero. Zero is allowed for PayPal transactions.

95821Unit of measure is too long.

Unit of measure cannot be longer than 12 characters.

95822Name is required.

Name is required.

95823Name is too long.

Maximum 35 characters or 127 characters for PayPal transactions.

95824Unit tax amount is an invalid format.

Unit tax amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the unit tax amount can't include decimal places.

95825Unit tax amount is too large.

Unit tax amount is too large.

95826Unit tax amount cannot be negative.

Unit tax amount can't be less than or equal to zero.

95827Tax amount is an invalid format.

Tax amount must be formatted like '10' or '10.00'. If the [currency does not use decimal places](/reference/general/currencies), the unit tax amount can't include decimal places.

95828Tax amount is too large.

Tax amount can't be longer than 9 digits.

95829Tax amount cannot be negative.

Tax amount can't be less than zero.

95830UPC code is missing.

You must specify a UPC code when specifying a UPC type.

95831UPC code is too long.

UPC code cannot be longer than 17 characters.

95832UPC type is missing.

You must specify a UPC type when specifying a UPC code.

95833UPC type is invalid.

UPC type is invalid.

Transaction Payment FacilitatorAnchorIcon

CodeTextExplanation
97401The Payment Facilitator ID should only contain letters and numbers and cannot exceed 11 characters.

Payment Facilitator ID must be alphanumeric and a maximum of 11 characters.

97402The sub-merchant reference number should only contain letters and numbers and cannot exceed 15 characters.

Sub-merchant reference number must be alphanumeric and a maximum of 15 characters.

97403The sub-merchant legal name should only contain letters and numbers and cannot exceed 30 characters.

Sub-merchant legal name must be alphanumeric and a maximum of 30 characters.

97404The sub-merchant tax ID should only contain letters and numbers and cannot exceed 14 characters.

The sub-merchant tax ID should only contain letters and numbers and cannot exceed 14 characters.

97405Payment Facilitator details are not applicable for this merchant account.

Payment Facilitator details are not applicable for this merchant account.

97406Payment Facilitator details must be provided for this merchant account.

Payment Facilitator details must be provided for this merchant account.

Transaction ShipmentAnchorIcon

CodeTextExplanation
97201Shipment Tracking is not supported for this type of transaction.

Shipment Tracking is not supported for this type of transaction. Only Paypal transactions are eligible for package tracking at this moment.

97202Trackers can only be added when the transaction status is either settling or settled.

Trackers can only be added when the transaction status is either settling or settled.

97203Tracking number is required.

Tracking number is required.

97204Tracking number is too long.

Tracking number is exceeding the 64 character limit.

97205Carrier name is required.

Carrier name is required.

97206Carrier name is too long.

Carrier name is exceeding the 64 character limit.

97207Too many shipments.

Cannot add more than 20 shipments per transaction.

97208Tracking entries can only be added to child transactions.

In partial settlement use case, the tracking entries can only be added to the child transactions.

US Bank Account VerificationAnchorIcon

CodeTextExplanation
96101US bank account verification can not be confirmed.

US bank account verification can not be confirmed.

96102US bank account verification is not a micro-transfer verification.

US bank account verification is not a micro-transfer verification.

96103Deposit amounts do not match.

Deposit amounts do not match.

96104Too many confirmation attempts.

Too many confirmation attempts. The maximum number of failed attempts is 5. This verification can no longer be confirmed and a new verification must be initiated.

96105Unable to confirm deposit amounts.

Unable to confirm deposit amounts at this time.

96106Invalid deposit amounts.

There should be exactly 2 deposit amounts supplied as integers.

96107The verification add on provided is invalid.

The verification add on provided is invalid.

Venmo AccountAnchorIcon

CodeTextExplanation
84101Common ID is required.

Common ID is required.

84102Username is required.

Username is required.

84103Venmo user ID is required.

Venmo user ID is required.

84104Customer ID is required.

Customer ID is required.

84105Venmo accounts are not accepted by this merchant account.

Venmo accounts are not accepted by this merchant account.

84106Customer ID is invalid.

Customer ID is invalid.

VerificationAnchorIcon

CodeTextExplanation
94201Verification amount cannot be negative.

Verification amount cannot be negative.

94202Verification amount is invalid.

Verification amount is invalid.

94203Verification amount not supported by processor.

Verification amount not supported by processor.

94204Verification Merchant Account ID is invalid.

Verification [merchant account ID](/reference/response/credit-card-verification#merchant_account_id) is invalid.

94205Verification Merchant Account is suspended.

Verification Merchant Account is suspended.

94206The current user does not have access to the specified merchant_account_id

The current user does not have access to the specified merchant_account_id.

94207Verification amount is too large.

Verification amount is too large.

94208Verification Merchant Account ID cannot be a sub-merchant account.

Verifications cannot be created using sub-merchant accounts.

9421963D Secure authentication ID is invalid.

3D Secure authentication ID is invalid.

942197verification payment method does not match payment method used when the 3D Secure authentication was performed.

verification payment method does not match payment method used when the 3D Secure authentication was performed.

942198The 3D Secure data in the payment_method_nonce does not match the three_d_secure_authentication_id.

The 3D Secure data in the payment_method_nonce does not match the three_d_secure_authentication_id.

942199Cannot send both three_d_secure_pass_thru and three_d_secure_authentication_id.

Cannot send both three_d_secure_pass_thru and three_d_secure_authentication_id.

942200The three_d_secure_authentication_id was already used and cannot be processed more than once.

The three_d_secure_authentication_id was already used and cannot be processed more than once.

942201Verification for international issued payment method with 3D Secure and debit account type for amount greater than zero not supported.

Verification for international issued payment method with 3D Secure and debit account type for amount greater than zero not supported.

942202No active processor connection accepts us_bank_accounts.

No active processor connection accepts us_bank_accounts.

942203Intended transaction source is invalid. Refer to request documentation for correct values.

Intended transaction source is invalid. Refer to request documentation for correct values.

942113EciFlag is required.

EciFlag is required.

942114EciFlag is invalid.

EciFlag is invalid.

942116Cavv is required for specified EciFlag.

Cavv is required for specified EciFlag

942117ThreeDSecureVersion is required.

ThreeDSecureVersion is required.

942119The version of 3D Secure authentication must be composed only of digits and separated by periods (e.g. `1.0.2`).

The version of 3D Secure authentication must be composed only of digits and separated by periods (e.g. `1.0.2`).

942120AuthenticationResponse is invalid.

AuthenticationResponse is invalid.

942121DirectoryResponse is invalid.

DirectoryResponse is invalid.

942122CavvAlgorithm is invalid.

CavvAlgorithm is invalid.

942131Merchant account does not support 3D Secure verifications for card type.

Merchant account does not support 3D Secure verifications for card type.

84271Failed to authenticate, please try a different form of payment.

Failed to authenticate, please try a different form of payment.

94268Three D Secure Token is invalid.

Three D Secure Token is invalid.

94270verification data does not match data from Three D Secure verify call.

verification data does not match data from Three D Secure verify call.

94285Amount must match the 3D Secure authorization amount.

Amount must match the 3D Secure authorization amount.

942169Merchant account does not support 3D Secure.

Merchant account does not support 3D Secure.

94284Merchant account must match the 3D Secure authorization merchant account.

Merchant account must match the 3D Secure authorization merchant account.

WebhookAnchorIcon

CodeTextExplanation
96901URL needs to be a valid HTTPS path.

URL needs to be a valid HTTPS path.

96902URL needs to be a valid HTTP or HTTPS path.

URL needs to be a valid HTTP or HTTPS path.

96903URL cannot point to private address space.

URL cannot point to private address space.

96904You must select at least one notification.

You must select at least one notification.

96905Could not be verified.

URL could not be verified.

96906Cannot use this URL address.

URL cannot be used since it should not use a PayPal public domain.