Returned within an error result object from the following requests:

Returned directly or within a successful result object from the following requests:

amount String

The amount used when verifying the card.


This field is populated if there was an error when checking AVS or the processing bank does not support AVS. Possible values:

  • S = Issuing bank does not support AVS
  • E = AVS system error

If this value is null, you will see responses in both avsPostalCodeResponseCode and avsStreetAddressResponseCode.


This is populated if the processor supports the address verification system (AVS). Possible values:

  • M = Matches
  • N = Does not match
  • U = Not verified
  • I = Not provided
  • A = Not applicable
  • B = Bypass

This is populated if the processor supports the address verification system (AVS). Possible values:

  • M = Matches
  • N = Does not match
  • U = Not verified
  • I = Not provided
  • A = Not applicable
  • B = Bypass

Billing address information associated with the credit card verification.

company string

Company name.

countryName string

The country name.

extendedAddress string

The extended address information—such as apartment or suite number.

firstName string

The first name.

lastName string

The last name.

locality string

The locality/city.

postalCode string

The postal code.

region string

The state or province.

streetAddress string

The billing street address.

createdAt DateTime

The date/time the object was created.


Credit card information associated with the verification.


The first 6 digits of the credit card, known as the bank identification number (BIN).


The type of the credit card. Possible values:

  • American Express
  • Carte Blanche
  • China UnionPay
  • Discover
  • Elo
  • JCB
  • Laser
  • Maestro
  • MasterCard
  • Solo
  • Switch
  • Visa
  • Unknown
cardholderName string

The cardholder name associated with the credit card.

commercial enum

Whether the card type is a commercial card and is capable of processing Level 2 transactions. Possible values:

  • Braintree_CreditCard::COMMERCIAL_YES
  • Braintree_CreditCard::COMMERCIAL_NO
  • Braintree_CreditCard::COMMERCIAL_UNKNOWN
countryOfIssuance string

The country that issued the credit card. Possible country values follow ISO 3166-1.

The value Unknown will be returned if we cannot immediately determine the card's country of issuance from the bank identification number (BIN).

customerLocation enum

This is "US" if the billing address is in the US or if a country is not specified. The location is "International" if the billing country passed is not the US. Possible values:

  • Braintree_CreditCard::INTERNATIONAL
  • Braintree_CreditCard::US
debit enum

Whether the card is a debit card. Possible values:

  • Braintree_CreditCard::DEBIT_YES
  • Braintree_CreditCard::DEBIT_NO
  • Braintree_CreditCard::DEBIT_UNKNOWN
durbinRegulated enum

A value indicating whether the issuing bank's card range is regulated by the Durbin Amendment due to the bank's assets. Possible values:

  • Braintree_CreditCard::DURBIN_REGULATED_YES
  • Braintree_CreditCard::DURBIN_REGULATED_NO
  • Braintree_CreditCard::DURBIN_REGULATED_UNKNOWN
expirationMonth string

The expiration month of the credit card used, formatted MM.

expirationYear string

The expiration year of the credit card used, formatted YYYY.

healthcare enum

Whether the card is a healthcare card. Possible values:

  • Braintree_CreditCard::HEALTHCARE_YES
  • Braintree_CreditCard::HEALTHCARE_NO
  • Braintree_CreditCard::HEALTHCARE_UNKNOWN
issuingBank string

The bank that issued the credit card.


The last 4 digits of the credit card number.

payroll enum

Whether the card is a payroll card. Possible values:

  • Braintree_CreditCard::PAYROLL_YES
  • Braintree_CreditCard::PAYROLL_NO
  • Braintree_CreditCard::PAYROLL_UNKNOWN
prepaid enum

Whether the card is a prepaid card. Possible values:

  • Braintree_CreditCard::PREPAID_YES
  • Braintree_CreditCard::PREPAID_NO
  • Braintree_CreditCard::PREPAID_UNKNOWN
productId string

The code for the product type of the card (e.g. D (Visa Signature Preferred), G (Visa Business)). See Product ID codes below for possible values.

token string

The Vault token for the credit card.


A randomly-generated string that uniquely identifies a credit card number in the Vault. If the same credit card is added to a merchant's Vault multiple times, each Vault entry will have the same unique identifier. This value is randomly generated by merchant gateway account, so it will be different for each merchant's Vault.


The currency of the verification amount (e.g. "USD" for US dollars). See the ISO 4217 codes.


The processing bank's response to the card verification value (CVV) provided by the customer. Possible values:

  • M = Matches
  • N = Does not match
  • U = Not verified
  • I = Not provided
  • S = Issuer does not participate
  • A = Not applicable
  • B = Bypass

This value will only be set if the transaction status is gateway_rejected. Possible values:

  • "application_incomplete"
  • "avs"
  • "avs_and_cvv"
  • "cvv"
  • "duplicate"
  • "fraud"
  • "three_d_secure"
id string

The string value representing a specific credit card verification in the Vault. Length and format of gateway-generated tokens and IDs may change at any time.

merchantAccountId string

The merchant account ID used for the credit card verification. Currency is also determined by merchant account ID.

processorResponseCode string

The processor response code. See the list of possible processor authorization responses.

processorResponseText string

The processor response text. See the list of possible processor authorization responses.

processorResponseType string

The processor response type. Possible values:

  • "approved"
  • "soft_declined"
  • "hard_declined"

See the list of possible processor authorization responses, and definitions of soft and hard declines.


Any applicable risk data associated with the verification. The data includes the risk identifier, the device data captured flag, and the risk decision, which can provide further context on how a transaction was scored by Braintree.

decision string

The risk decision. Possible values:

  • Not Evaluated
  • Approve
  • Review
  • Decline
deviceDataCaptured bool

Flag indicating whether device session data was successfully captured and processed by the fraud service. Currently available in the Python, .NET, Node and PHP client libraries.

fraudServiceProvider string

The fraud service used to determine if a transaction is likely to be fraudulent.

id string

The risk data identifier.

status string

Possible values:

  • processor_declined
  • gateway_rejected
  • failed
  • verified

Product ID codes

The Braintree gateway returns the following product IDs for credit and debit card payment methods. The product ID is generally 1-3 characters and indicates the specific credit product that was issued to the customer.

Product ID code Product name
001 Discover Consumer Credit – Rewards
002 Discover Commercial Credit
003 Discover Consumer Debit
004 Discover Commercial Debit
005 Discover Prepaid Gift
006 Discover Prepaid ID known
007 Discover Consumer Credit – Premium
008 Discover Consumer Credit - Core
009 Discover Private Label Credit
010 Discover Commercial Credit – Executive Business
011 Discover Consumer Credit – Premium Plus
012 Discover Commercial Prepaid – Non-Reloadable
013 Discover PayPal
014 Discover PayPal Mobile
A Visa Traditional
B Visa Traditional Rewards
BPD MasterCard Business Premium Debit
C Visa Signature
CIR MasterCard Cirrus
D Visa Signature Preferred
DAG Global Debit MasterCard Salary
DAP Platinum Debit MasterCard Salary
DAS Standard Debit MasterCard Salary
DLG Debit MasterCard Gold Delayed Debit
DLH Debit MasterCard World Embossed Delayed Debit
DLP Debit MasterCard Platinum Delayed Debit
DLS Debit MasterCard Card Delayed Debit
DOS Standard Debit MasterCard Social
DWF Debit MasterCard Humanitarian Prepaid
E Visa Proprietary ATM
F Visa Classic
G Visa Business
G1 Visa Signature Business
G3 Visa Business Enhanced (US only)
G4 Visa Infinite Business
G5 Visa Business Rewards
I Visa Infinite
I Visa Infinite Privilege
I2 Visa UHNW
IB American Express Non-US
IR American Express Non-US Reloadable
IS American Express Non-US Stored Value
J3 Visa Healthcare
K Visa Corporate T&E
K1 Visa GSA Corporate T&E
L Visa Electron
MAB World Elite MasterCard for Business Card
MAC MasterCard World Elite Corporate Card
MAP MasterCard Commercial Payments Account
MAQ MasterCard Prepaid Commercial Payments Account
MBB MasterCard Prepaid Consumer
MBC MasterCard Prepaid Voucher
MBD MasterCard Professional Debit BusinessCard Card
MBE MasterCard Electronic Business Card
MBF Prepaid MC Food
MBK MasterCard Black Card
MBM Prepaid MC Meal
MBP MasterCard Corporate Prepaid
MBS MasterCard B2B Product
MBT MasterCard Corporate Prepaid Travel
MBW World MasterCard Black Edition Debit
MCB MasterCard BusinessCard Card
MCC MasterCard Credit Card (mixed BIN)
MCD Debit MasterCard Card
MCE MasterCard Electronic Card
MCF MasterCard Fleet Card
MCG Gold MasterCard Card
MCH MasterCard Premium Charge
MCO MasterCard Corporate (Meeting) Card
MCP MasterCard Purchasing Card
MCS (Unembossed) Standard MasterCard Card
MCT Titanium MasterCard Card
MCV Merchant-Branded Program
MCW World MasterCard Card
MDB Debit MasterCard BusinessCard Card
MDG Gold Debit MasterCard Card
MDH World Debit Embossed MasterCard Card
MDJ Debit MasterCard (Enhanced)
MDL MasterCard Business Debit Other Embossed
MDO MasterCard Debit Other
MDP Premium Debit MasterCard Card
MDR MasterCard Debit Brokerage
MDS Debit MasterCard Card
MDT Commercial Debit MasterCard Card
MDW World Elite Debit MasterCard
MEB MasterCard Executive BusinessCard Card
MEC MasterCard Electronic Commercial
MEF MasterCard Electronic Payment Account
MEO MasterCard Corporate Executive Card
MET Titanium Debit MasterCard Card
MFB MasterCard Flex World Elite
MFD MasterCard Flex Platinum
MFE MasterCard Flex Charge World Elite
MFH MasterCard Flex World
MFL MasterCard Flex Charge Platinum
MFW MasterCard Flex World Charge
MGF MasterCard Government Commercial Card
MHA MasterCard Healthcare Prepaid Non-Tax
MHB MasterCard HSA Substantiated (Debit MasterCard)
MHD MasterCard HELOC Debit Standard
MHH MasterCard HSA Non-Substantiated (Debit MasterCard)
MHK MasterCard Magna Health Access Card
MHD MasterCard HELOC Debit Gold
MHD MasterCard HELOC Debit Platninum
MHD MasterCard HELOC Debit Premium
MIA Prepaid MasterCard Unembossed Student Card
MIK Prepaid MasterCard Electronic Student (Non-US) Card
MIL Unembossed MasterCard Student Card (Non-US)
MIP Prepaid Debit MasterCard Student Card
MIU Debit MasterCard Unembossed (Non-US)
MLA MasterCard Central Travel Solutions Air Card
MLB MasterCard Brazil Benefit for Home Improvement
MLD MasterCard Distribution Card
MLE MasterCard Brazil General Benefits
MLF MasterCard Agro Card
MLL MasterCard Central Travel Solutions Land Card
MNF MasterCard Public Sector Commercial Card
MNW MasterCard World Card
MOC Standard Maestro Social
MOG Maestro Gold Card
MOP Maestro Platinum
MOW World Maestro
MPA MasterCard Prepaid Debit Standard Payroll
MPB MasterCard Preferred Business Card
MPD MasterCard Flex Prepaid
MPF MasterCard Prepaid Debit Standard Gift
MPG Debit MasterCard Standard Prepaid General Spend
MPH MasterCard Cash
MPJ Prepaid Debit MasterCard Card Gold
MPK MasterCard Prepaid Government Commercial Card
MPL Platinum MasterCard Card
MPM MasterCard Prepaid Debit Standard Consumer Incentive
MPN MasterCard Prepaid Debit Standard Insurance
MPO MasterCard Prepaid Debit Standard Offer
MPP MasterCard Prepaid Card – Commercial Reward Funding
MPQ MasterCard Prepaid Debit Standard Government Disaster
MPR MasterCard Prepaid Debit Standard Travel
MPT MasterCard Prepaid Debit Standard Teen
MPV MasterCard Prepaid Debit Standard Government
MPW Debit MasterCard Business Card Prepaid Workplace Business
MPX MasterCard Prepaid Debit Standard Flex Benefit
MPY MasterCard Prepaid Debit Standard Employee Incentive
MPZ MasterCard Prepaid Debit Standard Government Consumer
MRB MasterCard Prepaid Electronic Business Card (Non-US)
MRC Prepaid MasterCard Electronic Card (Non-US)
MRF MasterCard European Regulated Individual Pay
MRG MasterCard Prepaid Card (Non-US)
MRH MasterCard Platinum Prepaid Travel (US)
MRJ Prepaid MasterCard Gold Card
MRK Prepaid MasterCard Public Sector Commercial Card
MRL Prepaid MasterCard Electronic Commercial Card (Non-US)
MRO MasterCard Rewards Only
MRP Standard Retailer Centric Payments
MRS Prepaid MasterCard ISIC Student Card
MRW Prepaid MasterCard Business Card (Non-US)
MSA Prepaid Maestro Payroll Card
MSB Maestro Small Business Card
MSF Prepaid Maestro Gift Card
MSG Prepaid Maestro Consumer Reloadable Card
MSI Maestro Student Card
MSJ Prepaid Maestro Gold
MSM Prepaid Maestro Consumer Promotion Card
MSN Prepaid Maestro Insurance Card
MSO Prepaid Maestro Other Card
MSQ Unknown MasterCard
MSR Prepaid Maestro Travel Card
MST Prepaid Maestro Teen Card
MSV Prepaid Maestro Government Benefit Card
MSW Prepaid Maestro Corporate (Reloadable) Card
MSX Prepaid Maestro Flex Benefit Card
MSY Prepaid Maestro Employee Incentive Card
MSZ Prepaid Maestro Emergency Assistance Card
MTP MasterCard Platinum Prepaid Travel (UK and Brazil)
MUS Prepaid Unembossed MasterCard Card
MUW MasterCard World Domestic Affluent
MWB World Elite MasterCard Business Card
MWD World Deferred MasterCard
MWE World Elite MasterCard Card
MWF MasterCard Humanitarian Prepaid
MWO World Elite MasterCard Corporate Card
MWR MasterCard World Retailer Centric Payments
N Visa Platform
N1 Visa Rewards
N2 Visa Select
OLB Maestro Small Business Delayed Debit
OLG Maestro Gold Delayed Debit
OLP Maestro Platinum Delayed Debit
OLS Maestro (Student Card) Delayed Debit
OLW World Maestro Delayed Debit
P Visa Gold
PMC MasterCard Proprietary Credit Card (Swedish domestic)
PMD MasterCard Proprietary Debit Card (Swedish domestic)
PSC MasterCard Common Proprietary Swedish Credit Card
PSD MasterCard Common Proprietary Swedish Debit Card
PVA MasterCard Private Label A
PVB MasterCard Private Label B
PVC MasterCard Private Label C
PVD MasterCard Private Label D
PVE MasterCard Private Label E
PVF MasterCard Private Label F
PVG MasterCard Private Label G
PVH MasterCard Private Label H
PVI MasterCard Private Label I
PVJ MasterCard Private Label J
PVL MasterCard Private Label L
Q Visa Private Label
Q2 Visa Private Label Basic
Q3 Visa Private Label Standard
Q4 Visa Private Label Enhanced
Q5 Visa Private Label Specialized
Q6 Visa Private Label Premium
R Visa Proprietary
RP American Express US Reloadable
S Visa Purchasing
S1 Visa Purchasing with Fleet
S2 Visa GSA Purchasing
S3 Visa GSA Purchasing with Fleet
S4 Visa Government Services Loan
S5 Visa Commercial Transport (EBT)
S6 Visa Business Loan
S7 Visa Distribution
SAG Gold MasterCard Salary Immediate Debit
SAL Standard Maestro Salary
SAP Platinum MasterCard Salary Immediate Debit
SAS Standard MasterCard Salary Immediate Debit
SOS Standard MasterCard Social Immediate Debit
SUR Prepaid Unembossed MasterCard Card (Non-US)
SV American Express US Stored Value
TBE MasterCard Electronic Business Immediate Debit
TCB MasterCard Corporate Immediate Debit
TCC MasterCard (mixed BIN) Immediate Debit
TCE MasterCard (Electronic) Student Card Immediate Debit
TCF MasterCard Fleet Card Immediate Debit
TCG Gold MasterCard Card Immediate Debit
TCO MasterCard (Corporate) Immediate Debit
TCP MasterCard Purchasing Card Immediate Debit
TCS MasterCard Standard (Unembossed) Card Immediate Debit
TCW MasterCard World Signia Immediate Debit
TEB MasterCard Executive BusinessCard Card Immediate Debit
TEC MasterCard Electronic Commercial Immediate Debit
TEO MasterCard Corporate Executive Card Immediate Debit
TNF MasterCard Public Sector Commercial Card Immediate Debit
TNW MasterCard New World Immediate Debit
TPB MasterCard Preferred Business Card Immediate Debit
TPL Platinum MasterCard Immediate Debit
TWB World MasterCard Black Edition Immediate Debit
U Visa Travel Money
V Visa V Pay
WBE World MasterCard Black Edition
X Visa B2B Virtual Payments