Error codes: Cards

overview this page provides comprehensive error code information for the cards api, including error codes, descriptions, and resolution guidance based on actual codebase analysis error response format { "error" { "code" "2001", "message" "{2001}customerid was not found or not associated with card", } } error codes by category general exception code description resolution 1000 validation error general validation error; check request parameters and contact support if issue persists cards (2001 2034) errors related to card operations, activation, suspension, and management code description resolution 2001 customerid was not found or not associated with card verify the customer id is correct and has an active card association; check customer exists in the system 2002 card can not be activated check card status and ensure card is in a state that allows activation; verify card has been issued and shipped 2003 card was already activated card has already been activated; no further action needed unless card needs to be reissued 2004 card can not be suspended verify card status allows suspension; ensure card is active before attempting to suspend 2005 card is not suspended operation requires card to be in suspended status; verify card status before attempting operation 2006 card is already closed card has been permanently closed and cannot be modified; issue a new card if needed 2007 pin cannot be set on closed cards cannot set pin on closed cards; issue a replacement card if pin change is needed 2008 account relationship type is not eligible for debit cards account type does not support debit card issuance; verify account type and relationship configuration 2009 account does not belong to customer verify the account number is associated with the specified customer id 2010 card order has not completed processing card order is still being processed; wait for order completion before attempting card operations 2011 card is closed card is in closed status; operations cannot be performed on closed cards; issue a replacement card 2012 request has not completed previous request is still processing; wait for completion before submitting new request 2015 primary card not found primary card must exist before supplementary cards can be issued; create primary card first 2020 card not found verify the card id is correct; check if card exists using card details by id docid\ r5zwm6vkwz vs8 uvbzoh 2021 processor card id is invalid processor assigned card id is invalid or not found; verify card was successfully created at processor 2022 customer already has a card for this account each customer can only have one card per account; use existing card or close it before creating new one 2023 card order must be complete operation requires card order to be in completed status; wait for order processing to finish 2024 card has not been activated card must be activated before performing this operation; activate card first 2025 card is already suspended card is already in suspended status; cannot suspend again 2026 card is already adminblocked card is already blocked by administrator; cannot block again 2027 card configuration not found verify card configuration id exists and is associated with the product 2028 card provider not found card provider configuration is missing; verify provider setup in system 2029 card not found at processor card does not exist at the card processor; verify card was successfully created and synced 2030 card order is not complete card order must complete before performing this operation; wait for order processing 2031 company name can only be used on cards associated with business accounts company name field requires business account classification; verify account type 2032 card replacement has not completed card replacement is still processing; wait for replacement to complete 2033 pin must be four digits pin must be exactly 4 numeric digits; provide a valid 4 digit pin 2034 card has already been replaced card has been replaced with a newer card; operations should be performed on the replacement card card configuration (2100 2106) errors related to card configuration and product settings code description resolution 2100 cards not enabled on product enable card issuance on the product configuration before attempting to create cards 2101 card config not found verify the card configuration id is correct and exists in the system 2102 card config change not pending operation requires a pending configuration change; verify change status 2103 card config not associated with product associate the card configuration with the product before using it 2104 card config not enabled enable the card configuration before attempting to use it for card issuance 2105 shippingtype not supported by card configuration use a shipping type that is supported by this card configuration 2106 cardconfigstatus must be provided on updates include cardconfigstatus field when updating card configuration product configuration (2150 2153) errors related to product configuration changes and approvals code description resolution 2150 change not approved configuration change must be approved before applying; submit for approval first 2151 product change not pending operation requires product change to be in pending status; verify change status 2152 product config change approval requires dual control have a second authorized user approve the product configuration change 2153 product config required include product configuration object in the request integration (2200) errors related to external system integrations code description resolution 2200 tcp error network communication error with card processor; check network connectivity and retry accounts (2301 2302) errors related to account operations and status code description resolution 2301 account not found verify the account number is correct and the account exists in the system 2302 account is closed account is in closed status; operations cannot be performed on closed accounts simulator (2350 2357) errors related to transaction simulation and testing code description resolution 2350 authorization already been cleared authorization has been cleared; cannot perform operation on cleared authorization 2351 auth was not found verify the authorization id is correct; check if authorization exists 2352 error occurred generating referenceid system error generating reference id; retry the operation 2353 transaction was not found verify the transaction id is correct; check if transaction exists 2354 transaction has already been reversed transaction has been reversed; cannot reverse again 2355 transaction category is not valid provide a valid transaction category from the allowed list 2356 transaction type is not valid with this category transaction type does not match the specified category; verify type/category combination 2357 authorization was reversed authorization has been reversed; cannot perform operations on reversed authorization bin sponsorship (2375 2380) errors related to bin sponsorship card operations code description resolution 2375 primarycustomerid was not found verify the primary customer id is correct and customer exists in the system 2376 parentcustomerid was not found verify the parent customer id is correct and customer exists in the system 2377 bin sponsorship card already exists bin sponsorship card already exists for this customer; use existing card or close it first 2378 primary customer and parent customer must have the same partnerid ensure both primary and parent customers are associated with the same partner 2380 bin sponsorship card was not found verify the bin sponsorship card id is correct; check if card exists security configuration (3001) security related errors for configuration operations code description resolution 3000 general exception 3001 access denied user lacks permission to access configuration; verify user has appropriate role and permissions security cards (3100) security related errors for card operations code description resolution 3100 card is locked by admin card has been locked by administrator; contact administrator to unlock card