Error codes: COS Card payments

overview this page provides comprehensive error code information for the card payments api, including error codes, descriptions, and resolution guidance based on actual codebase analysis error response format card payments api response format { "error" { "code" "2001", "message" "card expired", } } error codes by category cards (2001 2006) errors related to card validation and authorization code description resolution 2001 card expired card expiration date has passed; use a valid card with future expiration date 2002 card not found verify the card id is correct; check if card exists in the system 2003 card not authorized card is not authorized for this operation; verify card status and permissions 2004 card capabilities not defined card capabilities must be defined in card configuration 2005 card is inactive card must be in active status for this operation; activate card before processing payment 2006 card account number does not match payment account number ensure card account number matches the payment account number payments (2101 2110) errors related to payment processing and validation code description resolution 2101 invalid payment status check current payment status; verify the requested operation is valid for the current status 2102 payment not found verify the payment id is correct; check if payment exists using get /payments/ 2103 preprocessing is required payment must be preprocessed before processing; call preprocessing endpoint first 2104 payment information does not match preprocessing request payment data must match the preprocessing request; verify all fields match preprocessed data 2105 cvv is required for this payment include cvv (card verification value) in the payment request 2106 payment cannot be finalized unless it's in a cleared status wait for payment to reach cleared status before attempting to finalize 2107 valid ofac scan could not be found ofac screening must be completed successfully before processing payment 2108 payment source not valid for synchronous payments payment source type does not support synchronous processing; use asynchronous processing 2109 domestic payments are not supported for preprocessing preprocessing is only available for international payments; process domestic payments directly 2110 payment has ofac hit payment has been flagged by ofac screening; review and resolve ofac compliance issue configuration (2200 2232) errors related to global, account, and product configuration management code description resolution 2200 global profile change not pending operation requires global profile change to be in pending status 2201 global profile not found or is invalid verify global profile id is correct and profile exists 2202 global change not approved global configuration change must be approved before applying 2203 global config change approval requires dual control have a second authorized user approve the global configuration change 2204 global config required include global configuration object in the request 2205 global config accounts must be unique use different account numbers for each global configuration field 2206 offset account not found verify offset account exists; configure valid account number 2209 account change not approved account configuration change must be approved before applying 2210 account change not pending operation requires account change to be in pending status 2211 this action requires dual control have a second authorized user approve the configuration change 2212 account has not been enabled to send credit transfers enable credit transfer send in account configuration 2213 account config change approval requires dual control have a second authorized user approve the account configuration change 2214 account configuration not found or is invalid verify account configuration id is correct and configuration exists 2215 product change not pending operation requires product change to be in pending status 2216 product change not approved product configuration change must be approved before applying 2218 product config change approval requires dual control have a second authorized user approve the product configuration change 2219 account config required include account configuration object in the request 2220 product config required include product configuration object in the request 2221 product not configured product must be configured before processing payments 2222 action not enabled for card brand card brand (visa, mastercard, etc ) does not support this action; verify card brand capabilities 2224 daily total dollar amount limit exceeded daily payment amount limit reached; wait until next day or increase limit 2226 daily sent payment count limit exceeded daily payment count limit reached; wait until next day or increase limit 2227 payment type not allowed for this card card does not support this payment type; verify card capabilities and payment type 2228 card issuer country not authorized for merchant card issuer country is not in merchant's authorized countries list; add country to whitelist 2229 business type not allowed business type is not authorized for this merchant; verify merchant business type configuration 2230 correspondingentity information is required include corresponding entity information in the request for regulatory compliance 2231 purposeofpayment is required for the card issuer country include purpose of payment for cross border transactions from this card issuer country 2232 full address is required for the card issuer country include complete address (street, city, state/province, postal code, country) for card issuer country compliance products (2301) errors related to product operations code description resolution 2301 product not found verify the product id is correct and product exists in the system fx rates (2401) errors related to foreign exchange rate operations code description resolution 2401 request failed fx rate request failed; verify request parameters and retry holds (2500) errors related to payment hold management code description resolution 2500 hold is not active hold must be in active status for this operation; verify hold status security payments (3001) security related errors for payment operations code description resolution 3001 clearing hold exceeds user permissions for payment amount request approval from user with higher dollar limit for hold clearance security configuration (3200) security related errors for configuration operations code description resolution 3200 access denied user lacks permission to access configuration; verify user has appropriate role and permissions