Errors

If the API may encounter errors during transactions. These errors are categorized into Content Validation Errors and Processor Errors, each provides code associated with the description of the error to help diagnose and resolve issues in the payment process.

Content Validation Errors

Content Validation Errors occur when there are problems with the data or parameters provided in the payment request. These errors range from empty authentication details to invalid values for fields such as first name, last name, address, phone number, or invalid amounts. These errors serve as indicators for developers and users to validate and ensure the accuracy and completeness of the payment information being submitted. By addressing these errors, users can ensure the integrity of the payment data and increase the chances of successful transactions.

Processor Errors

Processor Errors, on the other hand, relate to issues encountered during the processing of the payment request by the underlying payment processor. These errors cover a wide range of scenarios, including invalid card numbers, processing failures, authentication errors, limit violations, and various other specific error conditions. Processor Errors provide insights into the specific reason for the failure and help in troubleshooting and resolving the issue with the payment processor's support or technical team.

In both cases, it is essential to build applications with logic built around error-handling mechanisms in place to capture and process these errors. Proper error handling can include logging the error details, providing clear error messages to users, and implementing fallback or recovery strategies to minimize the impact on the payment flow. By effectively addressing and resolving these errors, businesses can ensure a smooth and reliable payment experience for their customers.

Possible Content Validation Error Codes:

Error CodeDescription
10011Empty Authentication Details.
10012Invalid Authentication Details.
10000Invalid API request/Invalid XML
10001Invalid Value for field FirstName, Provided Value Null
10002Invalid Value for field LastName, Provided Value Null
10003Invalid Value for field AddressLine1, Provided Value Null
10004Invalid Value for field City, Provided Value Null
10005Invalid Value for field State, Provided Value Null
10006Invalid Value for field Zip, Provided Value Null
10007Invalid Value for field Phone, Provided Value Null
10008Invalid Customer Id , Data Not found
10009Invalid Value for field Date Of Birth, Provided Value Null
10010Invalid Value for field RPID, Provided Value Null
10013Duplicate CustId, CustId must be unique
10014Invalid Value for field DocId, Provided Value Null
10015Invalid Amount
10016Insufficient amount to load.
10017Card not created yet.
10018Invalid Program ID, the provided program doesn't exist.
10021No Card Issued for customer Id , Data Not found

Possible Processor Error Codes:

Error CodeDescription
40000Processor error
40011Invalid Card Number
45004Error processing request message
45006From Card Status Change Failure
70000Processor error
70004InvalidPassword
70008InvalidIssuer
70009Invalid Issuer Active Status
70012ServiceNotAllowed
70016InvalidCardholder
70019CH Already Registered
70021Invalid Card Id
70022INVALID CARD ACTIVE STATUS
70025Invalid Status
70028SDO can not be decreased/ Cannot set SDO for an unlimited LAM value
70029Data not found (cardholder not found)
70032InvalidParameters
70033TooManyData
70037InvalidValidationParameter
70038LimitViolation
70043DuplicateDefinition
70044Could not get inventory data
70046AllocationImpossible
70047Invalid RPID location
70051Relationship Not Found
70052InvalidDataDefinition (store by term not find, PT not find)
70055Operation Not Supported
70056Product Type Not Allowed
70057Card Holder Not Verified
70061LAM Limits Violation
70062Exceeds Daily Load Limit
70063Exceeds LAB Limit
70064Invalid Product Type
70065ProgramConstraintViolation
70068LAM is not defined for the entity
70069terminal already exists
70071SourceAndTargetCardsIdentical
70072Card is not Activated
70075InvalidCardState
70076DocumentTypeNotAllowed
70077MaxPTVerifiedLoadAmountReached
70078FailedOFACCheck
70079MaxPTUnverifiedLoadAmountReached
70080CHNotVerifiedDueToPT
70081CHNotVerifiedDueToParameter
70082InvalidLaOwnerOrgValue
70083LaOwnerOfActiveStoresInHierarchy
70084RequiredActiveLaOwnerOrgForActiveStores
70085BankDetailsRequired
70090REPLACEMENT_CARD_FAILURE_DUE_TO_GET_CARD_BALANCE_FAILURE
70091REPLACEMENT_CARD_FAILURE_DUE_TO_SUSPEND_CARD_FAILURE
70092REPLACEMENT_CARD_FAILURE_DUE_TO_CARD_TO_CARD_TRANSFER_FAILURE
70093Replacement Card Failure Due To close Initial Card Failure
70094REPLACEMENT_CARD_FAILURE_DUE_TO_DDA_SWAP_FAILURE
70095REPLACEMENT_CARD_FAILURE_DUE_TO_INVALID_AMOUNT_IN_INITIAL_CARD
70111Federal Benefit Enrollment Already Exists
70112Invalid Cardholder Status
70113Invalid Card Number
70115Replacement Card Failure Due To InformLostStolen Initial Card Failure
70116Invalid Card Status
70117Invalid Suspend Reason
70122FBE DDA already exists for CardNumber2
70144CardIsNotInStatusOpen
70148Effective Date Already Past
70149Invalid Effective Date
70150Missing OFAC Field Value
70151Invalid Settlement Date
70156Holds Parameters Conflict
70159Holds Retrieve Failure
70161Federal Benefit Enrollment Not Exist
70163Amount Must Be Positive
70164Fee Definition Already Exist
70165Fee Definition Not Exist
70166Invalid ID
70169Invalid Product Type Attribute
70170Praxell Code Already Exists
70177Invalid Expiration Period
70181Invalid Doc Type
70182Card To Card Transfer Failure and Card1 was reloaded
70183Card To Card Transfer Failure and Card1 cannot be reloaded
70184Load Network Not Defined
70185Event Not Allowed
70186Card Not Suspended
70187Invalid ACH Transaction ID
70188New Card Created But Card Issuer ID Definition Failed
70198Doc Type is not SSN
70199Session Not Exist
70200Session Already Closed
70201Invalid Organization
70203Invalid Org To Org Relation
70204Org To Org Relation Already Exist
70205User Not Allowed to Create Call Center
70206Issuing Unverified Card Failure
70207OOW Verification Not Allowed
70210Cardholder already verified
70211Reference ID Failure
70213Maximum Time to Answer Questions Failure
70216verification error
70217Answers verification error
70219Invalid Initial Card Status
70220Replace Card Link Is Missing
70221Initial Card Already Replaced
70223Update Cardholder Failure
70226Verify By Card Issuer Not Allowed
70228Invalid Previous Card Id
70229Invalid RPID Format
70230RPID Already Exists
70231Invalid DOB
70238Device Authentication Request Already Exist
70239Device Authentication Limit Reached
70240Device Authentication Failure Due to Multiple Authentications
70241Device Authentication Failure And Authentication Code Created
70242Device Authentication Request Already Exist For This Device
70243Device Authentication Data Not Found
70244Device Authentication Code Error
70245Device Authentication Details Error
70246Device Authentication Code Expired
70247Device Authentication Code Failure Retries
70248Device Authentication Not Found
70250Replacement Card Status Failure
70251Replacement Card Already Ordered
70252Invalid Replacement Card ID
70254Invalid Card's Bank For Operation
70255Replacement Card Failure Since Initial Card Not Active
70256Replacement Card Failure
70269Card Status Activation Action Failed
70271Bill Payment Provider Not Allowed For Product Type
70273Biller Not Found For BPPBillerID
70277PT Not Eligible For Bill Payment
70278Unload For Bill Payment Failure
70279Reload After Bill Payment Failure
70282File does not exist
70283Session Is Not Escalated
70284New PIN Identical to current PIN
70285File Already Exist For Org
70287New Password Identical to current Password
70289Org of User Param Unfit Org Param
70290User Does Not Exist
70291Invalid AML Exception ID
70292Organization Not Allowed For Card
70294Account does not exist
70304Card Number-ID Parameters Failure
70323File Cannot Be Deleted
70327Invalid File Content
80000General error (no balance back from MV)
80002UserMustChangePassword
80003Invalid Credentials
80006UserBlocked
80007OrganizationBlocked
80008not found organization
80029Data not found (Product Type not Found, BIN not Found, Couldn’t find retail pack by ID/DDA number)
80032InvalidParameter (Date or Time format from MW is wrong, Card Number is empty)
80204Non Repudiation Violated (use for WU)
80206LAST_INVALID_CREDENTIALS_BEFORE_BLOCKED
80210Could not Validate data (params)