Skip to main content

Braintree CreditCard

This page provides an overview of the payments methods provided by the Braintree CreditCard adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Braintree CreditCard within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

A payment platform that gives you access to PayPal, Venmo (in the US), credit and debit cards plus the most relevant wallets and local payment methods in a single integration.

Supported features​

Payment methods​

The table below lists the payment methods that Braintree CreditCard supports. It also includes the available processing options and the supported transaction types for each of those payment methods.

Payment MethodProcessing optionsTransaction types
Creditcard (Creditcard)Hosted fields — payment.jsDebit
Preauthorize
Incremental authorization
Capture
Void
Refund
Payout
Register
Deregister

Connector configuration​

Parameter / NameTypeRequiredDescription
publicKeystringtrueThe Braintree Public Key - to be found in the Braintree Merchant Portal
privateKeystringtrueThe Braintree Private Key - to be found in the Braintree Merchant Portal
merchantIdstringfalseThe Braintree Merchant Id - to be found in the Braintree Merchant Portal
ignoreDisputesboolfalseDetermine if incoming Disputes (part of Callback) should be handled at all.
sendDescriptionInCustomFieldstringfalseRequired if you want to add a description to your Transaction (checkout Further Config Parameter Description down below).
sendMerchantTransactionIdInCustomFieldstringfalseRequired if you want to pass a Merchant-Transaction-Id to your Transaction (checkout Further Config Parameter Description down below).
useBtDescriptorboolfalseto map additionalId1 to Braintree's descriptor.name
useAvsboolfalseto use Braintree's Address Verification Service

  • To be able to use sendDescriptionInCustomField or sendMerchantTransactionIdInCustomField, you will have to set up "Custom Fields" in the Braintree Merchant Portal (please check out the official Braintree Documentation at Custom Fields).

    Add a new Custom Field and pass the Api Name of the field in the connector configuration (e.g merchant_tx_id for sendMerchantTransactionIdInCustomField).

  • When useAvs is active, a request to Braintree's verifyCreditCard Service will be performed before charging the payment. The result of the verify call will be returned in the extraData.avs_result field. This will not affect the payment processing.

    In addition to activating that setting, you need to correctly set up the AVS options at Fraud Management in the Braintree Merchant Portal.

Mapping to Braintree CreditCard​

This segment provides a comprehensive guide to effectively integrate Braintree CreditCard into your payment procedure. It offers a detailed mapping between the fields of the gateway and corresponding fields on the Braintree CreditCard side. Furthermore, it outlines the requisite fields which must be delivered per specific payment method and transaction type.

Parameters​

Request mapping​

Gateway parameterBraintree CreditCard parameterTypeDescriptionTransaction types
transactionIndicatorinput.transaction.payment.initiator, input.options.externalVault.statusrequired stringMandatory for card on file, card on file merchant initiated, recurring (see Recurring Transactions)
additionalId1input.transaction.descriptor.nameoptional stringEffective only if the connector configuration setting useBtDescriptor is enabled.only: Debit, Preauthorize
extraData.purchaseOrderNumberinput.transaction.purchaseOrderNumberoptional stringonly: Debit, Preauthorize, Capture
extraData.shipsFromPostalCodeinput.transaction.shipping.shipsFromPostalCoderequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture
extraData.taxExemptinput.transaction.tax.taxExemptoptional booleanIf not set: falseonly: Debit, Preauthorize, Capture
l2L3Data.discountAmountinput.transaction.discountAmountrequired string
Only to get reduced interchange fees.		If not set: 0.00only: Debit, Preauthorize, Capture
l2L3Data.taxAmountinput.transaction.tax.taxAmountrequired string
Only to get reduced interchange fees.		If not set: 0.00only: Debit, Preauthorize, Capture
l2L3Data.freightAmountinput.transaction.shipping.shippingAmountrequired string
Only to get reduced interchange fees.		If not set: 0.00only: Debit, Preauthorize, Capture
items[]input.transaction.lineItems[]required string
Only to get reduced interchange fees.		At least one item is required for Level 2/Level 3 discounts. The following are the required fields for each transaction type.only: Debit, Preauthorize, Capture, Refund
items[].nameinput.transaction.lineItems[].namerequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].quantityinput.transaction.lineItems[].quantityrequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].priceinput.transaction.lineItems[].totalAmountrequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].identificationinput.transaction.lineItems[].productCoderequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].descriptioninput.transaction.lineItems[].descriptionrequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].l2l3Data.unitinput.transaction.lineItems[].unitOfMeasurerequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].l2l3Data.unitPriceinput.transaction.lineItems[].unitAmountrequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].extraData.unitTaxAmountinput.transaction.lineItems[].unitTaxAmountrequired string
Only to get reduced interchange fees.		If not set: 0.00only: Debit, Preauthorize, Capture, Refund
items[].l2l3Data.taxAmountinput.transaction.lineItems[].taxAmountrequired string
Only to get reduced interchange fees.		If not set: 0.00only: Debit, Preauthorize, Capture, Refund
items[].l2l3Data.discountinput.transaction.lineItems[].discountAmountrequired string
Only to get reduced interchange fees.		If not set: 0.00only: Debit, Preauthorize, Capture, Refund
items[].l2l3Data.commodityCodeinput.transaction.lineItems[].commodityCoderequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].extraData.urlinput.transaction.lineItems[].urlrequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize, Capture, Refund
items[].l2l3Data.typeinput.transaction.lineItems[].itemTypeoptional stringonly: Debit, Preauthorize, Capture, Refund
items[].extraData.imageUrlinput.transaction.lineItems[].imageUrloptional stringonly: Debit, Preauthorize, Capture, Refund
customer.shippingFirstNameinput.transaction.shipping.shippingAddress.firstNamerequired string
Only to get reduced interchange fees.		Customer shipping address is required for Level 2/Level 3 discounts. The following are the required fields for each transaction type.only: Debit, Preauthorize
customer.shippingLastNameinput.transaction.shipping.shippingAddress.lastNamerequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize
customer.shippingAddress1input.transaction.shipping.shippingAddress.addressLine1required string
Only to get reduced interchange fees.		only: Debit, Preauthorize
customer.shippingAddress2input.transaction.shipping.shippingAddress.addressLine2optional stringonly: Debit, Preauthorize
customer.shippingCityinput.transaction.shipping.shippingAddress.localityrequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize
customer.shippingPostcodeinput.transaction.shipping.shippingAddress.postalCoderequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize
customer.shippingStateinput.transaction.shipping.shippingAddress.adminArea1required string
Only to get reduced interchange fees.		only: Debit, Preauthorize
customer.shippingCountryinput.transaction.shipping.shippingAddress.countryCoderequired string
Only to get reduced interchange fees.		only: Debit, Preauthorize

Response mapping​

Gateway parameterBraintree CreditCard parameterTypeDescriptionTransaction types
extraData.avs_resultdata.verifyCreditCard.verification.processorResponse.avsPostalCodeResponserequired stringAVS postal code

Transaction indicators​

Gateway transaction indicatorBraintree CreditCard transaction indicator
MOTOMOTO
RECURRINGRECURRING
INITIALRECURRING_FIRST
CARDONFILE_MERCHANTUNSCHEDULED
CARDONFILEUNSCHEDULED

Error codes​

Braintree CreditCard error codes​

Gateway error codeBraintree CreditCard error codeBraintree CreditCard error message
20112000Do Not Honor
20112024Do Not Honor
20062001Insufficient Funds
20042002Limit Exceeded
20042003Limit Exceeded
20092004Card Expired
20082005Invalid Card Number
20082007Invalid Card Number
20082008Invalid Card Number
20082009Invalid Card Number
20072006Invalid Expiration Date
10022010Invalid Card CVV
10072011Authorization Required
20032012Declined
20032013Declined
20032014Declined
20032015Declined
20032017Declined
20032018Declined
20032019Declined
20032020Declined
20032021Declined
20032022Declined
20032023Declined
20032041Declined
20032044Declined
20032046Declined
20032047Declined
20032057Declined
20032066Declined
20032068Declined
20032069Declined
20032070Declined
20032071Declined
20032072Declined
20032073Declined
20032074Declined
20032075Declined
20032076Declined
20032077Declined
20032078Declined
20032079Declined
20032080Declined
20032081Declined
20032082Declined
20032083Declined
20032084Declined
20032085Declined
20032086Declined
20032087Declined
20032088Declined
20032089Declined
20032090Declined
20032091Declined
20032092Declined
20032093Declined
20032094Declined
20032095Declined
20032096Declined
20032097Declined
20032098Declined
20032099Declined
20032100Declined
20032101Declined
20032102Declined
20032103Declined
20032104Declined
30042016Duplicate Transaction
10072025Configuration Error
10072026Configuration Error
10072027Configuration Error
10072028Configuration Error
10072029Configuration Error
10072030Configuration Error
10072058Configuration Error
10022031Invalid Data
10022032Invalid Data
10022033Invalid Data
10022034Invalid Data
10022035Invalid Data
10022036Invalid Data
10022037Invalid Data
10022038Invalid Data
10022039Invalid Data
10022040Invalid Data
10022042Invalid Data
10022045Invalid Data
10022048Invalid Data
10022049Invalid Data
10022050Invalid Data
10022051Invalid Data
10022052Invalid Data
10022054Invalid Data
10022055Invalid Data
10022056Invalid Data
10022059Invalid Data
10022060Invalid Data
10022061Invalid Data
10022062Invalid Data
10022063Invalid Data
10022064Invalid Data
20162043Stolen Card
20162053Stolen Card
20092065Expired
20092067Expired
100283905Data Validation Error
100281801Data Validation Error
100281802Data Validation Error
100281804Data Validation Error
100281805Data Validation Error
100281806Data Validation Error
100281807Data Validation Error
100281813Data Validation Error
100281808Data Validation Error
100281809Data Validation Error
100281810Data Validation Error
100281811Data Validation Error
100281812Data Validation Error
100281827Data Validation Error
100281828Data Validation Error
100291803Data Validation Error
100291815Data Validation Error
100291816Data Validation Error
100291817Data Validation Error
100291814Data Validation Error
100291818Data Validation Error
100291819Data Validation Error
100291820Data Validation Error
100291821Data Validation Error
100291822Data Validation Error
100291823Data Validation Error
100291824Data Validation Error
100291825Data Validation Error
100291826Data Validation Error
100291828Data Validation Error
1002918996Data Validation Error
1002918997Data Validation Error
1002918998Data Validation Error
1002918999Data Validation Error
100282602Data Validation Error
100282603Data Validation Error
100282604Data Validation Error
100282605Data Validation Error
100282606Data Validation Error
100282607Data Validation Error
100282608Data Validation Error
100282610Data Validation Error
100282675Data Validation Error
100282676Data Validation Error
100282674Data Validation Error
100282609Data Validation Error
100282637Data Validation Error
100282611Data Validation Error
100282638Data Validation Error
100282612Data Validation Error
100282639Data Validation Error
100282613Data Validation Error
100282640Data Validation Error
100282614Data Validation Error
100282641Data Validation Error
100282615Data Validation Error
100282642Data Validation Error
100282616Data Validation Error
100282643Data Validation Error
100282627Data Validation Error
100282644Data Validation Error
100282628Data Validation Error
100282645Data Validation Error
100282631Data Validation Error
100282632Data Validation Error
100282688Data Validation Error
100282647Data Validation Error
100282633Data Validation Error
100282634Data Validation Error
100282635Data Validation Error
100282649Data Validation Error
100282650Data Validation Error
100282621Data Validation Error
100282622Data Validation Error
100282623Data Validation Error
100282624Data Validation Error
100282625Data Validation Error
100282626Data Validation Error
100282617Data Validation Error
100282657Data Validation Error
100282618Data Validation Error
100282658Data Validation Error
100282619Data Validation Error
100282659Data Validation Error
100282620Data Validation Error
100282660Data Validation Error
100282629Data Validation Error
100282661Data Validation Error
100282664Data Validation Error
100282668Data Validation Error
100282630Data Validation Error
100282662Data Validation Error
100282636Data Validation Error
100282656Data Validation Error
100282663Data Validation Error
100282666Data Validation Error
100282670Data Validation Error
100282671Data Validation Error
100282665Data Validation Error
100282667Data Validation Error
100282672Data Validation Error
100282673Data Validation Error
100282646Data Validation Error
100282677Data Validation Error
100282669Data Validation Error
100282648Data Validation Error
100282685Data Validation Error
100282686Data Validation Error
100282684Data Validation Error
100282679Data Validation Error
100282678Data Validation Error
100282681Data Validation Error
100282680Data Validation Error
100282683Data Validation Error
100282682Data Validation Error
100282687Data Validation Error
100282689Data Validation Error
100282690Data Validation Error
100282691Data Validation Error
100282692Data Validation Error
1002926996Data Validation Error
1002926997Data Validation Error
1002926998Data Validation Error
1002926999Data Validation Error
100291602Data Validation Error
100291609Data Validation Error
100291610Data Validation Error
100291611Data Validation Error
100291612Data Validation Error
100291613Data Validation Error
100291617Data Validation Error
100291618Data Validation Error
100291619Data Validation Error
100291620Data Validation Error
100291621Data Validation Error
100291622Data Validation Error
100291623Data Validation Error
100281601Data Validation Error
100281603Data Validation Error
100281604Data Validation Error
100281605Data Validation Error
100281606Data Validation Error
100281607Data Validation Error
100281608Data Validation Error
100281613Data Validation Error
100281614Data Validation Error
100281615Data Validation Error
100281616Data Validation Error
1002916996Data Validation Error
1002916997Data Validation Error
1002916998Data Validation Error
1002916999Data Validation Error
100293101Data Validation Error
100293102Data Validation Error
100293103Data Validation Error
100293104Data Validation Error
100293105Data Validation Error
100293106Data Validation Error
100293107Data Validation Error
100293108Data Validation Error
100293109Data Validation Error
100293113Data Validation Error
100293114Data Validation Error
100293115Data Validation Error
100293116Data Validation Error
100293117Data Validation Error
100293118Data Validation Error
100293119Data Validation Error
100293120Data Validation Error
100293121Data Validation Error
100293122Data Validation Error
100293125Data Validation Error
1002931996Data Validation Error
1002931997Data Validation Error
1002931998Data Validation Error
1002931999Data Validation Error
100283501Data Validation Error
100283502Data Validation Error
100293503Data Validation Error
100293504Data Validation Error
100293505Data Validation Error
100293506Data Validation Error
100283518Data Validation Error
100293507Data Validation Error
100293508Data Validation Error
100293509Data Validation Error
100293510Data Validation Error
100293511Data Validation Error
100283512Data Validation Error
100293513Data Validation Error
100293514Data Validation Error
100293517Data Validation Error
100293519Data Validation Error
100283520Data Validation Error
100293521Data Validation Error
100293522Data Validation Error
100293523Data Validation Error
100293524Data Validation Error
100293525Data Validation Error
100293526Data Validation Error
100283527Data Validation Error
1002935996Data Validation Error
1002935997Data Validation Error
1002935998Data Validation Error
1002935999Data Validation Error
100291701Data Validation Error
100291702Data Validation Error
100291704Data Validation Error
100291705Data Validation Error
100291708Data Validation Error
100291718Data Validation Error
100291719Data Validation Error
100291720Data Validation Error
100291721Data Validation Error
100291722Data Validation Error
100291744Data Validation Error
100281723Data Validation Error
100281703Data Validation Error
100281718Data Validation Error
100281706Data Validation Error
100281707Data Validation Error
100281709Data Validation Error
100281710Data Validation Error
100281711Data Validation Error
100281712Data Validation Error
100281713Data Validation Error
100281714Data Validation Error
100281715Data Validation Error
100281716Data Validation Error
100281717Data Validation Error
100291723Data Validation Error
100281724Data Validation Error
100281725Data Validation Error
100291726Data Validation Error
100291727Data Validation Error
100291728Data Validation Error
100291729Data Validation Error
100291730Data Validation Error
100291731Data Validation Error
100291732Data Validation Error
100291733Data Validation Error
100291734Data Validation Error
100291735Data Validation Error
100291738Data Validation Error
100291742Data Validation Error
100291743Data Validation Error
100281736Data Validation Error
100281737Data Validation Error
100291739Data Validation Error
100291740Data Validation Error
100291741Data Validation Error
100291745Data Validation Error
100281750Data Validation Error
100291752Data Validation Error
100291755Data Validation Error
100291756Data Validation Error
100291759Data Validation Error
100291761Data Validation Error
1002917996Data Validation Error
1002917997Data Validation Error
1002917998Data Validation Error
1002917999Data Validation Error
100282901Data Validation Error
100282902Data Validation Error
100282903Data Validation Error
100282904Data Validation Error
100282905Data Validation Error
100292906Data Validation Error
100292907Data Validation Error
100292908Data Validation Error
100292909Data Validation Error
100292910Data Validation Error
100292911Data Validation Error
100292912Data Validation Error
100292913Data Validation Error
100292914Data Validation Error
100292915Data Validation Error
100292916Data Validation Error
100292917Data Validation Error
100292918Data Validation Error
100292919Data Validation Error
100292920Data Validation Error
100292921Data Validation Error
100292922Data Validation Error
100292923Data Validation Error
100292924Data Validation Error
100292925Data Validation Error
100292926Data Validation Error
100292927Data Validation Error
100292928Data Validation Error
100292929Data Validation Error
100292930Data Validation Error
1002929996Data Validation Error
1002929997Data Validation Error
1002929998Data Validation Error
1002929999Data Validation Error
100284101Data Validation Error
100284102Data Validation Error
100284103Data Validation Error
100284104Data Validation Error
100284105Data Validation Error
100284106Data Validation Error
1002941996Data Validation Error
1002941997Data Validation Error
1002941998Data Validation Error
1002941999Data Validation Error
100292001Data Validation Error
100292002Data Validation Error
100292003Data Validation Error
100292004Data Validation Error
100292005Data Validation Error
100292006Data Validation Error
100292010Data Validation Error
100292011Data Validation Error
100292012Data Validation Error
100292013Data Validation Error
100292014Data Validation Error
100292015Data Validation Error
100292016Data Validation Error
100292017Data Validation Error
100292018Data Validation Error
100292019Data Validation Error
100292020Data Validation Error
100292021Data Validation Error
100292022Data Validation Error
100292023Data Validation Error
100292024Data Validation Error
100292025Data Validation Error
1002920996Data Validation Error
1002920997Data Validation Error
1002920998Data Validation Error
1002920999Data Validation Error
100282301Data Validation Error
100282302Data Validation Error
100282303Data Validation Error
1002923996Data Validation Error
1002923997Data Validation Error
1002923998Data Validation Error
1002923999Data Validation Error
100281501Data Validation Error
100281502Data Validation Error
100281503Data Validation Error
100281528Data Validation Error
100281509Data Validation Error
100291517Data Validation Error
100281527Data Validation Error
100291501Data Validation Error
100291504Data Validation Error
100291505Data Validation Error
100291506Data Validation Error
100291507Data Validation Error
100291508Data Validation Error
100291526Data Validation Error
100291510Data Validation Error
100291511Data Validation Error
100291512Data Validation Error
100291513Data Validation Error
100291514Data Validation Error
100291515Data Validation Error
100291516Data Validation Error
100291527Data Validation Error
100291518Data Validation Error
100291519Data Validation Error
100291521Data Validation Error
100291533Data Validation Error
100291538Data Validation Error
100291522Data Validation Error
100291529Data Validation Error
100291528Data Validation Error
100291523Data Validation Error
100291524Data Validation Error
100291525Data Validation Error
100291531Data Validation Error
100291547Data Validation Error
100281531Data Validation Error
100281534Data Validation Error
100281535Data Validation Error
100281536Data Validation Error
100281571Data Validation Error
100291537Data Validation Error
100291539Data Validation Error
100291540Data Validation Error
100291541Data Validation Error
100291542Data Validation Error
100291543Data Validation Error
100291544Data Validation Error
100291545Data Validation Error
100291546Data Validation Error
100291548Data Validation Error
100281520Data Validation Error
100291549Data Validation Error
100291550Data Validation Error
100291551Data Validation Error
100291552Data Validation Error
100291553Data Validation Error
100291554Data Validation Error
100291555Data Validation Error
100291556Data Validation Error
100291557Data Validation Error
100291558Data Validation Error
100291559Data Validation Error
100291560Data Validation Error
100291561Data Validation Error
100291562Data Validation Error
100291563Data Validation Error
100291564Data Validation Error
100291565Data Validation Error
100291567Data Validation Error
100291568Data Validation Error
100291569Data Validation Error
100291572Data Validation Error
100291575Data Validation Error
100291576Data Validation Error
100291577Data Validation Error
100291570Data Validation Error
100291573Data Validation Error
100291574Data Validation Error
100291578Data Validation Error
100291580Data Validation Error
100291581Data Validation Error
100291582Data Validation Error
100291583Data Validation Error
100291584Data Validation Error
100291585Data Validation Error
100291586Data Validation Error
100291587Data Validation Error
100291588Data Validation Error
100291589Data Validation Error
100291590Data Validation Error
100291591Data Validation Error
100291592Data Validation Error
100291593Data Validation Error
100291594Data Validation Error
100291595Data Validation Error
100291597Data Validation Error
100291598Data Validation Error
100291599Data Validation Error
100291596Data Validation Error
1002915100Data Validation Error
1002915103Data Validation Error
1002915101Data Validation Error
1002915102Data Validation Error
1002915104Data Validation Error
1002915105Data Validation Error
1002915106Data Validation Error
1002915152Data Validation Error
1002915153Data Validation Error
1002915154Data Validation Error
1002915155Data Validation Error
1002915107Data Validation Error
1002915108Data Validation Error
1002915109Data Validation Error
1002915110Data Validation Error
1002915111Data Validation Error
1002915112Data Validation Error
1002915113Data Validation Error
1002915114Data Validation Error
1002915116Data Validation Error
1002915119Data Validation Error
1002915131Data Validation Error
1002915156Data Validation Error
1002915133Data Validation Error
1002915134Data Validation Error
1002915135Data Validation Error
1002915136Data Validation Error
1002915137Data Validation Error
1002815141Data Validation Error
1002815142Data Validation Error
1002915143Data Validation Error
1002915144Data Validation Error
1002915157Data Validation Error
1002915158Data Validation Error
1002915145Data Validation Error
1002915159Data Validation Error
1002915160Data Validation Error
1002915161Data Validation Error
1002915162Data Validation Error
1002915163Data Validation Error
1002915164Data Validation Error
1002915165Data Validation Error
1002915166Data Validation Error
1002915167Data Validation Error
100291502Data Validation Error
1002915147Data Validation Error
1002915148Data Validation Error
1002915149Data Validation Error
1002915150Data Validation Error
1002915151Data Validation Error
1002915168Data Validation Error
1002915169Data Validation Error
1002915170Data Validation Error
1002915171Data Validation Error
1002915172Data Validation Error
1002915173Data Validation Error
1002915174Data Validation Error
1002915175Data Validation Error
1002915176Data Validation Error
1002915177Data Validation Error
1002915179Data Validation Error
1002915180Data Validation Error
1002915181Data Validation Error
1002915183Data Validation Error
1002915195Data Validation Error
1002915189Data Validation Error
1002915190Data Validation Error
1002915191Data Validation Error
1002915192Data Validation Error
1002815193Data Validation Error
1002915200Data Validation Error
1002915201Data Validation Error
1002915205Data Validation Error
1002915207Data Validation Error
1002915208Data Validation Error
1002915209Data Validation Error
1002915210Data Validation Error
1002915211Data Validation Error
1002915212Data Validation Error
1002915215Data Validation Error
1002915216Data Validation Error
1002915217Data Validation Error
1002915218Data Validation Error
1002915219Data Validation Error
1002915220Data Validation Error
1002915221Data Validation Error
1002915222Data Validation Error
1002915223Data Validation Error
1002915224Data Validation Error
1002815224Data Validation Error
1002915225Data Validation Error
1002915226Data Validation Error
1002915227Data Validation Error
1002915228Data Validation Error
1002915229Data Validation Error
1002915996Data Validation Error
1002915997Data Validation Error
1002915998Data Validation Error
1002915999Data Validation Error
100295601Data Validation Error
100295602Data Validation Error
100295603Data Validation Error
100295604Data Validation Error
100295605Data Validation Error
100295606Data Validation Error
100295607Data Validation Error
100295608Data Validation Error
1002956996Data Validation Error
1002956997Data Validation Error
1002956998Data Validation Error
1002956999Data Validation Error
100292201Data Validation Error
100292202Data Validation Error
1002312555Data Validation Error
100292203Data Validation Error
100292204Data Validation Error
100292205Data Validation Error
100292206Data Validation Error
1002922996Data Validation Error
1002922997Data Validation Error
1002922998Data Validation Error
1002922999Data Validation Error
100295801Data Validation Error
100295803Data Validation Error
100295804Data Validation Error
100295805Data Validation Error
100295806Data Validation Error
100295807Data Validation Error
100295808Data Validation Error
100295809Data Validation Error
100295810Data Validation Error
100295811Data Validation Error
100295812Data Validation Error
100295813Data Validation Error
100295814Data Validation Error
100295815Data Validation Error
100295816Data Validation Error
100295817Data Validation Error
100295818Data Validation Error
100295819Data Validation Error
100295820Data Validation Error
100295821Data Validation Error
100295822Data Validation Error
100295823Data Validation Error
100295824Data Validation Error
100295825Data Validation Error
100295826Data Validation Error
100295827Data Validation Error
100295828Data Validation Error
100295829Data Validation Error
1002958996Data Validation Error
1002958997Data Validation Error
1002958998Data Validation Error
1002958999Data Validation Error
100294201Data Validation Error
100294202Data Validation Error
100294203Data Validation Error
100294204Data Validation Error
100294205Data Validation Error
100294206Data Validation Error
100294207Data Validation Error
100294208Data Validation Error
1002942196Data Validation Error
1002942197Data Validation Error
1002942198Data Validation Error
1002942199Data Validation Error
1002942200Data Validation Error
1002942201Data Validation Error
1002942113Data Validation Error
1002942114Data Validation Error
1002942116Data Validation Error
1002942117Data Validation Error
1002942119Data Validation Error
1002942120Data Validation Error
1002942121Data Validation Error
1002942122Data Validation Error
1002942131Data Validation Error
100284271Data Validation Error
100294268Data Validation Error
100294270Data Validation Error
100294285Data Validation Error
1002942169Data Validation Error
100294284Data Validation Error
1002942996Data Validation Error
1002942997Data Validation Error
1002942998Data Validation Error
1002942999Data Validation Error
100296101Data Validation Error
100296102Data Validation Error
100296103Data Validation Error
100296104Data Validation Error
100296105Data Validation Error
100296106Data Validation Error
1002961996Data Validation Error
1002961997Data Validation Error
1002961998Data Validation Error
1002961999Data Validation Error
100292801Data Validation Error
100292802Data Validation Error
100292803Data Validation Error
100292804Data Validation Error
100292806Data Validation Error
1002928996Data Validation Error
1002928997Data Validation Error
1002928998Data Validation Error
1002928999Data Validation Error
100295701Data Validation Error
100295702Data Validation Error
100295703Data Validation Error
100295704Data Validation Error
100295705Data Validation Error
100295706Data Validation Error
100295707Data Validation Error
100295708Data Validation Error
100295709Data Validation Error
100295710Data Validation Error
100295711Data Validation Error
100295712Data Validation Error
100295713Data Validation Error
100295714Data Validation Error
100295715Data Validation Error
100295716Data Validation Error
100295717Data Validation Error
100295720Data Validation Error
100295721Data Validation Error
100295722Data Validation Error
100295723Data Validation Error
100295724Data Validation Error
100295725Data Validation Error
100295726Data Validation Error
100295727Data Validation Error
1002957996Data Validation Error
1002957997Data Validation Error
1002957998Data Validation Error
1002957999Data Validation Error
100293401Data Validation Error
100293402Data Validation Error
100293403Data Validation Error
100293404Data Validation Error
100293405Data Validation Error
100293406Data Validation Error
100293407Data Validation Error
100293408Data Validation Error
100293409Data Validation Error
100293410Data Validation Error
100293411Data Validation Error
100293412Data Validation Error
100293413Data Validation Error
100293414Data Validation Error
100293415Data Validation Error
100293416Data Validation Error
100293417Data Validation Error
100293418Data Validation Error
100293419Data Validation Error
100293420Data Validation Error
100293421Data Validation Error
100293422Data Validation Error
100293423Data Validation Error
100293424Data Validation Error
100293425Data Validation Error
100293426Data Validation Error
100293427Data Validation Error
100293428Data Validation Error
100293429Data Validation Error
100293430Data Validation Error
100293431Data Validation Error
100293432Data Validation Error
1002934996Data Validation Error
1002934997Data Validation Error
1002934998Data Validation Error
1002934999Data Validation Error
100281901Data Validation Error
100281902Data Validation Error
100281903Data Validation Error
100281904Data Validation Error
100281905Data Validation Error
100281906Data Validation Error
100281907Data Validation Error
100281908Data Validation Error
100281909Data Validation Error
100281910Data Validation Error
100281923Data Validation Error
100291901Data Validation Error
100291902Data Validation Error
100291903Data Validation Error
100291904Data Validation Error
100291905Data Validation Error
100291906Data Validation Error
100291907Data Validation Error
100291908Data Validation Error
100291909Data Validation Error
100291911Data Validation Error
100291912Data Validation Error
100291913Data Validation Error
100291914Data Validation Error
100291915Data Validation Error
100291916Data Validation Error
100291917Data Validation Error
100291918Data Validation Error
100291919Data Validation Error
100291920Data Validation Error
100291921Data Validation Error
100291922Data Validation Error
100291923Data Validation Error
100291924Data Validation Error
100291925Data Validation Error
100291926Data Validation Error
100291927Data Validation Error
100291928Data Validation Error
100291929Data Validation Error
100291930Data Validation Error
100291931Data Validation Error
100291932Data Validation Error
1002919996Data Validation Error
1002919997Data Validation Error
1002919998Data Validation Error
1002919999Data Validation Error
100293801Data Validation Error
100293802Data Validation Error
100293803Data Validation Error
100293804Data Validation Error
100293805Data Validation Error
1002938996Data Validation Error
1002938997Data Validation Error
1002938998Data Validation Error
1002938999Data Validation Error
100294501Data Validation Error
100294502Data Validation Error
100294503Data Validation Error
100294504Data Validation Error
100294505Data Validation Error
100294506Data Validation Error
100294507Data Validation Error
100294508Data Validation Error
100294509Data Validation Error
100294510Data Validation Error
100294511Data Validation Error
100294512Data Validation Error
100294513Data Validation Error
100294514Data Validation Error
100294515Data Validation Error
100294516Data Validation Error
100294517Data Validation Error
100294518Data Validation Error
100294519Data Validation Error
100294520Data Validation Error
100294521Data Validation Error
100294522Data Validation Error
100294523Data Validation Error
100294524Data Validation Error
100294525Data Validation Error
100294526Data Validation Error
100294527Data Validation Error
100294528Data Validation Error
100294529Data Validation Error
100294530Data Validation Error
100294531Data Validation Error
100294532Data Validation Error
100294533Data Validation Error
100294534Data Validation Error
100294535Data Validation Error
100294536Data Validation Error
100294537Data Validation Error
100294538Data Validation Error
100294539Data Validation Error
100294540Data Validation Error
100294541Data Validation Error
100294542Data Validation Error
100294543Data Validation Error
100294544Data Validation Error
100294545Data Validation Error
100294546Data Validation Error
100294547Data Validation Error
100294548Data Validation Error
100294549Data Validation Error
100294550Data Validation Error
100294551Data Validation Error
100294552Data Validation Error
100294553Data Validation Error
100294554Data Validation Error
100294555Data Validation Error
100294556Data Validation Error
100294557Data Validation Error
100294558Data Validation Error
1002201901Data Validation Error
100294559Data Validation Error
100294560Data Validation Error
100294561Data Validation Error
100294562Data Validation Error
100294563Data Validation Error
100294564Data Validation Error
100294565Data Validation Error
100294566Data Validation Error
100294567Data Validation Error
100294568Data Validation Error
100294569Data Validation Error
100294570Data Validation Error
100294571Data Validation Error
100294572Data Validation Error
100294573Data Validation Error
100294574Data Validation Error
100294575Data Validation Error
100294576Data Validation Error
100294578Data Validation Error
100294579Data Validation Error
100294581Data Validation Error
100294582Data Validation Error
100294584Data Validation Error
100294586Data Validation Error
100294587Data Validation Error
100294588Data Validation Error
100294589Data Validation Error
100294590Data Validation Error
100294591Data Validation Error
100294592Data Validation Error
100294598Data Validation Error
100294599Data Validation Error
1002945100Data Validation Error
1002945101Data Validation Error
1002945102Data Validation Error
1002945103Data Validation Error
1002945104Data Validation Error
1002945105Data Validation Error
1002945106Data Validation Error
1002945107Data Validation Error
1002945108Data Validation Error
1002945996Data Validation Error
1002945997Data Validation Error
1002945998Data Validation Error
1002945999Data Validation Error
1002VALIDATIONData Validation Error
9999*UnknownError

Braintree CreditCard processor response legacy codes​

Gateway error codeBraintree CreditCard processor codeBraintree CreditCard error message
20032109–2999Processor Declined
20032000Do Not Honor
20062001Insufficient Funds
20042002Limit Exceeded
20042003Cardholder's Activity Limit Exceeded
20092004Expired Card
20082005Invalid Credit Card Number
20072006Invalid Expiration Date
20032007No Account
20082008Card Account Length Error
20112009No Such Issuer
20032010Card Issuer Declined CVV
20032011Voice Authorization Required
20152012Processor Declined – Possible Lost Card
20162013Processor Declined – Possible Stolen Card
20102014Processor Declined – Fraud Suspected
20032015Transaction Not Allowed
10032016Duplicate Transaction
10032017Cardholder Stopped Billing
10032018Cardholder Stopped All Billing
10032019Invalid Transaction
20032020Violation
20032021Security Violation
20032022Declined – Updated Cardholder Available
10032023Processor Does Not Support This Feature
20112024Card Type Not Enabled
10032025Set Up Error – Merchant
10032026Invalid Merchant ID
10032027Set Up Error – Amount
10032028Set Up Error – Hierarchy
10032029Set Up Error – Card
10032030Set Up Error – Terminal
10032031Encryption Error
10032032Surcharge Not Permitted
10032033Inconsistent Data
10032034No Action Taken
10032035Partial Approval For Amount In Group III Version
10032036Authorization could not be found
10032037Already Reversed
20032038Processor Declined
10032039Invalid Authorization Code
10032040Invalid Store
20032041Declined – Call For Approval
10032042Invalid Client ID
20032043Error – Do Not Retry, Call Issuer
20032044Declined – Call Issuer
10032045Invalid Merchant Number
20032046Declined
99992047Call Issuer. Pick Up Card
10032048Invalid Amount
10032049Invalid SKU Number
10032050Invalid Credit Plan
10032051Credit Card Number does not match method of payment
10032052Invalid level III Purchase
20162053Card reported as lost or stolen
10032054Reversal amount does not match authorization amount
10032055Invalid Transaction Division Number
10032056Transaction amount exceeds the transaction division limit
20032057Issuer or Cardholder has put a restriction on the card
99992058Merchant not Mastercard SecureCode enabled
10032059Address Verification Failed
20032060Address Verification and Card Security Code Failed
10032061Invalid Transaction Data
10032062Invalid Tax Amount
10032063PayPal Business Account preference resulted in the transaction failing
10032064Invalid Currency Code
10032065Refund Time Limit Exceeded
10032066PayPal Business Account Restricted
10032067Authorization Expired
10032068PayPal Business Account Locked or Closed
10032069PayPal Blocking Duplicate Order IDs
10032070PayPal Buyer Revoked Pre-Approved Payment Authorization
10032071PayPal Payee Account Invalid Or Does Not Have a Confirmed Email
10032072PayPal Payee Email Incorrectly Formatted
10032073PayPal Validation Error
20032074Funding Instrument In The PayPal Account Was Declined By The Processor Or Bank, Or It Can\
10032075Payer Account Is Locked Or Closed
10032076Payer Cannot Pay For This Transaction With PayPal
20132077Transaction Refused Due To PayPal Risk Model
10032078Invalid Secure Payment Data
10072079PayPal Merchant Account Configuration Error
10072080Invalid user credentials
10032081PayPal pending payments are not supported
10032082PayPal Domestic Transaction Required
10032083PayPal Phone Number Required
10032084PayPal Tax Info Required
10032085PayPal Payee Blocked Transaction
20042086PayPal Transaction Limit Exceeded
10032087PayPal reference transactions not enabled for your account
10072088Currency not enabled for your PayPal seller account
10032089PayPal payee email permission denied for this request
10032090PayPal or Venmo account not configured to refund more than settled amount
10072091Currency of this transaction must match currency of your PayPal account
10032092No Data Found - Try Another Verification Method
10032093PayPal payment method is invalid
10032094PayPal payment has already been completed
10032095PayPal refund is not allowed after partial refund
10032096PayPal buyer account can't be the same as the seller account
20042097PayPal authorization amount limit exceeded
20042098PayPal authorization count limit exceeded
99992099Cardholder Authentication Required
10072100PayPal channel initiated billing not enabled for your account
99992101Additional authorization required
20032102Incorrect PIN
20032103PIN try exceeded
20032104Offline Issuer Declined
10032105Cannot Authorize at this time (Life cycle)
20032106Cannot Authorize at this time (Policy)
20082107Card Not Activated
20082108Closed Card
10083000Processor Network Unavailable – Try Again
2003*Declined

Testing​

While operating the Braintree CreditCard adapter in test mode, the following credit-card numbers can be used to examine various outcomes:

NumberExpiryResult
378282246310005Valid American Express
371449635398431Valid American Express
36259600000004Valid Diners Club
6011000991300009Valid Discover
3530111333300000Valid JCB
6304000000000000Valid Maestro
5555555555554444Valid Mastercard
2223000048400011Valid Mastercard
4111111111111111Valid Visa
4005519200000004Valid Visa
4009348888881881Valid Visa
4012000033330026Valid Visa
4012000077777777Valid Visa
4012888888881881Valid Visa
4217651111111119Valid Visa
4500600000000061Valid Visa
4000111111111115Unsuccessful verification — Visa — processor declined
5105105105105100Unsuccessful verification — Mastercard — processor declined
378734493671000Unsuccessful verification — American Express — processor declined
6011000990139424Unsuccessful verification — Discover — processor declined
38520000009814Unsuccessful verification — Diners Club — processor declined
3566002020360505Unsuccessful verification — JCB — failed (3000)
4500600000000061Type indicator: prepaid = "Yes"
4009040000000009Type indicator: commercial = "Yes"
4005519200000004Type indicator: Durbin regulated = "Yes"
4012000033330026Type indicator: healthcare = "Yes"
4012000033330125Type indicator: debit = "Yes"
4012000033330224Type indicator: payroll = "Yes"
4012000033330422Type indicator: all values = "No"
4012000033330323Type indicator: all values = "Unknown"
4012000033330620Other information: country of issuance = "USA"
4012000033330729Other information: country of issuance = "CAN"
4023490000000008Other information: country of issuance = "IRL"
4444333322221111Other information: country of issuance = "GBR"
5555444433331111Other information: country of issuance = "GBR"
374512431123241Other information: country of issuance = "GBR"
375529658790105Other information: country of issuance = "IRL"
5101108206957373Other information: country of issuance = "IRL"
4012000033330521Other information: issuing bank = "NETWORK ONLY"
4000000000001000Current year + 3 - 01Successful No-Challenge Authentication — Visa
5200000000001005Current year + 3 - 01Successful No-Challenge Authentication — Mastercard
340000000001007Current year + 3 - 01Successful No-Challenge Authentication — Amex
6277800000002390Current year + 3 - 01Successful No-Challenge Authentication — ELO
4000000000001018Current year + 3 - 01Failed No-Challenge Authentication — Visa
5200000000001013Current year + 3 - 01Failed No-Challenge Authentication — Mastercard
340000000001015Current year + 3 - 01Failed No-Challenge Authentication — Amex
6277800000002457Current year + 3 - 01Failed No-Challenge Authentication — ELO
4000000000001034Current year + 3 - 01Unavailable No-Challenge Authentication from the Issuer — Visa
5200000000001039Current year + 3 - 01Unavailable No-Challenge Authentication from the Issuer — Mastercard
340000000001031Current year + 3 - 01Unavailable No-Challenge Authentication from the Issuer — Amex
6277800000002309Current year + 3 - 01Unavailable No-Challenge Authentication from the Issuer — ELO
4000000000001042Current year + 3 - 01Rejected No-Challenge Authentication by the Issuer — Visa
5200000000001047Current year + 3 - 01Rejected No-Challenge Authentication by the Issuer — Mastercard
340000000001049Current year + 3 - 01Rejected No-Challenge Authentication by the Issuer — Amex
6277800000002044Current year + 3 - 01Rejected No-Challenge Authentication by the Issuer — ELO
4000000000001059Current year + 3 - 01Authentication Not Available on Lookup — Visa
5200000000001054Current year + 3 - 01Authentication Not Available on Lookup — Mastercard
340000000001056Current year + 3 - 01Authentication Not Available on Lookup — Amex
6277800000002135Current year + 3 - 01Authentication Not Available on Lookup — ELO
4000000000001067Current year + 3 - 01Error on Lookup — Visa
5200000000001062Current year + 3 - 01Error on Lookup — Mastercard
340000000001064Current year + 3 - 01Error on Lookup — Amex
6277800000002655Current year + 3 - 01Error on Lookup — ELO
4000000000001075Current year + 3 - 01Timeout on Lookup — Visa
5200000000001070Current year + 3 - 01Timeout on Lookup — Mastercard
340000000001072Current year + 3 - 01Timeout on Lookup — Amex
6277800000002820Current year + 3 - 01Timeout on Lookup — ELO
4000000000001083Current year + 3 - 01Bypassed Authentication — Visa
5200000000001088Current year + 3 - 01Bypassed Authentication — Mastercard
340000000001080Current year + 3 - 01Bypassed Authentication — Amex
6277800000002945Current year + 3 - 01Bypassed Authentication — ELO
4000000000001091Current year + 3 - 01Successful Challenge Authentication — Visa
5200000000001096Current year + 3 - 01Successful Challenge Authentication — Mastercard
340000000001098Current year + 3 - 01Successful Challenge Authentication — Amex
6277800000002325Current year + 3 - 01Successful Challenge Authentication — ELO
4000000000001109Current year + 3 - 01Failed Challenge Authentication — Visa
5200000000001104Current year + 3 - 01Failed Challenge Authentication — Mastercard
340000000001106Current year + 3 - 01Failed Challenge Authentication — Amex
6277800000002127Current year + 3 - 01Failed Challenge Authentication — ELO
4000000000001117Current year + 3 - 01Challenge Authentication is Unavailable — Visa
5200000000001112Current year + 3 - 01Challenge Authentication is Unavailable — Mastercard
340000000001114Current year + 3 - 01Challenge Authentication is Unavailable — Amex
6277800000002887Current year + 3 - 01Challenge Authentication is Unavailable — ELO
4000000000001125Current year + 3 - 01Error on Authentication — Visa
5200000000001120Current year + 3 - 01Error on Authentication — Mastercard
340000000001122Current year + 3 - 01Error on Authentication — Amex
6277800000002507Current year + 3 - 01Error on Authentication — ELO
5119737947565580Current year + 3 - 01Data Only Successful

Miscellaneous​

GooglePay via Braintree CreditCard currently only works with 3DS_CRYPTOGRAM tokens (via mobile phone application) and not with PAN_ONLY (via web).

For further information on how to process ApplePay and GooglePay see our docs at GooglePay and ApplePay.

Last updated on