---
title: Error codes: onchain payments
slug: apis/onchain-payments/error-codes-crypto
description: Reference common error codes such as validation, application, security, and system errors in crypto API responses.
docTags: 
createdAt: 2024-08-08T13:41:13.130Z
---

## Overview

This page provides error code information for the Onchain Payments (Crypto) API, including error codes, descriptions, and resolution guidance.

## Error response format

```json
{
    "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    |