Error codes: International payments

overview this page provides comprehensive error code information for the international payments api (swift), including error codes, descriptions, and resolution guidance based on actual codebase analysis error response format { "error" { "code" "2300", "message" "{2300}no estimate rate found for request", } } error codes by category general exceptions code description resolution 1000 validation error general validation error; check request parameters and contact support if issue persists 2000 application error general application error; check request parameters and contact support if issue persists beneficiary (2100 2103) errors related to beneficiary validation and currency/country support code description resolution 2100 beneficiary is not valid verify beneficiary information is complete and correct; check account number, bank details, and address 2101 currency is not supported use a supported currency; verify currency code is valid and enabled for international payments 2102 country is not supported country is not supported for international payments; verify destination country is in the supported countries docid\ p cb7wxlzg8of31c9xlgj list 2103 validation response is invalid beneficiary validation response is invalid; retry validation or contact support configuration (2200 2237) errors related to global, account, and product configuration management code description resolution 2200 this action requires dual control have a second authorized user approve the configuration change 2201 global profile change not pending operation requires global profile change to be in pending status 2202 global profile 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 product change not pending operation requires product change to be in pending status 2206 product change not approved product configuration change must be approved before applying 2207 product config change approval requires dual control have a second authorized user approve the product configuration change 2208 product config required include product configuration object in the request 2209 account config required include account configuration object in the request 2210 account change not pending operation requires account change to be in pending status 2211 account change not approved account configuration change must be approved before applying 2212 account config change approval requires dual control have a second authorized user approve the account configuration change 2213 account configuration not found or is invalid verify account configuration id is correct and configuration exists 2214 global profile not found or is invalid verify global profile id is correct and profile exists 2215 no active configuration found for account account must have an active configuration; create or activate account configuration 2216 currency not supported currency is not enabled in global or account configuration; add currency to supported currencies list 2217 product config change includes settings that are not supported for product type verify configuration settings are valid for the product type 2218 the operator account number has not been set in the global configuration configure operator account number in global configuration settings 2219 invalid currency for partner fee partner fee currency must match supported currencies; verify fee currency configuration 2220 duplicate currency for partner fees each currency can only be configured once for partner fees; remove duplicate currency entries 2221 all required accounts have not been configured in the global configuration complete all required account configurations in global settings 2222 all required accounts have not been configured in the account configuration complete all required account configurations for this account 2223 the customer for the specified account number was not found verify customer exists for the account number; check account customer relationship 2224 the swift aco flat rate has not been set in the global configuration configure swift aco flat rate in global configuration settings 2225 the local payment fee has not been set in the global configuration for the requested currency configure local payment fee for the requested currency in global settings 2226 the transaction fees have not been set in the global configuration configure transaction fees in global configuration settings 2227 inbound payments not enabled for account enable inbound payments in account configuration 2228 outbound payments not enabled for account enable outbound payments in account configuration 2229 limit start time (hh\ mm) not set for account set limit start time in account configuration (24 hour format hh\ mm) 2230 daily count limit not set for account set daily transaction count limit in account configuration 2231 daily amount limit not set for account set daily transaction amount limit in account configuration 2232 transfer amount limit not set for account set per transfer amount limit in account configuration 2233 cannot exceed daily count limit for account daily transaction count limit reached; wait until next limit period or increase limit 2234 cannot exceed daily amount limit for account daily transaction amount limit reached; wait until next limit period or increase limit 2235 cannot exceed transfer amount limit for account transaction amount exceeds per transfer limit; reduce amount or increase limit 2236 unsupported country code(s) one or more country codes are not supported; verify country codes are in supported countries list 2237 there are accounts misconfigured in the accountconfig or globalconfig review and correct account configuration and global configuration settings estimates (2300 2303) errors related to exchange rate estimates and fee retrieval code description resolution 2300 no estimate rate found for request unable to retrieve exchange rate estimate; verify currency pair is supported and retry 2301 fees not found for account or currency transaction fees not configured for account or currency; configure fees in account/global settings 2302 unable to retrieve rates at this time currency exchange rate service is unavailable; retry request after a few moments 2303 currency not supported currency is not supported for exchange rate estimates; use a supported currency quotes (2400 2406) errors related to quote creation, validation, and execution code description resolution 2400 beneficiary failed to create for quote unable to create beneficiary for quote; verify beneficiary information and retry 2401 estimate not found for quote quote requires an estimate; create an estimate before requesting a quote 2403 quote not found for originating payment verify quote id is correct; check if quote exists and has not expired 2404 quote has expired quote has passed expiration time; create a new quote with current exchange rates 2405 currency is not supported for selected bank country currency country combination is not supported; verify currency is available for destination country 2406 quote amount does not exceed minimum amount for conversion increase quote amount to meet minimum conversion threshold payment (2500 2507) errors related to international payment processing and validation code description resolution 2500 account configuration not found or is invalid verify account configuration id is correct and configuration exists 2501 invalid payment status check current payment status; verify the requested operation is valid for the current status 2502 payment not found for id verify the payment id is correct 2503 quote has already been executed quote has already been used for a payment; create a new quote for additional payments 2504 invalid payment type payment type is not valid; verify payment type is supported for international payments 2505 account type cannot be used for payments account type does not support payments; verify account is configured for payment operations 2506 posting status must be failed to attempt a retry only failed postings can be retried; verify posting status before retry 2507 payment does not have any fees that failed fee retry only applies to failed fees; verify fee status before retry holds (2600 2602) errors related to payment hold management code description resolution 2600 hold is not active hold must be in active status for this operation; verify hold status 2601 hold payment not found verify hold payment id is correct; check if hold payment exists 2602 hold account not found verify hold account number is correct; check if account exists reporting (2700 2707) errors related to payment and conversion report generation and retrieval code description resolution 2700 unable to parse line from csv file for conversion detail report csv file has invalid format; verify file structure and content 2701 failed to generate conversion report conversion report generation failed; verify report parameters and retry 2702 failed to generate payment report payment report generation failed; verify report parameters and retry 2703 invalid response after generating report report generation returned invalid response; retry report generation 2704 unable to parse line from csv file for payment detail report csv file has invalid format; verify file structure and content 2705 vendor report not found using external id verify external report id is correct; check if report exists payment detail (2800) errors related to payment detail retrieval code description resolution 2800 payment detail not found verify payment detail id is correct; check if payment detail exists