Returned within an error result object from the following requests:

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

Attributes
amount String

The amount used when verifying the card.

avsErrorResponseCode

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.

avsPostalCodeResponseCode

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

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.

creditCard

Credit card information associated with the verification.

bin

The first 6 digits of the credit card, known as the Bank Identification Number.

cardType

The type of the credit card. Possible values:

  • American Express
  • Carte Blanche
  • China UnionPay
  • Diners Club
  • Discover
  • 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.

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.

last4

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.

uniqueNumberIdentifier

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.

currencyIsoCode

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

cvvResponseCode

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
gatewayRejectionReason

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.

riskData

Risk data on credit card transactions. 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 Kount. Currently available in the Python, .NET, Node and PHP client libraries.

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
A Visa Traditional
B Visa Traditional Rewards
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
E Visa Proprietary ATM
F Visa Classic
G Visa Business
G1 Visa Signature Business
G3 Visa Business Enhanced (US only)
I Visa Infinite
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
MBB MasterCard Prepaid Consumer
MBC MasterCard Prepaid Voucher
MBE MasterCard Electronic Business Card
MBF Prepaid MC Food
MBK MasterCard Black Card
MBM Prepaid MC Meal
MBP MasterCard Corporate Prepaid
MBT MasterCard Corporate Prepaid Travel
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
MDW World Elite Debit MasterCard
MEB MasterCard Executive BusinessCard Card
MEC MasterCard Electronic Commercial
MEF MasterCard Electronic Payment Account
MEO MasterCard Corporate Executive 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)
MHH MasterCard HSA Non-Substantiated (Debit MasterCard)
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)
MLF MasterCard Agro Card
MNW MasterCard World Card
MOC Standard Maestro Social
MOG Maestro Gold Card
MOP Maestro Platinum
MOW World Maestro
MPA Prepaid Debit Standard Payroll
MPF MasterCard Prepaid Debit Standard Gift
MPG Debit MasterCard Standard Prepaid General Spend
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)
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
MWO World Elite MasterCard Corporate Card
MWR MasterCard World Retailer Centric Payments
N Visa Platform
N1 Visa Rewards
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 K
Q Visa Private Label
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
U Visa Travel Money
V Visa V Pay
WBE World MasterCard Black Edition

Still have questions?

If you can’t find an answer, contact our Support team.