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