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 2042) 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 2035 card can not be activated from current status check the current card status using card details by id docid\ r5zwm6vkwz vs8 uvbzoh api endpoint; verify card is in a valid state for activation (e g , not closed, not already activated); ensure card has been shipped before attempting activation 2036 cannot close this card as newer card exists a replacement card has been issued for this card; close the newer card first, or if the newer card should remain active, no action is needed on this older card 2037 cannot authorize the card's account account authorization failed; verify the account is active and in good standing; check account has sufficient authorization to perform the requested operation; ensure account is not locked or restricted 2038 authorization for the card's account timed out account authorization failed; verify the account is active and in good standing; check account has sufficient authorization to perform the requested operation; ensure account is not locked or restricted 2039 wallet token not found digital wallet token does not exist; verify the token id is correct; check token was successfully provisioned using the wallet provisioning api; ensure token has not been deleted 2040 wallet token invalid status wallet token is not in a valid status for the requested operation; check token status using the retrieve specific wallet token docid\ m4qvkvrg6emlcjbmotz 7 api endpoint to verify token is active and not suspended or deleted 2041 card token can only be suspended currently token status allows only suspension operations at this time; if you need to perform a different operation, first update token to a status that supports it; for deletion, suspend the token first 2042 card token action is required a required action must be performed on the card token; check token lifecycle requirements; complete any pending activation or verification steps before proceeding card configuration (2100 2114) 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 2107 offsetaccountnumber not found offset account number specified in configuration does not exist; verify the offset account number is correct; ensure offset account has been created in the system before configuring 2108 card processor cannot be changed card processor is immutable once set; to use a different processor, create a new card configuration; existing cards will continue using the original processor 2109 card config program id not found program id referenced in card configuration does not exist; verify the program id is correct; ensure program has been created before associating with card configuration 2110 card config authorization type cannot be changed authorization type is immutable once card configuration is created; to use a different authorization type, create a new card configuration; existing cards will use the original authorization type 2111 carddesignid is not supported by card configuration the specified card design id is not compatible with this card configuration; verify card design id is correct; check card design is enabled for this configuration 2112 multiple card config found query returned multiple card configurations when only one was expected; provide more specific search criteria such as exact configuration id; verify configuration is not duplicated in the system 2113 setting program id is already associated with a partner this program id is already linked to another partner; each program id can only be associated with one partner; use a different program id or unlink from the existing partner first 2114 setting carddesign id is already associated with a partner this card design id is already linked to another partner; each card design can only be associated with one partner; use a different card design id or unlink from the existing partner first product configuration (2150 2154) 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 2154 product config not found product configuration does not exist; verify product configuration id is correct; check product is active 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 2364) 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 2358 auth was not found (duplicate of 2351, but for captures) authorization not found for capture operation; verify authorization id is correct; ensure authorization exists and has not expired; check authorization was successful before attempting capture 2359 host timeout already received for this transaction a host timeout has already been recorded for this transaction; do not retry; transaction is in terminal state; query transaction status to determine final outcome 2360 reversal amount cannot be more than the transaction amount reversal amount exceeds original transaction amount; verify reversal amount is correct; reversal amount must be less than or equal to the original transaction amount 2361 action requires card has been previously activated this operation requires the card to be activated; activate the card first using activate card by id docid\ e u42earziwdzoiixuuni api endpoint; verify activation completed successfully before retrying operation 2362 action requires card has not been previously activated this operation cannot be performed on an activated card; verify card status; if card should not have been activated, issue a replacement card 2363 either retrieval reference number or system trace audit number must be present include either retrievalreferencenumber or systemtraceauditnumber in the request; at least one identifier is required to process the transaction 2364 either retrieval reference number or transaction identifier must be present include either retrievalreferencenumber or transactionid in the request; at least one identifier is required to locate the transaction 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 partners (2400 2401) partner management and validation errors code description resolution 2400 partner not found partner id does not exist in the system; verify partner id is correct; ensure partner has been onboarded; check partner has not been deleted; use get /partners to list available partners 2401 partner is inactive partner account is in inactive status; operations cannot be performed for inactive partners; contact partner administrator to activate partner account; verify partner agreement is current cos card management (2450 2457) code description resolution 2450 loanid is null or empty, cannot resolve account number loanid is required but was not provided or is empty; include valid loanid in the request 2451 failed to retrieve webhook secret from aws secrets manager unable to access webhook secret from aws secrets manager; verify aws credentials are configured correctly; check secrets manager permissions; ensure secret exists in the correct aws region; verify network connectivity to aws 2452 webhook secret key not found in aws secrets manager webhook secret does not exist in aws secrets manager; verify secret name is correct; ensure secret has been created in secrets manager; check secret is in the correct aws region and account 2453 unknown monetary event type webhook contains an unrecognized monetary event type; verify event type is supported; api documentation for valid event types; ensure webhook payload format matches expected schema 2454 no account configuration found for loanid loanid does not have an associated account configuration; create account configuration for this loanid 2455 webhook payload is missing webhook request body is empty or null; ensure webhook payload is included in post request body; verify content type header is set to application/json; check webhook is configured correctly 2456 webhook payload is missing event id required field event id is missing from webhook payload; verify webhook payload includes event id field; check webhook configuration; ensure webhook format matches expected schema 2457 webhook payload is missing event type required field event id is missing from webhook payload; verify webhook payload includes event id field; check webhook configuration; ensure webhook format matches expected schema 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