Marqeta.com
Support
/
25 minute read
December 2, 2020

Errors

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.

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 Code Description

200 OK

Your request completed successfully.

201 Created

Resource created successfully.

204 No Content

Returned on a successful

DELETE
.

401 Unauthorized

Enter valid credentials to continue.

403 Forbidden

Access to the requested resource is denied.

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

Unprocessable entity.

500 Internal Server Error

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

502 Bad Gateway

An invalid response was received by the server.

503 Service Unavailable

The server is temporarily unable to handle this request.

504 Gateway Timeout

The 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:

Copied

Is this helpful?

Yes
No

400001–400099 error codes

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.

400023

Reward program token not found or is not active.

400024

Reward token 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.

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 exists.

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 20.

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 cardholder.

400072

Uses parent account cannot be unset.

400073

Invalid metadata key detected.

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.

400100–400199 error codes

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.

400103

User cannot have multiple SSN identification types.

400104

Invalid expiration date format.

400105

Identifications contains duplicate identification types.

400106

Business cannot have multiple tax identification types.

400107

Expiration date not allowed for identification type(s).

400108

User cannot have business identification type.

400109

Business cannot have user identification type.

400111

Proprietor cannot have business identification type.

400112

Proprietor cannot have multiple SSN identification types.

400114

Chip fallback to magstripe not allowed.

400115

KYB not performed due to too many retries.

400116

KYB not performed due to invalid cardholder business status.

400117

Input validation error.

400118

Invalid state abbreviation.

400119

Invalid ZIP code.

400120

Invalid country code.

400121

Invalid taxpayer ID.

400122

KYB reference ID not found.

400125

An offer with the same token already exists.

400126

Purchase amount must be greater than 0.

400127

Reward amount must not be less than 0.

400128

Reward trigger amount must not be less than 0.

400129

Reward trigger amount should not exceed purchase power.

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

400134

Currency code not part of program currency.

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 cannot be applied to a business.

400157

This endpoint is reserved for user cardholder KYC only.

400158

Required fields for a business cannot be empty:

<x>
,
<y>
.

400159

KYC not permitted for cardholder with a P.O. Box address.

400160

number_of_days
and
velocity_window
may not both be populated.

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.

400163

number_of_days
or
velocity_window
must be populated.

400164

reference_id
may only be used for a manual override.

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 as 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.

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
.

400175

Campaign contains one or more active orders.

400176

Campaign is not active.

400177

MID is required.

400178

Cannot use numeric postfix with random postfix.

400200–400299 error codes

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.

400207

Invalid ISO language code. Only ISO 639-3 codes are allowed.

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.

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.

400255

Bank transfer speed is invalid.

400256

Bank transfer status is invalid.

400257

Bank transfer type is invalid.

400258

Program gateway customer headers key and/or value max size limit reached.

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

Customer due diligence is incomplete.

400270

Customer due diligence question or answer is invalid.

400271

One or more fields in the customer due diligence object is null.

400272

Only account type

CHECKING
requires customer due diligence.

400273

Direct deposit account requires only two customer due diligence entries.

400274

Direct deposit account is not active.

400275

Control token is invalid.

400276

PIN has not been set for this card.

400277

Customer due diligence not required for a non-checking account.

400278

Customer due diligence required when creating a checking account.

400279

Provided account type is invalid or is savings account, which is unsupported.

400300–400399 error codes

Error Code Error Message

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.

400302

Invalid shipping method received.

GROUND
is only valid for bulk orders.

400303

Invalid shipping method received. Bulk orders cannot be shipped via

LOCAL_MAIL
or
USPS_REGULAR
.

400325

Reversal cannot exceed the authorization amount.

400326

Space not found.

400350

Excess from reward token is invalid.

400351

One or more purchase tokens cannot be found or are still pending.

400375

Invalid MCC start.

400376

Invalid MCC end.

400377

Invalid MCC range.

400378

Invalid MCC.

400400–400499 error codes

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.

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.

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.

400483

Chargeback cannot be updated in current state.

400484

Chargeback cannot be updated after successful network submission.

400485

Cannot update CFP submission information.

400486

Cannot update network submission info without CFP submission info.

400487

Network submission time is required.

400488

Chargeback cannot be moved to this state from case lost.

400489

Chargeback cannot be moved to this state from case won.

400490

Invalid chargeback transaction reason.

400491

Chargeback transaction cash or pending entry must be present.

400492

Chargeback transaction entry must contain positive amount or fee amount.

400500–400599 error codes

Error Code Error Message

400500

In-app provision not allowed for a given card.

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 cannot be applied to rule type.

400506

Missing deposit account tokens.

400507

Rule type already exists but is inactive.

400508

Rule type already exists.

400509

Missing business tokens.

400510

Country codes missing.

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.

400514

Business cardholder must be over age 18.

400515

Invalid incorporation type.

400516

Beneficial owner 1 information cannot be empty.

400517

Beneficial owner 2 information cannot be empty.

400518

Beneficial owner 3 information cannot be empty.

400519

Beneficial owner 4 information cannot be empty.

400520

Proprietor officer address required fields cannot be empty.

400521

Office location required fields cannot be empty.

400522

Unable to create business detail.

400550

Business may not hold card.

400551

Invalid date established format received.

400552

Invalid incorporation type.

400553

Business is not active.

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.

400577

Business token was passed in user token field.

400578

User token was passed in business token field.

400579

Business tokens do not match.

400580

Push to Card provider not setup.

400581

Invalid active value.

400582

Invalid country code.

400583

Invalid expiration date.

400584

Name on card is incomplete.

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.

400589

Already existing Bank Transfer Transition with same status.

400592

Bank Transfer amount cannot be more than 25000 for same day.

400593

Only Bank Transfers with pending status can be cancelled.

400594

Bank Transfer cannot be transitioned to the requested state.

400595

Program reserve deposit not found.

400596

Problem retrieving Program Bank Account funding sources.

400597

Invalid value provided for

accountType
.

400598

Account type must be

DEPOSIT_TOKEN
if providing a deposit account token.

400599

Deposit account token must be provided if account type is

DEPOSIT_TOKEN
.

400600–400699 error codes

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.

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 as at least one of card, cardholder, 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 cannot 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.

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.

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.

400700–400799 error codes

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.

400702

Cannot create a demand deposit account for a business account.

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
.

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.

400710

The card must be active.

400725

Network tran type with the same network already exists.

400750

Cannot transition user to

ACTIVE
until it has passed KYC.

400751

Cannot transition business to

ACTIVE
until it has passed KYC.

400752

Cannot transition user from

UNVERIFIED
to
SUSPENDED
.

400753

Cannot transition business from

UNVERIFIED
to
SUSPENDED
.

400754

Cannot transition user to

LIMITED
until it has passed KYC.

400755

Cannot transition business to

LIMITED
until it has passed KYC.

400800–400899 error codes

Error Code Error Message

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

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
.

400900–400999 error codes

Error Code Error Message

400900

Invalid query parameters.

401000–401999 error codes

Error Code Error Message

401001

Invalid credential has been detected.

403000–403999 error codes

Error Code Error Message

403001

User does not have permission to access this endpoint.

403008

User is forbidden from accessing this funding source.

403009

User is forbidden to modify this MCC group.

403010

User is forbidden to set chargeback to written-off states.

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.

403200

Program is not enabled to access this endpoint.

404000–404999 error codes

Error Code Error Message

404000

Resource not found or unavailable.

404001

Card not found.

404002

Card transition not found.

404003

Merchant card not found.

404004

Cardholder not found.

404005

Digital wallet token transition not found.

404006

Balance for token and tenant not found.

404007

Balance for user token and tenant not found.

404008

Balance for user token, currency and tenant not found.

404025

Merchant not found.

404026

Store not found.

404050

Order not found.

404051

GPA order token not found.

404052

Offer not found.

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.

404100

Campaign not found.

404125

Card product not found.

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.

404163

Customer due diligence not found for given account token.

404164

Customer due diligence entry not found for given CDD token.

404175

Transfer not found.

404180

Push to Card information not found.

404200

Rule not found.

404201

Program config group not found.

404202

Card inventory not found.

404203

Program config key not found.

404250

Original transaction not found.

404275

Reward program token not found or is not active.

404276

Reward token not found.

404300

Transaction token not found.

404325

Auto reload not found.

404350

Chargeback not found.

404351

Chargeback transition 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.

404400

Return not found.

404401

GPA unload order not found.

404456

Digital wallet token not found.

404500

Accepted country not found.

404525

Account holder group not found.

404530

File processing not found.

404531

User transition not found.

404532

Business transition not found.

404534

Bank transfer not found.

404550

Network tran type not found.

404575

Commando mode transition not found.

404576

Commando mode not found.

404720

Program transfer type not found.

404721

Program transfer not found.

404722

Transfer amount is more than the GPA balance.

405000–405999 error codes

Error Code Error Message

405001

Resource not available.

409000–409999 error codes

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.

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.

409014

Card product group token is invalid.

409025

Cannot delete a default merchant campaign.

409026

Cannot update a default merchant campaign.

409050

A rule with the same token already exists.

409075

Reward already redeemed.

412000–412999 error codes

Error Code Error Message

412001

PIN is weak.

412003

Missing program ID setup error.

412010

Unload amount is more than the GPA balance.

412025

Chargeback amount has exceeded GPA balance.

412026

Chargeback amount has exceeded MSA balance.

412027

Chargeback transaction reasons are not setup.

412050

Unable to reverse transaction due to ITC.

412051

Unable to reverse transaction due to state.

412075

Account not found.

412722

Transfer amount is more than the GPA balance.

422000–422999 error codes

Error Code Error Message

422001

Insufficient funds.

422002

General unprocessible exception:

<x>
.

422003

Unsuccessful response from token services gateway:

<x>
.

422015

Unable to create card for a user who has not passed KYC.

422016

Unable to create a demand deposit account for a user who has not passed KYC.

422025

Single load card cannot be reloaded.

422026

Insufficient funds to perform load from program reserve.

422027

Unable to load funds for a user who has not passed KYC.

422037

Cardholder 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.

422050

Insufficient fund from sender account.

422051

Sender and recipient must be active.

422052

Cannot transfer funds on the same users.

422075

The initiated chargeback is not associated to a transaction.

422077

The chargeback transaction did not create successfully.

422125

Unable to exceed max balance.

422126

Non program funding source load is not allowed.

422127

Reloads are not allowed.

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.

422150

Commando mode cannot be updated due to its current state.

422600

Webhook operation failed.

424000–424999 error codes

Error Code Error Message

424001

Balance gateway is not enabled.

500000–500999 error codes

Error Code Error Message

500000

Internal server error.

500017

KYB gateway database error.

500018

KYB gateway timeout error.

500019

KYB gateway system error.

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.

500122

There was a problem when retrieving bank transfer entry(s).

500124

There was a problem with updating customer due diligence.

500125

There was a problem with retrieving customer due diligence.

500126

There was a problem creating a deposit account.

500175

Error returned from KYC provider.

Feedback on this page?

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