Error codes: onchain payments

overview this page provides error code information for the onchain payments (crypto) api, including error codes, descriptions, and resolution guidance error response format { "errors" \[ { "code" 2022, "message" "account type cannot be used for payments" } ] } error codes by category payment errors errors related to cryptocurrency payment processing, validation, and configuration code description resolution 2010 currency is not supported use a supported cryptocurrency; check product configuration for allowed currencies 2012 the destination address is not whitelisted for this customer or the whitelist cooldown period has not completed add destination address to whitelist; wait for cooldown period to complete 2018 gross fees are not supported for this currency use net fees for this currency; check fee configuration 2020 if amount and amountnative are both supplied they must represent the same value ensure amount and native amount match when both are provided 2022 account type cannot be used for payments account type is not configured for payment operations; verify account configuration 2026 payment exceeds maximum amount configured for product reduce payment amount or request limit increase; check product configuration 2027 the source account address cannot be the same as the destination address use different addresses for source and destination 2040 payment less than minimum amount allowed increase payment amount to meet minimum threshold 2043 inbound payment originator pii already exists originator personally identifiable information has already been recorded 2199 payments for non native currencies are disabled non native currency payments are not currently enabled; use native currencies 2214 account configuration not found or is invalid verify account configuration id is correct and configuration exists 2220 the account does not have an address for the requested blockchain configure address for the requested blockchain on this account 2222 the operator account number has not been set in the global configuration configure operator account number in global settings; contact administrator 2226 outbound payments not enabled for account enable outbound payments in account configuration 2230 the fee account number has not been set in the global configuration configure fee account number in global settings; contact administrator account address errors errors related to account address management and blockchain configuration code description resolution 2272 blockchain and currency pair not found or is invalid verify blockchain currency pair is configured and supported 2275 account configuration not found verify account configuration exists; create configuration if needed 2280 account address not recognized verify account address is registered and valid 2281 account address already exists account address is already registered; use existing address or modify 2452 cannot deactivate address vault has a non zero balance in fireblocks sweep vault balance to zero before deactivating address 2453 cannot deactivate address no fireblocks vault account id found address must have fireblocks vault account to be deactivated external address errors errors related to external address management and whitelist configuration code description resolution 2272 blockchain and currency pair not found or is invalid verify blockchain currency pair is configured and supported 2273 external address not recognized verify external address is registered and valid 2274 external address already exists external address is already registered; use existing address or modify 2275 account configuration not found verify account configuration exists; create configuration if needed