{
"errorCode": "P4103",
"errorName": "insufficient-funds",
"errorMessage": "Insufficient funds"
}errorCode - a stable code, e.g. P4103. Use it to drive your application logic.errorName - a stable, readable identifier of the error type.errorMessage - a description intended for debugging, logging and support analysis. Do not rely on its exact wording in your code.P4007)P4007 is returned with HTTP 400 when the request fails format or schema validation - for example a missing required field, an invalid enum value, a wrong format or a value out of range.{
"errorCode": "P4007",
"errorName": "validation-error",
"errorMessage": "walletType must be one of the following values: SELF_CUSTODY, CUSTODIAL"
}errorMessage may contain several validation problems in one string, separated by commas. For the full validation rules, see the schema of the endpoint.errorCode for logic - treat P4007 as a general validation failure, and implement targeted handling for specific codes such as P4103 (insufficient funds) or P4201 (invalid lock).errorMessage - always log the full message for debugging, but do not display raw technical messages to end users.4xx errors will not succeed when repeated without changes. For 500, retry later - but for withdrawals and exchanges, first check whether the transaction was created (see Transaction Processing).| Error Code | Error Name | Error Message Example | When it occurs |
|---|---|---|---|
P4007 | validation-error | amount must be a positive numeric string | The request failed format or schema validation. |
P4103 | insufficient-funds | Insufficient funds | The balance is too low for the withdrawal or exchange. |
P4104 | amount-below-minimum | Amount below minimum | The amount is lower than withdrawal.minAmount or exchange.minAmount in Get Balances. |
P4105 | amount-precision-exceeded | Amount has too many decimal places for this currency | The amount has more decimal places than the precision of the currency. |
P4201 | invalid-lock | Lock is not valid or not exist | The lock does not exist, has expired or has already been used. Create a new lock. |
P4202 | invalid-exchange-pair | Exchange is only allowed between EUR and a cryptocurrency | The exchange is not between EUR and a cryptocurrency. |
P4301 | wallet-address-not-valid | Wallet address not valid | The wallet address is not valid for the given network. |
P4302 | wallet-address-already-whitelisted | Wallet address already whitelisted | The address (with the same memo) is already on the whitelist. |
P4303 | wallet-address-not-whitelisted | Wallet address not whitelisted | The walletId does not exist on your whitelist or has been removed. |
P4304 | ownership-declaration-required | Ownership declaration must be confirmed when owner type is SENDER | ownerType is SENDER and ownershipDeclaration is not true. |
P4305 | travel-rule-data-already-added | Travel rule data already added for this wallet address | Travel Rule information has already been provided for this address. To correct it, contact support. |
| Error Code | Error Name | Error Message Example | When it occurs |
|---|---|---|---|
P4001 | missing-api-key | API key is missing | The x-api-key header is missing. |
P4002 | invalid-api-key | API key is invalid | The API key is invalid or belongs to the other environment. |
| Error Code | Error Name | Error Message Example | When it occurs |
|---|---|---|---|
P4003 | ip-not-allowed | Request from this IP address is not allowed | The request comes from an IP address that is not whitelisted for your account. |
P4004 | access-denied | Access denied, you do not have permission for this action | Your account does not have permission for this action. |
| Error Code | Error Name | Error Message Example | When it occurs |
|---|---|---|---|
P4101 | balance-not-found | Balance not found | The balance does not exist or does not belong to your account. |
P4102 | transaction-not-found | Transaction not found | The transaction does not exist, does not belong to your account or is of a different type than the endpoint. |
P4306 | whitelisted-wallet-address-not-found | Whitelisted wallet address not found | The whitelisted wallet does not exist or has already been removed. |
| Error Code | Error Name | Error Message Example | When it occurs |
|---|---|---|---|
P5000 | unknown-error | Please contact us | An unexpected server error. Retry later. If the problem persists, contact support@fintegence.com. |