Skip to main content
This page provides a comprehensive reference of Core API error codes. You can use this information to diagnose failed transactions and fine-tune your exception-handling capabilities. DiVA API error codes are listed separately. Error codes are based on HTTP response codes: the first three digits specify the HTTP response code, and the last three digits represent the error.
NoteIn contrast to an error code, a transaction response code is a value that is returned by a payment gateway or card issuer to indicate the result of a transaction. This code indicates whether the transaction was approved or declined, as well as why it was declined, if applicable.See the full list of supported transaction response codes in the Transactions guide.

​
HTTP response codes

The Core API uses standard HTTP response codes to indicate the status of requests:
  • Codes in the 2xx range typically indicate success.
  • Codes in the 4xx range typically indicate an error in the request.
  • Codes in the 5xx range typically indicate an error at the Marqeta platform.
The following table shows some common response codes:
Response CodeDescription
200 OKYour request completed successfully.
201 CreatedResource created successfully.
204 No ContentReturned on a successful DELETE.
401 UnauthorizedEnter valid credentials to continue.
403 ForbiddenAccess to the requested resource is denied.
405 Method Not AllowedThe method you supplied is not allowed for that resource, for example a PUT method on a read-only resource.
413 Request Entity Too LargeThe request body is too large or the GET request count parameter is too large.
422 Velocity rules violation or non-sufficient fundsUnprocessable entity.
500 Internal Server ErrorAn error occurred that could not be handled by the application.
502 Bad GatewayAn invalid response was received by the server.
503 Service UnavailableThe server is temporarily unable to handle this request.
504 Gateway TimeoutThe server timed out while attempting to complete this request.
If a POST or PUT request causes a validation failure, the Marqeta platform returns a response code of 400 and a body containing details about the exception. For example, a request to associate a card with a non-existent card product returns the following response body: 
{
   "bad request": "Card product not found."
}

​
400001–400099 error codes

Error CodeError Message
400001Invalid input(s) detected: <x>, <y>, <z>.
400002Birth date cannot be a future date.
400003Start date cannot be greater than or equal to end date.
400004One or more invalid field(s) have been detected: <x>, <y>, <z>.
400005An invalid currency code has been detected.
400006Amount must be greater than or equal to 0.
400007There is nothing to update. All fields are null.
400008Missing a required field.
400009Issuer not found.
400010Cardholder not found.
400011Store not found.
400012Merchant not found.
400013Card not found.
400014Order not found.
400015Campaign not found.
400016Card product not found.
400017Funding account not found.
400018Program account not found.
400019Fee not found.
400020Offer not found.
400021Rule not found.
400022Authentication user not found.
400023Reward program token not found or is not active.
400024Reward token not found.
400025Auth control not found.
400026User token is invalid.
400027Velocity control not found.
400028Auto reload not found.
400029Unknown error.
400030MCC group not found.
400031Invalid cardholder.
400032Invalid address.
400033Offer already exists.
400034One or more fields have invalid lengths.
400035Maximum number of children.
400036General input exception: <x>.
400037Malformed JSON request received: <x>.
400038General gateway exception: <x>.
400039Deposit account not found.
400040Direct deposit not found.
400041Card product not found or not active.
400042Invalid sort field passed.
400043Invalid date format received.
400044Invalid start date format received.
400045Invalid end date format received.
400046Chargeback not found.
400047Cardholder does not have full SSN.
400048Request object cannot be empty.
400049Digital wallet token not found.
400050A cardholder with the same token already exists.
400051Parent not found.
400052Cardholder is not active.
400053Password mismatch.
400054Password has already been used.
400055Existing and new password cannot be the same.
400056Cardholder does not have an email.
400057Cardholder with the same email already exists.
400058Invalid birth date format received.
400059Invalid passport expiration date format received.
400060Invalid ID card expiration date format received.
400061User token cannot start with reserved keyword.
400062Cardholder may not use a business parent’s funding account.
400063Children of a user cardholder may not have children.
400064The child of a user cardholder that is the child of a business must use parent account.
400065User with a user child and a business parent must not use parent account.
400066Metadata key exceeded size limit of 255 characters.
400067Metadata value exceeded size limit of 255 characters.
400068Metadata key/value pair exceeded 20.
400069User with a user child and a business parent must not use parent account.
400070Updating user parent is not allowed as user uses parent account.
400071Uses parent account cannot be set to true without setting a parent cardholder.
400072Uses parent account cannot be unset.
400073Invalid metadata key detected.
400074Max card orders per day limit reached.
400075Card already exists.
400076Either the phone number or last four of SSN is required.
400077Birth date does not match with our records.
400078SSN missing on record.
400079Invalid SSN detected.
400080Phone number entered does not match the record.
400081Last four of SSN does not match the record.
400082User token, phone and date of birth must be presented.
400083Phone number or date of birth does not match the record.
400084No active card found for user.
400085cvv_number does not match.
400086Expiration does not match.
400087A card with the same merchant token already exists in the system.
400088Merchant card not found.
400089Cannot move an active card to a new cardholder.
400090The card is already in terminated state.
400091Only an unactivated or suspended card can be activated.
400092Only an activated card can be suspended.
400093Cannot unactivate a card.
400094Last four of PAN is required.
400095Invalid card transition state.
400096Card token cannot start with reserved keyword.
400097Unable to generate card verification value.
400098Bulk card order must be unprocessed.
400099Card product must equal bulk card order card product.

​
400100–400199 error codes

Error CodeError Message
400100A merchant with the same token already exists.
400101A store with the same MID already exists.
400102A store with the same token already exists.
400103User cannot have multiple SSN identification types.
400104Invalid expiration date format.
400105Identifications contains duplicate identification types.
400106Business cannot have multiple tax identification types.
400107Expiration date not allowed for identification type(s).
400108User cannot have business identification type.
400109Business cannot have user identification type.
400110Birth year cannot be before YYYY.
400111Proprietor cannot have business identification type.
400112Proprietor cannot have multiple SSN identification types.
400113Start date is less than acceptable limit: <x>
400114Chip fallback to magstripe not allowed.
400115KYB not performed due to too many retries.
400116KYB not performed due to invalid cardholder business status.
400117Input validation error.
400118Invalid state abbreviation.
400119Invalid ZIP code.
400120Invalid country code.
400121Invalid taxpayer ID.
400122US State field must not exceed two characters in length.
400123Reference ID not found.
400124Unable to encrypt card details.
400125An offer with the same token already exists.
400126Purchase amount must be greater than 0.
400127Reward amount must not be less than 0.
400128Reward trigger amount must not be less than 0.
400129Reward trigger amount should not exceed purchase power.
400130Purchase amount must not exceed: <amount>.
400131Amount plus fees must be greater than 0.
400132Fees may not be empty.
400133GiftDescriptors must not exceed: <amount>.
400134Currency code not part of program currency.
400137Identification value required.
400138Beneficial owners cannot have multiple identification types.
400139Beneficial owners cannot have business identification type.
400141$SubResourceName doesn’t belong to $ResourceName$ $token.
400142Could not $Operation $ResourceName with status $Status.
400150Auth restriction not found.
400151Velocity profile not found.
400152Required fields for a user cannot be empty: <x>, <y>.
400153Only either of mid OR mcc OR mcc_group is permitted.
400155KYC provider not setup.
400156Spend control cannot be applied to a business.
400157This endpoint is reserved for user cardholder KYC only.
400158Required fields for a business cannot be empty: <x>, <y>.
400159KYC not permitted for cardholder with a P.O. Box address.
400160number_of_days and velocity_window may not both be populated.
400161Inventory user token is required when single inventory user flag is true.
400162Single inventory user flag should be true if inventory user token is passed.
400163number_of_days or velocity_window must be populated.
400164reference_id may only be used for a manual override.
400165Name line 1 is required.
400166Name line 1 cannot be more than 14 characters.
400167Name line can contain only alpha numeric characters.
400168Bulk ship should be enabled for bulk issuance card product.
400169Recipient address needs to be defined as at least one of Card Product or Bulk Issuance.
400170Cannot update expedite flag for a processed bulk issuance.
400171Cannot update fulfillment information for a processed bulk issuance.
400172Cardholder name must contain only alpha characters.
400173Cannot set number_of_days for velocity control with velocity_window.
400174Invalid input(s): Cannot set usage_limit when velocity_window is TRANSACTION.
400175Campaign contains one or more active orders.
400176Campaign is not active.
400177MID is required.
400178Cannot use numeric postfix with random postfix.
400179Only one of the following is required: mid, mcc, mcc_group or merchant_group_token.
400180Only one of the following is required: mid or merchant_group_token.
400181One of the following is required: mid or merchant_group_token.
400182Unable to add card for a user who has not passed KYC.
400183Invalid birth date.
400184Card is not eligible for funds transfer.
400185Card must be Visa or Mastercard.
400186Card has already expired.
400187Product not available for this country.
400188Postal code does not match with our records.
400189User has no active payment cards.
400190User has no active payment card that is eligible for immediate transfer.
400191Transfer declined.
400192Card declined.
400193Invalid card details.
400194Cannot update the transfer as the given status value is not supported.
400195Please reach out to your Marqeta representative to complete the onboarding process.
400196KYC not performed due to invalid cardholder status.

​
400200–400299 error codes

Error CodeError Message
400200Card product with token does not allow for merchant onboarding.
400201Card product with the same token already exists.
400202config.jit_funding.programgateway_funding_source.funding_source_token is required.
400203config.jit_funding.programgateway_funding_source.funding_source_token is invalid.
400204Invalid BIN prefix. Only 111111 is allowed.
400205Min offset cannot be greater than default offset.
400206Can only have one enabled JIT Funding source.
400207Invalid ISO language code. Only ISO 639-3 codes are allowed.
400210Default card already exists.
400225Could not find a valid funding source.
400226Please provide a valid funding source address token.
400227This endpoint can be called only for payment cards.
400228Invalid type. Use type=paymentcard or type=ach.
400229No referenced original authorization found.
400230No such GPA_PENDING_CREDIT tranlog found.
400231Real-time fee group not found.
400232Missing apply to transaction type in the fee being added to the group.
400233Cannot have multiple fees with same apply transaction type in the group.
400234Invalid transaction type in the fee being added to group.
400235An existing deposit account has already been created for the user.
400237Cannot set the same state.
400238Cannot set state to approved pending from approved credited.
400239Cannot update a processed rejected record.
400240Funding account not active.
400241Unsupported batch header.
400242Unsupported detail record: <abc, def>.
400243Malformed batch header and/or malformed detail record.
400244URL protocols must be https.
400245ACH account already verified.
400246Program gateway max custom headers limit reached.
400247The payment card that you have entered is not permitted to be registered as a funding source.
400248program_reserve_token must be populated if owner_type is PROGRAM.
400249Program gateway custom headers cannot contain an empty string.
400250Sender not found.
400251Recipient not found.
400252Unsupported currency code.
400253Sender user token and sender business token may not both be populated.
400254Recipient user token and recipient business token may not both be populated.
400255Bank transfer speed is invalid.
400256Bank transfer status is invalid.
400257Bank transfer type is invalid.
400258Program gateway customer headers key and/or value max size limit reached.
400259Bank Transfer amount has an invalid ISO minor unit scale (amount must be valid for the specified currency e.g., if currency code is USD, the amount should only have 2 decimal places).
400260Direct deposit is already in requested state.
400261Unable to transition a direct deposit in reversed state.
400262Unable to transition a direct deposit in rejected state.
400263Unable to transition a direct deposit for an inactive cardholder.
400264Unable to reject a direct deposit 5 days after effective date.
400265Invalid direct deposit state detected.
400267Direct deposit account has been terminated.
400268Default cron expression not found.
400269Customer due diligence is incomplete.
400270Customer due diligence question or answer is invalid.
400271One or more fields in the customer due diligence object is null.
400272Only account type CHECKING requires customer due diligence.
400273Direct deposit account requires only two customer due diligence entries.
400274Direct deposit account is not active.
400275Control token is invalid.
400276PIN has not been set for this card.
400277Customer due diligence not required for a non-checking account.
400278Customer due diligence required when creating a checking account.
400279Provided account type is invalid or is savings account, which is unsupported.
400280Direct deposit is not eligible for early settlement.
400281An ACH debit cannot be processed prior to the entry’s settlement date.
400282The supplied reason code cannot be associated with a debit entry.

​
400300–400399 error codes

Error CodeError Message
400300Cannot move card to a new cardholder, terminate active card option is enabled.
400301Cannot move card to a new cardholder, max active cards limit exceeded.
400302Invalid shipping method: GROUND is only valid for bulk orders.
400303Invalid shipping method: bulk orders cannot be shipped via LOCAL_MAIL, LOCAL_MAIL_PACKAGE, or USPS_REGULAR.
400304Invalid shipping method: LOCAL_MAIL_PACKAGE is not allowed for the specified provider.
400305Invalid shipping method: INTERNATIONAL_PRIORITY or LOCAL_PRIORITY are not allowed for the specified provider.
400308Duration between start date and end date is greater than allowed limit.
400325Reversal cannot exceed the authorization amount.
400326Space not found.
400330Failed to create funding source with partner link reference token.
400332Bank transfer limits exceeded.
400350Excess from reward token is invalid.
400351One or more purchase tokens cannot be found or are still pending.
400375Invalid MCC start.
400376Invalid MCC end.
400377Invalid MCC range.
400378Invalid MCC.

​
400400–400499 error codes

Error CodeError Message
400400Maximum result limit exceeded.
400401Funding source token required.
400402Funding source not found.
400403Funding address token missing.
400404Order scope not found.
400405Auto reload of the same type already exists.
400406Funding address not found.
400407Only card_product_token OR card_holder_token is permitted.
400408Invalid reload to amount. The amount must be at least 0.01.
400409Invalid trigger amount. The amount must be at least 0.01.
400410Cannot attach funding source that belongs to a cardholder.
400411Funding address does not belong to cardholder.
400412Funding source does not belong to the cardholder.
400413Funding source not found or it is not allowed to be used in the current context.
400414Trigger amount is greater than reload amount.
400415GPA is required.
400422The partner_account_link_reference_token is invalid.
400423The partner_account_link_reference_token has expired.
400424Account balance is not available.
400425Unload amount is more than the load amount.
400426Cannot refund the points funding source.
400427Refund amount is less than or equal to zero.
400428Customer has no balance available.
400429The order token is not a valid GPA load token.
400430The order token is not a valid GPA unload token.
400431Unloads are not allowed for the given order.
400432Customer has no balance available in the campaign.
400440The account type does not match.
400441The name provided is not an exact match and the account type does not match.
400442The account number does not match the name.
400443The account is not able to be verified.
400444The account has been switched. You should not proceed with the beneficiary name provided in request.
400445The bank is not able to verify accounts.
400446The secondary identifier does not match the beneficiary.
400450Reference network does not contain a valid network.
400451Invalid network detected.
400452Chargeback cannot exceed authorization amount.
400453Chargeback not allowed on this transaction type.
400454Chargeback state is the same as previous.
400456Chargeback is already at terminal state.
400457Chargeback created by gateway channel cannot be set to network rejected.
400458Chargeback transition is unable to represent the original auth.
400459Chargebacks not allowed on this transaction type when channel is issuer.
400460Chargebacks not allowed on this transaction type when channel is gateway.
400462Chargeback network submission not found.
400463Not allowed to update network submission time on chargeback network submission as it was never submitted to network.
400464Not allowed to update network submission time on chargeback network submission more than once.
400465Not allowed to move chargeback from representment state to case won.
400466Maximum chargebacks allowed per card limit reached.
400467Chargeback cannot be moved to prearbitration from initiated in collaboration flow.
400468Unable to reverse provisional credit for chargeback.
400469Unable to grant provisional credit for chargeback.
400470Chargeback cannot be set to non-written-off state.
400471Chargeback cannot be set to written-off state.
400472Either reason description or reason code must be set.
400473Invalid chargeback state.
400474Chargeback cannot be transitioned to representment without the amount.
400475Invalid amount detected for chargeback.
400476Invalid transaction token detected for chargeback.
400477Chargeback cannot transition to representment in allocation flow.
400478Representment amount cannot be greater than chargeback amount.
400479Prearbitration amount cannot be greater than chargeback amount.
400480Chargeback transition amount not allowed for this transition state.
400481Not allowed to update CFP submission time on chargeback network submission as it was already submitted to network.
400482Request cannot contain CFP submission data without network submission data.
400483Chargeback cannot be updated in current state.
400484Chargeback cannot be updated after successful network submission.
400485Cannot update CFP submission information.
400486Cannot update network submission info without CFP submission information.
400487Network submission time is required.
400488Chargeback cannot be moved to this state from case lost.
400489Chargeback cannot be moved to this state from case won.
400490Invalid chargeback transaction reason.
400491Chargeback transaction cash or pending entry must be present.
400492Chargeback transaction entry must contain positive amount or fee amount.
400493Transfer limit exceeded.
400494Daily transfer limit exceeded.

​
400500–400599 error codes

Error CodeError Message
400500In-app provision not allowed for a given card.
400501Missing user tokens.
400502Missing card tokens.
400503Missing KYC or user tokens.
400504Missing DDA or user tokens or business tokens.
400505Active flag cannot be applied to rule type.
400506Missing deposit account tokens.
400507Rule type already exists but is inactive.
400508Rule type already exists.
400509Missing business tokens.
400510Country codes missing.
400511Missing KYC or business tokens.
400512Cardholder token must not be populated if the rule is not at the cardholder level.
400513Cardholder token must be populated if the rule is at the cardholder level.
400514Business cardholder must be over age 18.
400515Invalid incorporation type.
400516Beneficial owner 1 information cannot be empty.
400517Beneficial owner 2 information cannot be empty.
400518Beneficial owner 3 information cannot be empty.
400519Beneficial owner 4 information cannot be empty.
400520Proprietor officer address required fields cannot be empty.
400521Office location required fields cannot be empty.
400522Unable to create business detail.
400523Business not found.
400524Token is associated with a cardholder, not a business.
400525Unable to create business director.
400526The provided email address already exists with another business director linked to this business. Please use a unique email address.
400527Business director not found.
400528Business director does not belong to the business.
400550Business may not hold card.
400551Invalid date established format received.
400552Invalid incorporation type.
400553Business is not active.
400554One or more invalid query parameter(s) have been detected: <x>, <y>, <z>.
400575User token and business token may not be both populated.
400576User token and business token must be populated.
400577Business token was passed in user token field.
400578User token was passed in business token field.
400579Business tokens do not match.
400580Push-to-card provider not set up.
400581Invalid active value.
400582Invalid country code.
400583Invalid expiration date.
400584Name on card is incomplete.
400585Same-day ACH bank transfer must be less than 25000.
400586Funding source must be of Program Bank Account Funding Source type.
400587Funding source must be of User Bank Account Funding Source type.
400588Funding source must be of User or Program Bank Account Funding Source type.
400589Already existing Bank Transfer Transition with same status.
400590Completing this transfer would exceed your program’s maximum account balance.
400591Funding source must be a valid Bank Account Funding Source type.
400592Amount for a single Bank Transfer exceeded.
400593Only Bank Transfers with pending status can be cancelled.
400594Bank Transfer cannot be transitioned to the requested state.
400595Program reserve deposit not found.
400596Problem retrieving Program Bank Account funding sources.
400597Invalid value provided for accountType.
400598Invalid Input: only the following API or SYSTEM channels are valid for bank transfers.
400599Deposit account token must be provided if account type is DEPOSIT_TOKEN.

​
400600–400699 error codes

Error CodeError Message
400600Maximum active webhooks exceeded.
400601Event type is invalid.
400602Event token is invalid.
400603Event type not accepted.
400604Marqeta signature does not match.
400605Invalid webhook token.
400623Invalid funding source type.
400650Invalid digital wallet token transition state.
400651Cannot unactivate a digital wallet token.
400652The digital wallet token is already in terminated state.
400653Only suspended or requested digital wallet token can be activated.
400654Only an active digital wallet token can be suspended.
400655The digital wallet token cannot be terminated.
400656The card must be active or unactivated.
400657Card is expired.
400658Recipient address needs to be defined as at least one of card, cardholder, or card product.
400659Unable to create card when inactive card product and allow_card_creation is set to false.
400660Cannot update expedite flag for a fulfilled card.
400661Cannot update fulfillment information for a fulfilled card.
400662User cannot have more than max allowed active cards.
400664When reissuing a PAN from card token is set, PIN translation from card token not allowed. For reissue, the card PIN will be translated automatically.
400665PIN translation card token does not exist or card does not belong to the same user.
400666Swap digital wallet tokens from card token does not exist.
400667Unable to translate PIN to new card.
400668The reissued card cannot be converted from physical to virtual card.
400669Token transition not allowed, awaiting activation by token service provider.
400670No cards found for a given reissued card token.
400671The reissue source card must be latest active or suspended card in the chain.
400672The reissue source card must be ACTIVE or SUSPENDED.
400675Original transaction not found.
400676Unable to reverse transaction due to ITC.
400677Account holder group not found.
400678Index out of range.
400679Reference transaction not found or does not associate to the original card.
400680The funding source cannot be set as default.
400681The package ID does not belong to any card product.
400682Invalid chargeback state has been detected.
400683Commando mode not found.
400684Program funding source not found.
400685Program gateway funding source not found.
400686Network tran group not found.
400687Network tran type not found.
400688Need to provide either association or merchant_scope.
400689Invalid transaction state detected.
400690Invalid identifier detected.
400691Card may not be created with a bulk ship enabled card product that has no recipient address.
400692Card may not be created with bulk ship enabled card product which is missing recipient address, first or last name.
400693User not allowed to tokenize old reissued card.
400694Image names in card personalization cannot contain spaces.
400695Image names in card personalization require PNG extension.
400696Image names in card personalization should be unique.
400697Reason code must be populated.
400698Endpoint is no longer valid. Please use card transitions.
400699Cannot create card for a closed cardholder.

​
400700–400799 error codes

Error CodeError Message
400700Unable to transition the Commando Mode to the same state.
400701Only one Commando Mode allowed per program gateway funding source.
400702Cannot create a demand deposit account for a business account.
400704Invalid shipping method for non-expedited order. Choose USPS_REGULAR.
400705Invalid shipping method for expedited order. Choose STANDARD_NEXT_DAY, PRIORITY_NEXT_DAY, or GROUND.
400706Invalid shipping method for bulk order. Choose STANDARD_NEXT_DAY, PRIORITY_NEXT_DAY, or GROUND.
400707Invalid shipping method for bulk order. Choose STANDARD_NEXT_DAY or GROUND.
400708Cannot provide expiration offset value without expiration offset unit.
400709Cannot provide expiration offset unit without expiration offset value.
400710The card must be active.
400711Only an activated, suspended, or limited card can be limited.
400712Conflicting parameters in reissue request.
400725Network tran type with the same network already exists.
400750Cannot transition user to ACTIVE until it has passed KYC.
400751Cannot transition business to ACTIVE until it has passed KYC.
400752Cannot transition user from UNVERIFIED to SUSPENDED.
400753Cannot transition business from UNVERIFIED to SUSPENDED.
400754Cannot transition user to LIMITED until it has passed KYC.
400755Cannot transition business to LIMITED until it has passed KYC.

​
400800–400899 error codes

Error CodeError Message
400800Invalid network.
400801Digital wallet token is already active.
400802Manual entry not allowed for a given card.
400803Wallet provider card on file not allowed for a given card.
400804Digital wallet token requestor map not found for the given requestor name and network.
400805Digital wallet token requestor map already exists.
400810Active product could not be updated.
400811Rejected product could not be updated.
400812Resource could not be updated.
400813Direct deposit account is not terminated.
400814Cardholder account is not closed.
400815Child cardholder account uses parent account.
400816Check return entry not found.
400817Cardholder balance must be greater than 0.00.
400818%s is not enabled for this program.
400819Specified date is more than seven years ago and exceeds maximum statement history.
400820Deposit account group not found.
400821Deposit Account Group not empty.
400822Program config already exists.
400823Primary account not found.
400824Cardholder balance must be greater than the interest-bearing account minimum balance.
400825Invalid reported balance request, all fields are required non null.
400826Invalid reported currency balance request, all fields are required non null.
400827Invalid reported balance, all fields are required non null.
400828Invalid token request, token (length >0, <=36) and tenant (length >0, <=10) are required.
400829Invalid token, must not be blank and length should be >0, <=36.
400830Invalid tenant, must be >0, <=10.
400831Invalid user token request, user token (length >0, <=36) and tenant (length >0, <=10) are required.
400832Invalid user token, must not be blank and length should be >0, <=36.
400833Invalid account code, must not be blank and length should be >0, <=255.
400834Invalid effective time.
400835Invalid balance, effective time and money should be non null.
400836Invalid balance money, must not have a blank currency code.
400837Invalid balances.
400838Invalid currency code.
400839Invalid amount.
400840One or more field(s) entered is malformed.
400841Cardholder has card(s) that are not in the TERMINATED state.
400850The input file $FileName could not be found.
400851Unable to access input file $FileName.
400852Invalid file extension, the input file $FileName must be of type $FileType.
400853Missing headers in the input file.
400854Missing required column header $ColumnName.
400855Invalid column name $ColumnName.
400856Column header at column index $ColumnIndex is empty.
400857The input file $FileName exceeds the maximum allowable size of $FileSize.
400858The processing was successful, however, the response file $FileName not found.
400859An unexpected error occurred, unable to process your file.
400860Missing required metadata $FileMetadata.
400861Unable to download the input file $FileName.
400862Error occurred during the initialization of the transport processor.
400863Error occurred during the initialization of the payment client.
400864Consul service is missing either the service name $ServiceName or program name $ProgramName.
400865Consul service $ServiceName is missing API URL.
400866Missing required arguments bucket name $BucketName object name $ObjectName.
400867Unexpected input location format $LocationName.
400868Internal file error.
400869Unable to process the input file $FileName, as the file contents were processed previously.
400880Invalid data in column $ColumnName.
400881Invalid action, $Action is not supported.
400882Number of columns does not match header columns.
400883Action $Action not supported for funding the card.
400884Card token is missing, unable to update the card.
400885User token is missing, unable to update the user.
400886Invalid date format in column $ColumnName, the date format should be $DateFormat.
400887Internal record error $RecordNumber.

​
400900–400999 error codes

Error CodeError Message
400900Invalid query parameters.
400909Statement cycle date needs to be between 1 and 31, inclusive.
400910No account identifier found.
400911Both accounts must belong to the same cardholder.
400912Source and destination account are the same.
400915Unable to create transaction log entries.
400916Cannot create an interest-bearing account for a business account.
400917Effective date must be later than today.
400918User allocation must be between 0 and 100 with at most 1 digit after the decimal.
400919Marqeta allocation must be between 0 and 100 with at most 1 digit after the decimal.
400920Provider rate must be at least 0 with at most 5 digits after the decimal.
400924Could not find bank to display holdback percentages.
400943DDA token is invalid.
400951Missing required query parameters.
400952Card is not eligible for the requested activity.
400975Merchant group not found.
400984copy_pin_from_source_card can only be used with reissue_pan_from_card_token or new_pan_from_card_token
400985Card is not in an active state.

​
401000–401999 error codes

Error CodeError Message
401001Invalid credential has been detected.
401002Missing application token.
401003Invalid token.
401004Invalid application token.
401005Business cannot hold card.

​
403000–403999 error codes

Error CodeError Message
403001User does not have permission to access this endpoint.
403003Missing application token.
403008User is forbidden from accessing this funding source.
403009User is forbidden to modify this MCC group.
403010User is forbidden to set chargeback to written-off states.
403011User is forbidden to update the active field.
403012User is forbidden to activate a user that was deactivated by a super user.
403013User is forbidden to activate a business that was deactivated by a super user.
403014User is forbidden to activate a card that was deactivated by a super user.
403015User is forbidden to activate a digital wallet token that was deactivated by a super user.
403016Override TSP error can only be set by admin user.
403017Override TSP error is only allowed for terminating tokens.
403018PDF statements disabled for the program.
403200Program is not enabled to access this endpoint.

​
404000–404999 error codes

Error CodeError Message
404000Resource not found or unavailable.
404001Card not found.
404002Card transition not found.
404003Merchant card not found.
404004Cardholder not found.
404005Digital wallet token transition not found.
404006Balance for token and tenant not found.
404007Balance for user token and tenant not found.
404008Balance for user token, currency and tenant not found.
404009Escheatment entry not found.
404010Program not found.
404025Merchant not found.
404026Store not found.
404050Order not found.
404051GPA order token not found.
404052Offer not found.
404075KYC not found.
404076Cardholder has no KYC objects associated.
404077Auth control not found.
404078Velocity control not found.
404079Invalid additional transaction data format.
404100Campaign not found.
404125Card product not found.
404141$ResourceName with $SubResourceName $token not found.
404150User does not have any funding accounts.
404151Cardholder does not have any funding addresses.
404152Program account not found.
404153Points account not found.
404154Fee not found.
404155Funding account not found.
404156Real-time fee group not found.
404157Deposit account not found.
404158Direct deposit not found.
404159Direct deposit transition not found.
404160Bulk issuance request not found.
404161Chargeback transition not found.
404162Program reserve account not found.
404163Customer due diligence not found for given account token.
404164Customer due diligence entry not found for given CDD token.
404175Transfer not found.
404180Push-to-card information not found.
404200Rule not found.
404201Program config group not found.
404202Card inventory not found.
404203Program config key not found.
404250Original transaction not found.
404275Reward program token not found or is not active.
404276Reward token not found.
404300Transaction token not found.
404325Auto reload not found.
404350Chargeback not found.
404351Chargeback transition not found.
404354Retry can only be performed on a clearing transaction.
404357Transaction has already been cleared.
404358Retry can only be performed on a failed clearing transaction.
404400Return not found.
404401GPA unload order not found.
404456Digital wallet token not found.
404457Subscription transition not found.
404500Accepted country not found.
404525Account holder group not found.
404530File processing not found.
404531User transition not found.
404532Business transition not found.
404534Bank transfer not found.
404550Network tran type not found.
404575Commando mode transition not found.
404576Commando mode not found.
404600Merchant group not found.
404720Program transfer type not found.
404721Program transfer not found.
404722Transfer amount is more than the GPA balance.
404800Credit transaction not found.
404900Transfer not found.
404914Could not find an account transfer associated with this token.
404915Could not find a customer allocation rate associated with this token.
404916Could not find base rate.
404917Could not find Marqeta allocation for program.
404918Could not find user allocation.
404919Stop payment order not found.

​
405000–405999 error codes

Error CodeError Message
405001Resource not available.

​
409000–409999 error codes

Error CodeError Message
409001Token has already been associated with a different payload.
409002General conflict exception: <x>.
409003Transaction found with the same ITC and network reference ID.
409005Token value already consumed for tenant.
409010Auth control default acceptance behavior has not been set.
409011Card product token is invalid.
409012User token is invalid.
409013Duplicate KYC token.
409014Card product group token is invalid.
409020Card already exists.
409025Cannot delete a default merchant campaign.
409026Cannot update a default merchant campaign.
409050A rule with the same token already exists.
409075Reward already redeemed.

​
410000–410999 error codes

Error CodeError Message
410001Resource no longer exists.

​
412000–412999 error codes

Error CodeError Message
412001PIN is weak.
412003Missing program ID setup error.
412010Unload amount is more than the GPA balance.
412025Chargeback amount has exceeded GPA balance.
412027Chargeback transaction reasons are not setup.
412050Unable to reverse transaction due to ITC.
412051Unable to reverse transaction due to state.
412075Account not found.
412722Transfer amount is more than the GPA balance.

​
422000–422999 error codes

Error CodeError Message
422001Insufficient funds.
422002General unprocessible exception: <x>.
422003Unsuccessful response from token services gateway.
422010Unable to process request at this time. Please try again later.
422011Unable to process request at this time. Gateway error.
422012Cardholder not found.
422015Unable to create card for a user who has not passed KYC.
422016Unable to create a demand deposit account for a user who has not passed KYC.
422025Single load card cannot be reloaded.
422026Insufficient funds to perform load from program reserve.
422027Unable to load funds for a user who has not passed KYC.
422037Cardholder not active.
422038Unable to reverse transaction for chargeback.
422039Unable to refund transaction for chargeback.
422040Unable to reverse provisional credit for chargeback.
422041Unable to grant provisional credit for chargeback.
422042Unable to create direct deposit.
422043Unable to create direct deposit transition.
422044Unable to map direct deposit state to internal transaction type.
422045Unable to create a demand deposit account for a user that has not passed KYC.
422046Unable to create a demand deposit account for a business that has not passed KYB.
422048The sender and the recipient cannot both be businesses.
422049Sender nor recipient can transfer using parent account.
422050Insufficient funds from sender account.
422051Sender and recipient must be active.
422052Cannot transfer funds on the same users.
422053Internal funds transfer accounts must be owned by the same user.
422075The initiated chargeback is not associated to a transaction.
422077The chargeback transaction did not create successfully.
422125Unable to exceed max balance.
422126Non-program funding source load is not allowed.
422127Reloads are not allowed.
422130Invalid card address.
422131Invalid or wrong CVV2.
422132Card not eligible for funding transfers.
422133Disbursement request declined.
422134Disbursement request declined due to insufficient funds.
422135Disbursement cannot be processed since the card is still provisioning for service.
422150Commando mode cannot be updated due to its current state.
422600Webhook operation failed.

​
424000–424999 error codes

Error CodeError Message
424001Balance gateway is not enabled.

​
429000–429999 error codes

Error CodeError Message
429001Too many requests.

​
500000–500999 error codes

Error CodeError Message
500000Internal server error.
500001The service is down. Please try again later.
500002Creating base rate failed.
500003Creating Marqeta/Program Rate failed.
500006BIN PAN count setup error.
500010Nile ping error.
500011Balance creation failed.
500012Create balance error.
500016Zion ping error.
500017KYB gateway database error.
500018KYB gateway timeout error.
500019KYB gateway system error.

​
500100–500199 error codes

Error CodeError Message
500109There was a problem with retrieving a chargeback.
500110There was a problem with retrieving a chargeback transition.
500111There was a problem with creating a chargeback transition.
500112There was a problem with retrieving chargeback network submissions.
500113There was a problem with updating chargeback network submissions.
500114There was a problem with granting provisional credit for a chargeback.
500115There was a problem with reversing provisional credit for a chargeback.
500116There was a problem with retrieving transitions for a commandomode.
500117There was a problem with retrieving a commandomode.
500118There was a problem with creating transitions for a commandomode.
500119There was a problem creating a direct deposit.
500120There was a problem creating a direct deposit transition.
500121There was a problem retrieving a direct deposit transition.
500122There was a problem when retrieving bank transfer entry(s).
500124There was a problem with updating customer due diligence.
500125There was a problem with retrieving customer due diligence.
500126There was a problem creating a deposit account.
500127There was a problem adding the card.
500128There was a problem retrieving the cards.
500129There was a problem retrieving the transfers.
500141Could not $Operation $ResourceName $token.
500142Could not $Operation $ResourceName $token for $SubResourceName $token.
500175Error returned from KYC provider.
500176There was a problem creating the transfer.

​
500200–500299 error codes

Error CodeError Message
500201Transaction creation error.

​
500300–500399 error codes

Error CodeError Message
500301Could not complete error due to an unavailable downstream dependency.
500302Please retry as the system was unable to process the request.
500303There was a problem with the stop payment order.

Related topics

Errors DiVA APIError Handling in EuropeManaging TimeoutsDisputes in the Marqeta DashboardManaging Mastercard Disputes