Validation Errors

All

All Validation ErrorsAnchorIcon

AddressAnchorIcon

These validations apply when creating or updating addresses in the Vault directly, and also when providing billing and shipping details in requests like Transaction: Sale or Payment Method: Create.
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 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.

91803Country name is not an accepted country.

We only accept specific country names.

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.

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

We only accept specific numeric values.

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

We only accept specific alpha-2 values.

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.

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

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

81830International phone country code is invalid.

International phone country code is invalid.

81831International phone national number is invalid.

International phone national number is invalid.

Braintree MarketplaceAnchorIcon

Merchant AccountAnchorIcon

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

926996Required attribute is missing

The missing attribute is provided in the error message.

926997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

926998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

926999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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

92806Unsupported client token version

Unsupported client token version

928996Required attribute is missing

The missing attribute is provided in the error message.

928997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

928998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

928999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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

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

CustomerAnchorIcon

CodeTextExplanation
91602Custom 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.

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 default_payment_method_token and 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 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 custom_fields

91624Invalid Tax Identifier.

Country code and Identfier should be valid and not null.

916996Required attribute is missing

The missing attribute is provided in the error message.

916997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

916998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

916999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

91625International phone country code is invalid.

International phone country code is invalid.

91626International phone national number is invalid.

International phone national number is invalid.

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 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 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 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 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 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 for more details.

95735Both carrier name and tracking number are required

You must provide the shipping tracking info as type of evidence when responding with a CARRIER_NAME and (TRACKING_NUMBER or TRACKING_URL); see Evidence Requirements in the Disputes guide for more details.

95736ARN text evidence must only include numbers

Acquirer reference numbers/trace IDs can only contain numbers. See the Transaction Response Object reference for more details.

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

Acquirer reference numbers/trace IDs provided as supporting evidence for proof of either prior non-disputed transactions, recurring transactions, or refunds/credits cannot be the same as the disputed transaction’s ARN.

95738Date must be prior to dispute

Invalid date provided. Date must be prior to dispute, referencing the corresponding transaction or download date.

957996Required attribute is missing

The missing attribute is provided in the error message.

957997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

957998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

957999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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.

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, 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, 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, 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 4 legs can be provided.

934996Required attribute is missing

The missing attribute is provided in the error message.

934997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

934998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

934999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

93433Room rate must be greater than zero.

Room rate must be greater than zero.

93434Room rate format is invalid.

Room rate format is invalid.

93435Room rate is too large.

Room rate is too large.

93436Room tax must be greater than zero.

Room tax must be greater than zero.

93437Room tax format is invalid.

Room tax format is invalid.

93438Room tax is too large.

Room tax is too large.

93439No show indicator is invalid.

No show indicator is invalid.

93440Advanced deposit indicator is invalid.

Advanced deposit indicator is invalid.

93441Fire safety indicator is invalid.

Fire safety indicator is invalid.

93442Property phone is invalid.

Property phone is invalid.

93443Country code is too long.

Country code is too long.

93444Date of birth is an invalid format.

Date of birth is an invalid format.

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.

938996Required attribute is missing

The missing attribute is provided in the error message.

938997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

938998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

938999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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 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 format (e.g. YYYY-MM-DDTHH:mm:SSZ). Timestamp string will be interpreted as a UTC time.

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

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.

931996Required attribute is missing

The missing attribute is provided in the error message.

931997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

931998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

931999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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 has already been used.

93505Unknown or expired payment_method_nonce.

The payment method nonce has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

93506Payment method nonce locked.

Deprecated
The payment method nonce 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 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 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 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 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.

935996Required attribute is missing

The missing attribute is provided in the error message.

935997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

935998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

935999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

93530Expiration month is invalid.

Expiration month is invalid.

93531Expiration year is invalid.

Expiration year is invalid.

Google PayAnchorIcon

CodeTextExplanation
83701Expiration month is required.

Expiration month is required.

83702Expiration year is required

Expiration year 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.

93711Unknown payment_method_nonce.

Unknown payment_method_nonce.

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.

937996Required attribute is missing

The missing attribute is provided in the error message.

937997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

937998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

937999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

Android PayAnchorIcon

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.

93911Unknown payment_method_nonce.

Unknown payment_method_nonce.

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.

939996Required attribute is missing

The missing attribute is provided in the error message.

939997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

939998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

939999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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 can be used in the sandbox.

91723Update Existing Token is invalid.

Applies when updating a customer and 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.

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

Credit card type is not accepted by this merchant account.

91727Invalid VenmoSDK payment method code

Invalid VenmoSDK 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 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 has already been used once.

91732Unknown or expired payment_method_nonce.

The payment method nonce has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

91733Payment method nonce locked.

Deprecated
The payment method nonce 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 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 the network tokenization attributes are present and the cryptogram is missing.

917996Required attribute is missing

The missing attribute is provided in the error message.

917997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

917998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

917999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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 that was retrieved via the Vault flow.

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 has either expired or never existed. Nonces are deleted upon expiration (3 hours after generation).

92909Payment method nonce locked.

Deprecated
The payment method nonce 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 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 to enable the old Vault flow.

92920Using a payment method nonce for PayPal intent=order is not permitted.

Create a payment method from the nonce and then use the payment method token in the transaction sale request.

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

929996Required attribute is missing

The missing attribute is provided in the error message.

929997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

929998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

929999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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.

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.

941996Required attribute is missing

The missing attribute is provided in the error message.

941997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

941998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

941999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

94107Params nonce is required.

Params nonce is required.

94108Failed to create payment method nonce.

Failed to create payment method nonce.

94109Couldn't create Payment Method with SINGLE_USE nonce.

Couldn't create Payment Method with SINGLE_USE nonce.

94110Too many vaulted Venmo accounts exist for the user. Only the first 100 have been deleted.

Too many vaulted Venmo accounts exist for the user. Only the first 100 have been deleted.

Recurring BillingAnchorIcon

Add-ons/DiscountsAnchorIcon

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

920996Required attribute is missing

The missing attribute is provided in the error message.

920997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

920998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

920999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

81911Trial Period is not a valid format.

Trial Period is not a valid format.

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

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

91934Payment method must be specified.

Payment method must be specified.

SubscriptionAnchorIcon

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.

81923Price is too large.

The subscription price cannot be greater than the maximum allowed by the processor. Contact us 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.

919996Required attribute is missing

The missing attribute is provided in the error message.

919997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

919998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

919999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

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.

923996Required attribute is missing

The missing attribute is provided in the error message.

923997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

923998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

923999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

Three D SecureAnchorIcon

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

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.

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

945101Recurring frequency format is invalid.

Must be a number. Maximum 3 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, iOS, or JavaScript 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, iOS, or JavaScript 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, iOS, or JavaScript 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.

945218Account type must be either credit or debit.

Account type must be either credit or debit.

9451103DS Data-Only is not supported on this merchant account.

3DS Data-Only is not supported on this merchant account.

9451113DS Data-Only and Challenge Requested are mutually exclusive options.

3DS Data-Only and Challenge Requested are mutually exclusive options.

945115Custom field is invalid:

Custom field is invalid:

945116Custom field is too long:

Custom field is 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.

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

915248Surcharge amount is an invalid format.

Surcharge amount must be formatted like '10' or '10.00'. If the currency does not use decimal places, 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.

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.

91533Non-instant local payments refunds are not supported.

You cannot refund a non-instant local payment transaction.

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.

You can't settle more than the authorized amount unless your industry and processor support settlement adjustment (settling a certain percentage over the authorized amount); contact us for details.

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, 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, 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 has already been consumed.

91565Unknown or expired payment_method_nonce.

The payment method nonce 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. If you do not specify a 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, or unscheduled.

The source passed with the transaction must be moto, recurring_first, recurring, installment_first, installment, 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.

815141iDEAL payment is not complete

An iDEAL payment needs to enter a 'COMPLETE' state before creating a transaction. This error still exists in the gateway but is no longer returned. It will be removed from the docs once the error has been removed from gateway.

815142iDEAL payment is already consumed

Deprecated in favor of 91564 – Cannot use a payment_method_nonce more than once. This error still exists in the gateway but is no longer returned. It will be removed from the docs once the error has been removed from gateway.

915143Merchant account must match the iDEAL payment merchant account.

A transaction for an iDEAL payment must have a merchant account matching the iDEAL payment. This error still exists in the gateway but is no longer returned. It will be removed from the docs once the error has been removed from gateway.

915144Amount must match the iDEAL payment amount.

A transaction for an iDEAL payment must have an amount matching the iDEAL payment. This error still exists in the gateway but is no longer returned. It will be removed from the docs once the error has been removed from gateway.

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

91502Order ID is required when the payment_method_nonce is an iDEAL payment.

A transaction for an iDEAL payment must have an order ID. This error still exists in the gateway but is no longer returned. It will be removed from the docs once the error has been removed from gateway.

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.

915150iDEAL payments cannot be vaulted.

iDEAL payments cannot be vaulted. This error still exists in the gateway but is no longer returned. It will be removed from the docs once the error has been removed from gateway.

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 that has 3D Secure enabled, or contact us.

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

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 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 Transaction: Sale call.

815193Transaction amount not supported by processor.

The amount cannot be less than the minimum allowed by the processor. Contact us for your specific limit.

915200Failed to refund transaction.

The authorization for the refund was hard declined by the issuer.

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

The authorization for the refund was soft declined 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 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.

915239Your account has not been enabled to accept Third Party Card-On-File network tokens.

Your account has not been enabled to accept Third Party Card-On-File network tokens.

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.

915996Required attribute is missing

The missing attribute is provided in the error message.

915997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

915998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

915999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

815236Description length must be less than 255 characters.

Description length must be less than 255 characters.

815237Reason length must be less than 30 characters.

Reason length must be less than 30 characters.

915146The merchant account with corresponding currency code for the PayPal Retail transaction was not found.

The merchant account with corresponding currency code for the PayPal Retail transaction was not found.

915117Delayed settlements are not supported for this card type. The submit_for_settlement option is required.

Delayed settlements are not supported for this card type. The submit_for_settlement option is required.

915118Refunding the original authorization of a multiple partial settlement transaction is not supported by this processor. Please refund the individual child settlement transactions.

Refunding the original authorization of a multiple partial settlement transaction is not supported by this processor. Please refund the individual child settlement transactions.

915120AuthenticationResponse is invalid.

AuthenticationResponse is invalid.

915121DirectoryResponse is invalid.

DirectoryResponse is invalid.

915122CavvAlgorithm is invalid.

CavvAlgorithm is invalid.

9151233DS Data-Only is not supported on this card brand.

3DS Data-Only is not supported on this card brand.

9151243DS Data-Only is not supported on 3DS 1.

3DS Data-Only is not supported on 3DS 1.

915125DS Transaction ID is required.

DS Transaction ID is required.

9151263DS Data-Only is not supported on this merchant account.

3DS Data-Only is not supported on this merchant account.

9151273D Secure required flag must be boolean.

3D Secure required flag must be boolean.

915129Cannot update transaction details unless status is submitted_for_settlement.

Cannot update transaction details unless status is submitted_for_settlement.

915130Updating transaction details is not supported for this processor.

Updating transaction details is not supported for this processor.

815132UnionPay enrollment is required.

UnionPay enrollment is required.

915138The Adyen options provided are invalid.

The Adyen options provided are invalid.

915140Delayed settlements are not supported for this processor and card type. The submit_for_settlement option is required.

Delayed settlements are not supported for this processor and card type. The submit_for_settlement option is required.

91503Order ID must match iDEAL payment order ID.

Order ID must match iDEAL payment order ID.

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

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

915182For PayPal transactions with travel_flight industry data, submit_for_settlement is required and must be true.

For PayPal transactions with travel_flight industry data, submit_for_settlement is required and must be true.

915184Account type must be either credit or debit.

Account type must be either credit or debit.

915185Merchant account does not support account type.

Merchant account does not support account type.

915186Account type debit does not support auth. The submit_for_settlement option is required.

Account type debit does not support auth. The submit_for_settlement option is required.

915187Settlement amount must match authorized amount.

Settlement amount must match authorized amount.

915188Function void handler defined on Transaction encountered a failure.

Function void handler defined on Transaction encountered a failure.

915194Custom Action void handler defined on Transaction encountered a failure.

Custom Action void handler defined on Transaction encountered a failure.

9151963D Secure authentication ID is invalid.

3D Secure authentication ID is invalid.

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

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

915198The 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.

915199Cannot 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.

915202Product SKU is invalid.

Product SKU is invalid.

915203Shipping method is invalid.

Shipping method is invalid.

915204Shipping phone number is invalid.

Shipping phone number is invalid.

915206Billing phone number is invalid.

Billing phone number is invalid.

915213Secure Customer Authentication exemption is invalid.

Secure Customer Authentication exemption is invalid.

915214Invalid presentment currency.

Invalid presentment currency.

915230Api Request Key must be less than 256 characters in length.

Api Request Key must be less than 256 characters in length.

915231Api Request Key is not allowed for this transaction.

Api Request Key is not allowed for this transaction.

915232An API Request Key may only be reused with parameters identical to original request.

An API Request Key may only be reused with parameters identical to original request.

915233A previous request with this API Request Key is still in-flight.

A previous request with this API Request Key is still in-flight.

915234A previous request with this API Request Key failed and cannot be retried.

A previous request with this API Request Key failed and cannot be retried.

915235Request with API Request Key could not be processed. Please try again.

Request with API Request Key could not be processed. Please try again.

915241Presentment currency not specified. You must provide the presentment currency for accounts that can accept more than one presentment currency.

Presentment currency not specified. You must provide the presentment currency for accounts that can accept more than one presentment currency.

915242Presentment currency is not supported by this processor.

Presentment currency is not supported by this processor.

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.

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

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

915252Shipping tax amount cannot be negative.

Shipping tax amount cannot be negative.

915253Shipping tax amount is too large.

Shipping tax amount is too large.

915254Shipping tax amount is an invalid format.

Shipping tax amount is an invalid format.

915255Duplicate order ID detected.

Duplicate order ID detected.

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.

956996Required attribute is missing

The missing attribute is provided in the error message.

956997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

956998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

956999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

DescriptorAnchorIcon

CodeTextExplanation
92201Company name/DBA section is invalid.

The company/DBA name passed in your 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 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.

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.

922996Required attribute is missing

The missing attribute is provided in the error message.

922997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

922998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

922999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

Risk DataAnchorIcon

CodeTextExplanation
94701Customer Browser is too long.

Maximum 255 characters.

947996Required attribute is missing

The missing attribute is provided in the error message.

947997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

947998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

947999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

94702Customer Device ID is too long.

Customer Device ID is too long.

94703Customer location zip can only contain letters, numbers, spaces, and hyphens.

Customer location zip can only contain letters, numbers, spaces, and hyphens.

94704Customer location zip must be a string.

Customer location zip must be a string.

94705Customer location zip may contain no more than 9 letter or number characters.

Customer location zip may contain no more than 9 letter or number characters.

94706Customer tenure field is too long.

Customer tenure field is too long.

Transaction Line ItemsAnchorIcon

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, 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, 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 9 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, 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, 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.

958996Required attribute is missing

The missing attribute is provided in the error message.

958997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

958998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

958999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

95830UPC code is missing.

UPC code is missing.

95831UPC code is too long.

UPC code is too long.

95832UPC type is missing.

UPC type is missing.

95833UPC type is invalid.

UPC type 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 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.

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

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.

942996Required attribute is missing

The missing attribute is provided in the error message.

942997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

942998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

942999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

942175Verification External Vault Status must be either vaulted or will_vault if provided.

Verification External Vault Status must be either vaulted or will_vault if provided.

942177Verification External Vault Status must be vaulted when used with previous network transaction ID.

Verification External Vault Status must be vaulted when used with previous network transaction ID.

942179Verification External Vault Previous network transaction ID must be a 15 digit number.

Verification External Vault Previous network transaction ID must be a 15 digit number.

942184Verification account type must be either credit or debit.

Verification account type must be either credit or debit.

942185Merchant account does not support account type.

Merchant account does not support account type.

9421233DS Data-Only is not supported on this card brand.

3DS Data-Only is not supported on this card brand.

9421243DS Data-Only is not supported on 3DS 1.

3DS Data-Only is not supported on 3DS 1.

942125DS Transaction ID is required.

DS Transaction ID is required.

9421263DS Data-Only is not supported on this merchant account.

3DS Data-Only is not supported on this merchant account.

94286Network type must be one of VISA, MASTERCARD, DISCOVER, AMEX, SOLO, JCB, STAR, DELTA, SWITCH, MAESTRO, CB_NATIONALE, CONFIGOGA, CONFIDIS, ELECTRON, CETELEM, CHINA_UNION_PAY

Network type must be one of VISA, MASTERCARD, DISCOVER, AMEX, SOLO, JCB, STAR, DELTA, SWITCH, MAESTRO, CB_NATIONALE, CONFIGOGA, CONFIDIS, ELECTRON, CETELEM, CHINA_UNION_PAY

94287Mastercard Banknet Date must be a string date in the format MMDD.

Mastercard Banknet Date must be a string date in the format MMDD.

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.

961996Required attribute is missing

The missing attribute is provided in the error message.

961997Attribute is not in the required format

The attribute and the expected format are provided in the error message.

961998Attribute is not in the list of expected values

The attribute and the expected values are provided in the error message.

961999Attribute is the wrong type

The attribute and the expected types are provided in the error message.

96107The verification add on provided is invalid.

The verification add on provided is invalid.

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more