DOCS

New!

/

20 minute read

October 3, 2019

Errors

This page provides a comprehensive reference of Core API error codes. Error codes are based on HTTP response codes. The first three digits include the HTTP response code and the last three digits represent the error. You can use this information to diagnose failed transactions and to improve your exception handling capability.

Response codes

The Core API uses standard HTTP response codes to indicate the status of requests. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error in the request, and codes in the 5xx range indicate an error at the Marqeta platform. The following table shows some common response codes:

Response Code Description

200 OK

Your request completed successfully.

201 Created

Resource created successfully.

204 No Content

Returned on a successful DELETE.

401 Unauthorized

403 Forbidden

405 Method Not Allowed

The method you supplied is not allowed for that resource, for example a PUT method on a read-only resource.

413 Request Entity Too Large

The request body is too large or the GET request count parameter is too large.

422 Velocity rules violation or non-sufficient funds

500 Internal Server Error

An error occurred that could not be handled by the application.

502 Bad Gateway

503 Service Unavailable

504 Gateway Timeout

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

Is this helpful?

Common error codes

Common error codes 400

Error Code Error Message

400001

Invalid input(s) detected: <x>, <y>, <z>

400002

Birth date cannot be a future date

400003

Start date cannot be greater than or equal to end date

400004

One or more invalid field(s) have been detected: <x>, <y>, <z>

400005

An invalid currency code has been detected

400006

Amount must be greater than or equal to 0

400007

There is nothing to update. All fields are null

400008

Missing a required field

400009

Issuer not found

400010

Cardholder not found

400011

Store not found

400012

Merchant not found

400013

Card not found

400014

Order not found

400015

Campaign not found

400016

Card product not found

400017

Funding account not found

400018

Program account not found

400019

Fee not found

400020

Offer not found

400021

Rule not found

400022

Authentication user not found

400025

Auth control not found

400026

User token is invalid

400027

Velocity control not found

400028

Auto reload not found

400029

Unknown Error

400030

MCC group not found

400031

Invalid cardholder

400032

Invalid address

400033

Offer already exists

400034

One or more fields have invalid length

400035

Maximum number of children

400036

General input exception: <x>

400037

Malformed JSON request received

400038

General gateway exception: <x>

400039

Deposit Account not found

400040

Direct Deposit not found

400041

Card product not found or not active

400042

Invalid sort field passed

400043

Invalid date format received

400044

Invalid start date format received

400045

Invalid end date format received

400046

Chargeback not found

400047

Cardholder does not have full SSN

400048

Request object cannot be empty

400049

Digital wallet token not found

400554

One or more invalid query parameter(s) have been detected: <x>, <y>, <z>

400575

User token and Business token may not be both populated

400576

User token and Business token must be populated

400675

Original transaction not found

400676

Unable to reverse transaction due to ITC

400677

Account holder group not found

400678

Index out of range

400679

Reference transaction not found or does not associate to the original card

400680

The funding source cannot be set as default

400681

The package ID does not belong to any card product

400682

Invalid chargeback state has been detected

400683

Commando mode not found

400684

Program funding source not found

400685

Program gateway funding source not found

400686

Network tran group not found

400687

Network tran type not found

400688

Need to provide either association or merchant_scope

400689

Invalid transaction state detected

400104

Invalid expiration date format

400105

Identifications contains duplicate identification types

400107

Expiration date not allowed for identification type(s)

400114

Chip fallback to magstripe not allowed

Common error codes 401

Error Code Error Message

401001

Invalid credential has been detected

Common error codes 403

Error Code Error Message

403001

User does not have permission to access this endpoint

Common error codes 404

Error Code Error Message

404000

Resource not found or unavailable

Common error codes 405

Error Code Error Message

405001

Resource not available

Common error codes 409

Error Code Error Message

409001

Token has already been associated with a different payload

409002

General conflict exception: <x>

409003

Transaction found with the same ITC and network reference ID

Common error codes 422

Error Code Error Message

422001

Insufficient funds

422002

General unprocessible exception: <x>

422003

Unsuccessful response from token services gateway: <x>

Common error codes 500

Error Code Error Message

500000

Internal server error

Accepted Countries errors

Accepted Countries endpoints 400

Error Code Error Message

400510

Country codes missing

Accepted Countries endpoints 404

Error Code Error Message

404500

Accepted country not found

Account Holder Groups errors

Account Holder Groups endpoints 404

Error Code Error Message

404525

Account holder group not found

Account Holder Groups endpoints 422

Error Code Error Message

422125

Unable to exceed max balance

422126

Non program funding source load is not allowed

422127

Reloads are not allowed

Auth Controls / Velocity Controls / KYC errors

Auth Controls / Velocity Controls / KYC endpoints 400

Error Code Error Message

400150

Auth restriction not found

400151

Velocity profile not found

400152

Required fields for a user cannot be empty: <x>, <y>

400153

Only either of mid OR mcc OR mcc_group is permitted

400155

KYC provider not setup

400156

Spend control can not be applied to a business

400157

This endpoint is reserved for User Cardholder KYCs only

400158

Required fields for a business cannot be empty: <x>, <y>

400159

KYC not permitted for card holder with a P.O Box address

400160

number_of_days and velocity_window may not both be populated

400163

number_of_days or velocity_window must be populated

400164

reference_id may only be used for a manual override

400172

Cardholder name must contain only alpha characters

400173

Cannot set number_of_days for velocity control with velocity_window

400174

Invalid input(s): Cannot set usage_limit when velocity_window is transaction

400177

MID is required

Auth Controls / Velocity Controls / KYC endpoints 404

Error Code Error Message

404075

KYC not found

404076

Cardholder has no KYC objects associated

404077

Auth control not found

404078

Velocity control not found

404079

Invalid additional transaction data format

Auth Controls / Velocity Controls / KYC endpoints 409

Error Code Error Message

409010

Auth control default acceptance behavior has not been set

409011

Card product token is invalid

409012

User token is invalid

409013

Duplicate KYC token

Auth Controls / Velocity Controls / KYC endpoints 500

Error Code Error Message

500175

Error returned from KYC provider

Auto Reload errors

Auto Reload endpoints 400

Error Code Error Message

400400

Maximum result limit exceeded

400401

Funding source token required

400402

Funding source not found

400403

Funding address token missing

400404

Order scope not found

400405

Auto reload of the same type already exists

400406

Funding address not found

400407

Only card_product_token OR card_holder_token is permitted

400408

Invalid reload to amount. The amount must be at least 0.01

400409

Invalid trigger amount. The amount must be at least 0.01

400410

Cannot attach funding source that belongs to a cardholder

400411

Funding address does not belong to cardholder

400412

Funding source does not belong to the cardholder

400413

Funding source not found or it is not allowed to be used in the current context

400414

Trigger amount is greater than reload amount

400415

GPA is required

Auto Reload endpoints 404

Error Code Error Message

404325

Auto reload not found

BillPay errors

BillPay endpoints 400

Error Code Error Message

400900

Invalid query params

400901

account_number is required for this biller

400902

username and password are required

400903

Either account_number or username and password is required

400904

Biller not found

400905

Bill configuration not found

400906

Bill payment not found

400907

Job not found

400908

Subscription not found

400920

Bill payments can only be transitioned to REVERSED if in INITIATED or ON_HOLD status

400921

Invalid status detected

400922

Bill configurations can only transition to DEACTIVATED status

400923

payer_data.first_name and payer_data.last_name are required

400924

payer_data.birth_date is required

400925

payer_data.city and payer_data.state are required

400926

payer_data.phone_number is required

400927

Cannot update username, password, or mfa for bill configuration that does not receive balance updates

400928

The account number does not match any mask

400929

MFA answer cannot be submitted. It has already expired

400930

Bill payments can only be initiated if bill configuration is in ACTIVE status

400932

config.days_of_month must be between 1 and 28

400933

config.expiration_date must be after next scheduled payment date

400934

config.variable_amount can only be set to true if bill configuration receives balance updates

400935

Subscriptions can only be created if bill configuration is in ACTIVE status

400936

config.start_date can only be updated if no payments have been made with this subscription

400937

Bill payments can only be transitioned to EXPIRED if in SENT or ON_HOLD status

400938

Bill configuration can only transition to DEACTIVATED status when there are no ACTIVE subscriptions

400939

Subscription can only transition to ACTIVE status when there is a future payment date

400940

Subscription can only be transitioned if in ACTIVE or CANCELLED statuses

400941

config.amount is required

400942

Biller not active

BillPay endpoints 404

Error Code Error Message

404450

Biller not found

404451

Bill configuration not found

404452

Account transition not found

404453

Bill payment not found

404454

Bill payment transition not found

404455

Job not found

404456

Subscription not found

404457

Subscription transition not found

BillPay endpoints 422

Error Code Error Message

422010

Unable to process request at this time. Please try again later

422011

Unable to process request at this time. Gateway error

422012

Cardholder not found

Bulk Issuance errors

Bulk Issuance endpoints 400

Error Code Error Message

400161

Inventory user token is required when single inventory user flag is true

400162

Single inventory user flag should be true if inventory user token is passed

400165

Name line 1 is required

400166

Name line 1 cannot be more than 14 characters

400167

Name line can contain only alpha numeric characters

400168

Bulk ship should be enabled for bulk issuance card product

400169

Recipient address needs to be defined at at least one of Card Product or Bulk Issuance

400170

Cannot update expedite flag for a processed bulk issuance

400171

Cannot update fulfillment information for a processed bulk issuance

400178

Cannot use numeric postfix with random postfix

400706

Invalid shipping method for bulk order. Choose STANDARD_NEXT_DAY, PRIORITY_NEXT_DAY, or GROUND

400707

Invalid shipping method for bulk order. Choose STANDARD_NEXT_DAY or GROUND

400708

Cannot provide expiration offset value without expiration offset unit

400709

Cannot provide expiration offset unit without expiration offset value

Bulk Issuance endpoints 404

Error Code Error Message

404160

Bulk issuance request not found

Businesses errors

Businesses endpoints 400

Error Code Error Message

400550

Business may not hold card

400551

Invalid date established format received

400552

Invalid incorporation type

400553

Business is not active

400106

Business cannot have multiple tax identification types

400109

Business cannot have user identification type

400111

Proprietor cannot have business identification type

400112

Proprietor cannot have multiple SSN identification types

Businesses / Business Transitions endpoints 400

Error Code Error Message

400751

Cannot transition business to active until it has passed KYC

400753

Cannot transition business from unverified to suspended

400755

Cannot transition business to limited until it has passed KYC

Businesses / Business Transitions endpoints 404

Error Code Error Message

404500

Business not found

404532

Business transition not found

Campaigns errors

Campaigns endpoints 400

Error Code Error Message

400175

Campaign contains one or more active orders

400176

Campaign is not active

Campaigns endpoints 404

Error Code Error Message

404100

Campaign not found

Campaigns endpoints 409

Error Code Error Message

409025

Cannot delete a default merchant campaign

409026

Cannot update a default merchant campaign

Card Products errors

Card Products endpoints 400

Error Code Error Message

400200

Card product with token does not allow for merchant onboarding

400201

Card product with the same token already exists

400202

config.jit_funding.programgateway_funding_source.funding_source_token is required

400203

config.jit_funding.programgateway_funding_source.funding_source_token is invalid

400204

Invalid BIN Prefix. Only 111111 is allowed

400205

Min offset cannot be greater than default offset

400206

Can only have one enabled JIT funding source

Card Products endpoints 404

Error Code Error Message

404125

Card product not found

Card Product Group endpoints 404

Error Code Error Message

404126

Card product group not found

Cards/Card Transitions/Digital Wallet Tokens errors

Cards/Card Transitions/Digital Wallet Tokens endpoints 400

Error Code Error Message

400074

Max card orders per day limit reached

400075

Card already exists

400076

Either the phone number or last four of SSN is required

400077

Birth date entered does not match the record

400078

SSN missing on record

400079

Invalid SSN detected

400080

Phone number entered does not match the record

400081

Last four of SSN does not match the record

400082

User token, phone and date of birth must be presented

400083

Phone number or date of birth does not match the record

400084

No active card found for user

400085

cvv_number does not match

400086

Expiration does not match

400087

A card with the same merchant token already exists in the system

400088

Merchant card not found

400089

Cannot move an active card to a new cardholder

400090

The card is already in terminated state

400091

Only an unactivated or suspended card can be activated

400092

Only an activated card can be suspended

400093

Cannot unactivate a card

400094

Last four of PAN is required

400095

Invalid card transition state

400096

Card token cannot start with reserved keyword

400097

Unable to generate card verification value

400098

Bulk card order must be unprocessed

400099

Card product must equal bulk card order card product

400300

Cannot move card to a new cardholder, terminate active card option is enabled

400301

Cannot move card to a new cardholder, max active cards limit exceeded

400650

Invalid digital wallet token transition state

400651

Cannot unactivate a digital wallet token

400652

The digital wallet token is already in terminated state

400653

Only suspended or requested digital wallet token can be activated

400654

Only an active digital wallet token can be suspended

400655

The digital wallet token cannot be terminated

400656

The card must be active or unactivated

400657

Card is expired

400658

Recipient address needs to be defined at at least one of card, card holder or card product

400659

Unable to create card when allow_card_creation is set to false

400660

Cannot update expedite flag for a fulfilled card

400661

Cannot update fulfillment information for a fulfilled card

400664

When reissuing a PAN from card token is set, pin translation from card token not allowed. For reissue, the card pin will be translated automatically.

400665

Pin translation card token does not exist or card does not belong to the same user

400666

Swap digital wallet tokens from card token does not exist

400667

Unable to translate pin to new card

400668

The reissued card can not be converted from physical to virtual card

400669

Token transition not allowed, awaiting activation by token service provider

400670

No cards found for a given reissued card token

400671

The reissue source card must be latest active or suspended card in the chain

400672

The reissue source card must be active or suspended

400673

Max card orders allowed by inventory has been reached

400683

Expiration offset must be within window defined in card product

400691

Card may not be created with a bulk ship enabled card product that has no recipient address

400692

Card may not be created with bulk ship enabled card product which is missing recipient address first or last name

400693

User not allowed to tokenize old reissued card

400694

Image names in card personalization cannot contain spaces

400695

Image names in card personalization require PNG extension

400696

Image names in card personalization should be unique

400697

reason_code must be populated

400698

Endpoint is no longer valid. Please use card transitions

400704

Invalid shipping method for non-expedited order. Choose USPS_REGULAR

400705

Invalid shipping method for expedited order. Choose STANDARD_NEXT_DAY, PRIORITY_NEXT_DAY, or GROUND

Cards/Card Transitions/Digital Wallet Tokens endpoints 404

Error Code Error Message

404001

Card not found

404002

Card transition not found

404003

Merchant card not found

404004

Card holder not found

404005

Digital wallet token transition not found

Cards/Card Transitions/Digital Wallet Tokens endpoints 412

Error Code Error Message

412003

Missing program ID setup error

Cards/Card Transitions/Digital Wallet Tokens endpoints 422

Error Code Error Message

422015

Unable to create card for a user that has not passed KYC

Chargebacks errors

Chargebacks endpoints 400

Error Code Error Message

400450

Reference network does not contain a valid network

400451

Invalid network detected

400452

Chargeback cannot exceed authorization amount

400453

Chargeback not allowed on this transaction type

400454

Chargeback state is the same as previous

400456

Chargeback is already at terminal state

400457

Chargeback created by gateway channel cannot be set to network rejected

400458

Chargeback transition is unable to represent the original auth

400459

Chargebacks not allowed on this transaction type when channel is issuer

400460

Chargebacks not allowed on this transaction type when channel is gateway

400461

The original transaction is not related to an MSA order

400462

Chargeback network submission not found

400463

Not allowed to update network submission time on chargeback network submission as it was never submitted to network

400464

Not allowed to update network submission time on chargeback network submission more than once

400465

Not allowed to move chargeback from representment state to case won

400466

Maximum chargebacks allowed per card limit reached

400467

Chargeback cannot be moved to prearbitration from initiated in collaboration flow

400468

Unable to reverse provisional credit for chargeback

400469

Unable to grant provisional credit for chargeback

400470

Chargeback cannot be set to non written off state

400471

Chargeback cannot be set to written off state

400472

Either reason description or reason code must be set

400473

Invalid chargeback state

400474

Chargeback cannot be transition to representment without the amount

400475

Invalid amount detected for chargeback

400476

Invalid transaction token detected for chargeback

400477

Chargeback cannot transition to representment in allocation flow

400478

Representment amount cannot be greater than chargeback amount

400479

Prearbitration amount cannot be greater than chargeback amount

400480

Chargeback transition amount not allowed for this transition state

400481

Not allowed to update CFP submission time on chargeback network submission as it was already submitted to network

400482

Request cannot contain CFP submission data without network submission data

Chargebacks endpoints 403

Error Code Error Message

403010

User is forbidden to set chargeback to written off states

Chargebacks endpoints 404

Error Code Error Message

404350

Chargeback not found

404351

Chargeback transition not found

Chargebacks endpoints 412

Error Code Error Message

412025

Chargeback amount has exceeded GPA balance

412026

Chargeback amount has exceeded MSA balance

Chargebacks endpoints 422

Error Code Error Message

422075

The initiated chargeback is not associated to a transaction

Chargebacks endpoints 500

Error Code Error Message

500109

There was a problem with retrieving a chargeback

500110

There was a problem with retrieving a chargeback transition

500111

There was a problem with creating a chargeback transition

500112

There was a problem with retrieving chargeback network submissions

500113

There was a problem with updating chargeback network submission

500114

There was a problem with granting provisional credit for a chargeback

500115

There was a problem with reversing provisional credit for a chargeback

500116

There was a problem with retrieving transitions for a commandomode

500117

There was a problem with retrieving a commandomode

500118

There was a problem with creating transitions for a commandomode

500119

There was a problem creating a direct deposit

500120

There was a problem creating a direct deposit transition

500121

There was a problem retrieving a direct deposit transition

Commando Mode errors

Commando Mode endpoints 400

Error Code Error Message

400700

Unable to transition the commando mode to the same state

400701

Only one commando mode allowed per program gateway funding source

Commando Mode endpoints 404

Error Code Error Message

404575

Commando mode transition not found

404576

Commando mode not found

Commando Mode endpoints 422

Error Code Error Message

422150

Commando mode cannot be updated due to its current state

Digital Wallet Token errors

Digital Wallet Token endpoints 500

Error Code Error Message

404456

Digital wallet token not found

400500

In-app provision not allowed for a given card

400800

Invalid Network

400801

Digital wallet token is already active

400802

Manual entry not allowed for a given card

400803

Wallet provider card on file not allowed for a given card

400804

Digital wallet token requestor map not found for the given requestor name and network

400805

Digital wallet token requestor map already exists

File processing errors

File processing error codes 404

Error Code Error Message

404530

File processing not found

Funding Sources / Funding Addresses / Fees / Real Time Fee Groups/ Direct Deposit errors

Funding Sources / Funding Addresses / Fees / Real Time Fee Groups/ Direct Deposit endpoints 400

Error Code Error Message

400225

Could not find a valid funding source

400226

Please provide a valid funding source address token

400227

This endpoint can be called only for Payment Card

400228

Invalid type. Use type=paymentcard or type=ach

400229

No referenced original authorization found

400230

No such GPA_PENDING_CREDIT tranlog found

400231

Real time fee group not found

400232

Missing apply to transaction type in the fee being added to the group

400233

Cannot have multiple fees with same apply transaction type in the group

400234

Invalid transaction type in the fee being added to group

400235

An existing deposit account has already been created for the user

400237

Cannot set the same state

400238

Cannot set state to approved pending from approved credited

400239

Cannot update a processed rejected record

400240

Funding account not active

400241

Unsupported batch header

400242

Unsupported detail record: <abc, def>

400243

Malformed batch header and/or malformed detail record

400244

URL protocols must be https

400245

ACH account already verified

400246

Program gateway max custom headers limit reached

400247

The payment card that you have entered is not permitted to be registered as a funding source

400248

program_reserve_token must be populated if owner_type is program

400249

Program gateway custom headers cannot contain an empty string

400260

Direct deposit is already in requested state

400261

Unable to transition a direct deposit in reversed state

400262

Unable to transition a direct deposit in rejected state

400263

Unable to transition a direct deposit for an inactive cardholder

400264

Unable to reject a direct deposit 5 days after effective date

400265

Invalid direct deposit state detected

400267

Direct deposit account has been terminated

400268

Default cron expression not found

400269

Cardholder must have a card to create a bill payment

Funding Sources / Funding Addresses / Fees / Real Time Fee Groups/ Direct Deposit endpoints 404

Error Code Error Message

404150

User does not have any funding accounts

404151

Cardholder does not have any funding addresses

404152

Program account not found

404153

Points account not found

404154

Fee not found

404155

Funding account not found

404156

Real time fee group not found

404157

Deposit account not found

404158

Direct deposit not found

404159

Direct deposit transition not found

404160

Bulk issuance request not found

404161

Chargeback transition not found

404162

Program reserve account not found

Funding Sources / Funding Addresses / Fees / Real Time Fee Groups/ Direct Deposit endpoints 422

Error Code Error Message

422037

Card holder not active

422038

Unable to reverse transaction for chargeback

422039

Unable to refund transaction for chargeback

422040

Unable to reverse provisional credit for chargeback

422041

Unable to grant provisional credit for chargeback

422042

Unable to create direct deposit

422043

Unable to create direct deposit transition

422044

Unable to map direct deposit state to internal transaction type

MCC Groups errors

MCC Groups endpoints 400

Error Code Error Message

400375

Invalid MCC start

400376

Invalid MCC end

400377

Invalid MCC range

400378

Invalid MCC

MCC Groups endpoints 403

Error Code Error Message

403009

User is forbidden to modify this MCC group

MCC Groups endpoints 404

Error Code Error Message

404325

MCC group not found

Merchants / Stores errors

Merchants / Stores endpoints 400

Error Code Error Message

400100

A merchant with the same token already exists

400101

A store with the same MID already exists

400102

A store with the same token already exists

Merchants / Stores endpoints 404

Error Code Error Message

404025

Merchant not found

404026

Store not found

MSA Orders / GPA Orders / Offer Orders / Offers / Credit Line Orders errors

MSA Orders / GPA Orders / Offer Orders / Offers / Credit Line Orders endpoints 400

Error Code Error Message

400125

An offer with the same token already exists

400126

Purchase amount must be greater than 0

400130

Purchase amount must not exceed: <amount>

400131

Amount plus fees must be greater than 0

400132

Fees may not be empty

400133

GiftDescriptors must not exceed: <amount>

MSA Orders / GPA Orders / Offer Orders / Offers endpoints 404

Error Code Error Message

404050

Order not found

404051

GPA order token not found

404052

Offer not found

MSA Orders / GPA Orders / Offer Orders / Offers endpoints 422

Error Code Error Message

422025

Single load card cannot be re-loaded

422026

Insufficient funds to perform load from program reserve

422027

Unable to load funds for user that has not passed KYC

SA Order Unloads / GPA Order Unloads / Offer Order Unloads / Credit Line Order Unloads errors

MSA Order Unloads / GPA Order Unloads / Offer Order Unloads / Credit Line Order Unloads endpoints 400

Error Code Error Message

400425

Unload amount is more than the load amount

400426

Cannot refund the points funding source

400427

Refund amount is less than or equal to zero

400428

Customer has no balance available

400429

The order token is not a valid GPA load token

400430

The order token is not a valid GPA unload token

400431

Unloads are not allowed for the given order

400432

Customer has no balance available in the campaign

400433

The order token is not a valid MSA unload token

400434

The order token is not a valid MSA load token

400435

The order token is not a valid credit line load token

MSA Order Unloads / GPA Order Unloads / Offer Order Unloads endpoints 404

Error Code Error Message

403008

User is forbidden from accessing this funding source

MSA Order Unloads / GPA Order Unloads / Offer Order Unloads endpoints 404

Error Code Error Message

404400

Return not found

404401

GPA unload order not found

MSA Order Unloads / GPA Order Unloads / Offer Order Unloads endpoints 412

Error Code Error Message

412010

Unload amount is more than the GPA balance

412011

Unload amount must not exceed available balance

Network Transaction Types errors

Network Transaction Types endpoints 400

Error Code Error Message

400725

Network tran type with the same network already exist

Network Transaction Types endpoints 404

Error Code Error Message

404550

Network tran type not found

Peer Transfers errors

Peer Transfers endpoints 400

Error Code Error Message

400250

Sender not found

400251

Recipient not found

400252

Unsupported currency code

400253

Sender user token and sender business token may not both be populated

400254

Recipient user token and recipient business token may not both be populated

400577

Business token was passed in user token field

400578

User token was passed in business token field

400579

Business tokens do not match

400581

Invalid active value

Peer Transfers endpoints 404

Error Code Error Message

404175

Transfer not found

Peer Transfers endpoints 422

Error Code Error Message

422050

Insufficient fund from sender account

422051

Sender and recipient must be active

422052

Cannot transfer funds on the same users

PINs/ Control Tokens errors

PINs / Control Tokens endpoints 400

Error Code Error Message

400275

Control token is invalid

PINs / Control Tokens endpoints 412

Error Code Error Message

412001

PIN is weak

Program APIs errors

Program APIs 400

Error Code Error Message

400501

Missing user tokens

400502

Missing card tokens

400503

Missing KYC or user tokens

400504

Missing DDA or user tokens or business tokens

400505

Active flag can not be applied to rule type

400507

Rule type already exists but is inactive

400508

Rule type already exists

400509

Missing business tokens

400511

Missing KYC or business tokens

400512

Cardholder token must not be populated if the rule is not at the cardholder level

400513

Cardholder token must be populated if the rule is at the cardholder level

Program APIs 404

Error Code Error Message

404200

Rule not found

404201

Program config group not found

404202

Card inventory not found

404203

Program config key not found

Program APIs 409

Error Code Error Message

409050

A rule with the same token already exists

Program Transfers errors

Program Transfers endpoints 404

Error Code Error Message

404720

Program transfer type not found

404721

Program transfer not found

Program Transfers endpoints 412

Error Code Error Message

412722

Transfer amount is more than the GPA balance

Push to Card errors

Push to Card endpoints 400

Error Code Error Message

400580

Push to Card provider not setup

400582

Invalid country code

400584

Name on card is incomplete

Push to Card endpoints 404

Error Code Error Message

404180

Push to Card information not found

Push to Card endpoints 422

Error Code Error Message

422130

Invalid card address

422131

Invalid or wrong CVV2

422132

Card not eligible for funding transfers

422133

Disbursement request declined

422134

Disbursement request declined due to insufficient funds

422135

Disbursement cannot be processed since the card is still provisioning for service

Simiulate errors

Simulate endpoints 400

Error Code Error Message

400325

Reversal cannot exceed the authorization amount

400326

Space not found

Simulate endpoints 404

Error Code Error Message

404250

Original transaction not found

404354

Retry can only be performed on a clearing transaction

404357

Transaction has already been cleared

404358

Retry can only be performed on a failed clearing transaction

Simulate endpoints 412

Error Code Error Message

412050

Unable to reverse transaction due to ITC

412051

Unable to reverse transaction due to state

Transaction errors

Transactions endpoints 404

Error Code Error Message

404300

Transaction token not found

Users errors

Users endpoints 400

Error Code Error Message

400050

A cardHolder with the same token already exists

400051

Parent not found

400052

Cardholder is not active

400053

Password mismatch

400054

Password has already been used

400055

Existing and new password cannot be the same

400056

Cardholder does not have an email

400057

User with the same email already exist

400058

Invalid birth date format received

400059

Invalid passport expiration date format received

400060

Invalid ID card expiration date format received

400061

User token cannot start with reserved keyword

400062

Cardholder may not use a business parent’s funding account

400063

Children of a user cardholder may not have children

400064

The child of a user cardholder that is the child of a business must use parent account

400065

User with a user child and a business parent must not use parent account

400066

Metadata key exceeded size limit of 255 characters

400067

Metadata value exceeded size limit of 255 characters

400068

Metadata key/value pair exceeded 20400074

400069

User with a user child and a business parent  must not use parent account

400070

Updating user parent is not allowed as user uses parent account

400071

Uses parent account cannot be set to true without setting a parent card holder

400072

Uses parent account cannot be unset

400073

Invalid metadata key detected

400103

User cannot have multiple SSN identification types

400108

User cannot have business identification type

Users endpoints 403

Error Code Error Message

403011

User is forbidden to update the active field

403012

User is forbidden to activate a user that was deactivated by a super user

403013

User is forbidden to activate a business that was deactivated by a super user

403014

User is forbidden to activate a card that was deactivated by a super user

403015

User is forbidden to activate a digital wallet token that was deactivated by a super user

403016

Override TSP error can only be set by admin user

403017

Override TSP error is only allowed for terminating tokens

User Transitions endpoints 400

Error Code Error Message

400750

Cannot transition user to active until it has passed KYC

400752

Cannot transition user from unverified to suspended

400754

Cannot transition user to limited until it has passed KYC

User Transitions endpoints 404

Error Code Error Message

404531

User transition not found

Webhooks errors

Webhooks endpoints 400

Error Code Error Message

400600

Maximum active webhooks exceeded

400601

Event type is invalid

400602

Event token is invalid

400603

Event type not accepted

400604

Marqeta signature does not match

400605

Invalid webhook token

Webhooks endpoints 422

Error Code Error Message

422600

Webhook operation failed

Batch File Processing errors

Batch File Processing endpoints 400

Error Code Error Message

400850

The input file $FileName could not be found

400851

Unable to access input file $FileName

400852

Invalid file extension, the input file $FileName must be of type $FileType

400853

Missing headers in the input file

400854

Missing required column header $ColumnName

400855

Invalid column name $ColumnName

400856

Column header at column index $ColumnIndex is empty

400857

The input file $FileName exceeds the maximum allowable size of $FileSize

400858

The processing was successful, however the response file $FileName not found

400859

An unexpected error occurred, unable to process your file

400860

Missing required metaData $FileMetadata

400861

Unable to download the input file $FileName

400862

Error occurred during the initialization of the Transport Processor

400863

Error occurred during the initialization of the Payment Client

400864

Consul service is missing either the service name $ServiceName or program name $ProgramName

400865

Consul service $ServiceName is missing API URL

400866

Missing required arguments bucket name $BucketName object name $ObjectName

400867

Unexpected input location format $LocationName

400868

Internal File Error

400869

Unable to process the input file $FileName as the file contents were processed previously

400880

Invalid data in column $ColumnName

400881

Invalid action, $Action is not supported

400882

Number of columns does not match header columns

400883

Action $Action not supported for funding the card

400884

Card token is missing, unable to update the card

400885

User token is missing, unable to update the user

400886

Invalid date format in column $ColumnName, the date format should be $DateFormat

400887

Internal Record Error $RecordNumber

Bank Transfer errors

Bank Transfer endpoints 400

Error Code Error Message

400255

Bank transfer speed is invalid

400256

Bank transfer status is invalid

400257

Bank transfer type is invalid

404534

Bank transfer not found

500122

There was a problem when retrieving Bank Transfer entry(s)

400585

Same_day ACH bank transfer must be less than 25000

400586

Funding source must be of Program Bank Account Funding Source type

400587

Funding source must be of User Bank Account Funding Source type

400588

Funding source must be of User or Program Bank Account Funding Source type

Have any feedback on this page?

If you feel we can do anything better, please let our team know.

We strive for the best possible developer experience.