Error and error codes
DocsCurrent
Last updated: Oct 18th, 5:46am
During your onboarding journey, you may encounter error codes.
The following table details any errors you could encounter while creating, verifying, updating, and monitoring the accounts.
| Error | Error Description |
|---|---|
| MISSING_REQUEST_BODY | Request body is missing |
| CLIENT_EXCEPTION | Error Calling downstream API |
| ACCOUNT_CANNOT_BE_FETCHED | Account cannot be fetched |
| VALIDATION_ERROR | Data not valid for field |
| MISSING_FIELD | Missing field |
| MISSING_REQUIRED_PARAMETER | Missing required field or parameter |
| INVALID_FORMAT | Data not valid for field |
| INVALID_PARAMETER_VALUE | The value of a field is invalid. |
| MALFORMED_REQUEST_ERROR | Malformed request |
| INTERNAL_SERVER_EXCEPTION | INTERNAL_SERVER_ERROR |
| PAYMENT_REVIEW_STATUS_ERROR | Error processing Payment review status |
| INVALID_RESERVE_TYPE | Reserve type is invalid |
| INVALID_ROLLING_RESERVE_PERCENT | Rolling reserve percentage is invalid |
| INVALID_ROLLING_RESERVE_PERIOD | Rolling reserve period is invalid |
| MISSING_ROLLING_RESERVE_PERCENT | Rolling reserve percentage is missing |
| MISSING_ROLLING_RESERVE_PERIOD | Rolling reserve period is missing |
| RESERVE_CONFIGURATION_NOT_FOUND | Reserve configuration for this account doesn't exist |
| RESERVE_RELEASE_IN_PROGRESS | Reserve release is already in-progress |
| RESERVE_ERROR_EXCEPTION | Reserve operation occurs an internal service error |
| INVALID_FIXED_RESERVE_EXPIRATION_DATE | Expiration date exceeds 180 days |
| OUT_DATE_FIXED_RESERVE_EXPIRATION_DATE | Expiration date cannot be less than or equal the current date |
| MISSING_FIXED_RESERVE_AMOUNT | Amount is missing |
| ZERO_FIXED_RESERVE_AMOUNT | Amount specified is zero |
| INVALID_FIXED_RESERVE_AMOUNT | Invalid currency/value for target amount field. |
| INVALID_FIXED_RESERVE_CURRENCY | Fixed reserve can only be placed on primary currency of the account |
| UNKNOWN_RESERVE_CONFIG_ERROR | Error processing reserve configuration |
| RELEASE_PARALLEL_CALLS_ERROR | Previous release is in-progress. Please try later |
| RELEASE_INSUFFICIENT_FUNDS_ERROR | The balance is insufficient |
| INSTRUMENT_ACCOUNT_NUMBER_MISSING | Account number is missing |
| INSTRUMENT_CURRENCY_CODE_MISSING | Currency code is missing |
| INSTRUMENT_COUNTRY_CODE_MISSING | Country code is missing |
| INSTRUMENT_ACCOUNT_NUMBER_TYPE_MISSING | Account number type is missing |
| ACCOUNT_CREATION_ERROR | Account Cannot be created |
| USER_ACCOUNT_CLOSED | Cannot add a bank to a PayPal account that is closed |
| NOT_SUPPORTED | Bank account country and PayPal account country combination not allowed |
| INSTRUMENT_UNAVAILABLE | Not a bank supported by PayPal |
| MULTIPLE_BANKS | Only one Bank allowed to add |
| CANNOT_ADD_BANK | Bank account has already been added |
| CANNOT_ADD_BANK_RISK_DENIAL | Unable to add bank |
| MULTIPLE_BANKS_NOT_PERMITTED | Only one financial instrument is permitted |
| MULTIPLE_PATCH_OPERATIONS_WITH_FI | Only add one Financial Instrument for this PATCH operation |
| CANNOT_REMOVE_BANK | Unable to remove bank. Please try again later. |
| CANNOT_REMOVE_BANK_HARD_DECLINE | Unable to remove bank. Please check bank account. |
| CANNOT_REMOVE_BANK_NEGATIVE_BALANCE | Unable to remove bank due to negative account balance. |
| BANK_OPERATION_NOT_ALLOWED | Bank operation is not currently allowed due to the account limitation. |
| RESOURCE_NOT_FOUND_EXCEPTION | RESOURCE_NOT_FOUND_ERROR |
| USER_BUSINESS_EXCEPTION | USER_BUSINESS_ERROR |
| PARTNER_BUSINESS_EXCEPTION | BUSINESS_ERROR |
| SECURITY_CONTEXT_EXCEPTION | SECURITY_CONTEXT_ERROR |
| SECURITY_TENANT_CONTEXT_EXCEPTION | SECURITY_TENANT_CONTEXT_EXCEPTION |
| SECURITY_CONTEXT_PARTNER_ TENANT_NAME_EXCEPTION |
SECURITY_CONTEXT_PARTNER_ TENANT_NAME_EXCEPTION |
| SECURITY_CONTEXT_PARENT_ ACCOUNT_NUMBER_EXCEPTION |
SECURITY_CONTEXT_PARENT_ ACCOUNT_NUMBER_EXCEPTION |
| SECURITY_CONTEXT_TENANT_ID_EXCEPTION | SECURITY_CONTEXT_TENANT_ID_EXCEPTION |
| SECURITY_CONTEXT_SIGNATURE_EXCEPTION | SECURITY_CONTEXT_SIGNATURE_EXCEPTION |
| AUTHORIZATION_EXCEPTION | AUTHORIZATION_ERROR |
| UNKNOWN_EXCEPTION | UNKNOWN_EXCEPTION |
| FORBIDDEN_NO_API_SCOPE | User doesn't have this API in their scope |
| FORBIDDEN_NO_ONBOARDING_SCOPE | Partner doesn't have the onboarding scopes |
| FORBIDDEN_NO_VALID_SCOPE | User doesn't have either this API in their scope or account permissions |
| FORBIDDEN_FLEXIBLE_PAYOUT_PARTNER | Partner is not enabled for flexible payout |
| FAILED_ACC_CREATION_TYPE | Fail to check account creation type |
| FORBIDDEN_NO_ACC_MGG_PERMISSION | Partner account does not have account management permission |
| FORBIDDEN_UNSUPPORTED_ACC_CREATION_TYPE | Partner account has unsupported account creation type |
| INTERNAL_ERROR_UNSUPPORTED_ACC_CREATION_TYPE | Fail to check account creation type |
| ADD_SECONDARY_CURRENCY_INTERNAL_ERROR | Internal Error during add currency call |
| SECONDARY_CURRENCY_INVALID_PAYER | Invalid Payer Id |
| SECONDARY_CURRENCY_INVALID_REQUEST | Invalid Payer Id |
| INVALID_SECONDARY_CURRENCY_CODE | Invalid secondary currency codes |
| SETTLEMENT_ONBOARDING_NOT_SUCCESSFUL | SETTLEMENT_ONBOARDING_NOT_SUCCESSFUL |
| EXISTING_EMAIL_HANDLE | Email address already taken |
| EXISTING_EXTERNAL_ID | External id already associated with another account |
| MISSING_EMAIL_HANDLE | Email id is required |
| MISSING_EMAIL_ADDRESS | Email address is required |
| CONFLICTING_COUNTRY_SETTINGS | Account type does not allow country switch |
| MISSING_BUSINESS_ENTITY_NAME | Missing Business_entity Name |
| MISSING_AGREEMENTS | Missing Agreements |
| MISSING_BUSINESS_TYPE | Missing Business Type |
| INVALID_UPDATE_PATH | The path field for this update object is invalid. |
| INVALID_UPDATE_VALUE | The update value has an invalid field. |
| MISSING_FIELD_UPDATE_VALUE | The update value has a missing required parameter. |
| COUNTRY_CODE_DOC_TYPE_MISMATCH | The country code input provided does not match the associated document type. |
| INVALID_ARRAY_VALUE_UPDATE | The array provided in the value field is invalid. |
| INVALID_ARRAY_VALUE_PATCH | The array provided in the value field is invalid. |
| INVALID_UPDATE_MAX_ELEMENTS_REACHED | The update would cause the array to exceed its maximum allowed size. |
| INVALID_UPDATE_MIN_ELEMENTS_REACHED | The update would cause the array to fall below its minimum allowed size. |
| INVALID_BUSINESS_ATTRIBUTE_NAME_VALUE_PATCH | The name provided in Business Attribute is invalid. |
| ACCOUNT_ID_MISMATCH | Account ID in body does not match account ID in update path |
| INVALID_VIEWS_QUERY_PARAMETER | Query parameter has invalid value. |
| INVALID_TYPE_PROVIDED | Invalid type provided. |
| RETRIEVE_CONFIG_FAILED | Error on retrieving config value |
| INVALID_ENUMERATED_VALUE | Error on enumerated value. |
| AMQ_PUBLISH_FAILED | Publish Operation failed |
| BANK_ASSOCIATION_LIMIT_REACHED | This account has reached its association limit. Please use another bank account. |
| BANK_ACCOUNT_DECLINED | The bank account provided cannot be used. A different bank account must be used. |
| BANK_VALIDATION_ERROR | The bank account information provided is not valid. Please check all the details provided are accurate. |
| PPH_BUNDLE_ID_NOT_FOUND | Failed to fetch PPH bundleId |
| BANK_BAD_INSTRUMENT | The financial instrument has been flagged as risky and cannot be accepted. |
| BANK_MAXED_CONFIRMATION_TRIES | The verification of the bank failed previously. We recommend you to use another bank. |
| BANK_INSTRUMENT_RESTRICTED | The account number or routing number provided cannot be accepted. |
| BANK_REMOVE_DENIED_NEGATIVE_BALANCE | The currently associated bank has unsettled balance and cannot be removed at this time. |
| BANK_DOES_NOT_BELONG_TO_THE_MERCHANT | The FI bank account provided does not belong to merchant. |
| ACCOUNT_LINKING_CROSS_ COUNTRY_USER_VALIDATION_ERROR |
Account linking across countries is not supported. |
| USER_VALIDATION_ERROR | The account creation was not successful due to the limitation in the provided user information. Please review the provided documentation to pass the needed information to create the account. |
| CLOSE_ACCOUNT_FAILED | Close account failed |
| MISSING_HYPERWALLET_API_CREDENTIALS | Hyperwallet credentials setup missing. |
| INVALID_MAPPING_METADATA | Invalid mapping metadata detected. |
| DOMAIN_ALREADY_REGISTERED | The domain is already registered. |
| DOMAIN_NOT_REGISTERED | The domain is not registered. |
| DOMAIN_REGISTRATION_NOT_ALLOWED | Domain registration is not allowed for this account. |
| INVALID_DOMAIN_NAME | The domain name is invalid. |
| INVALID_PROVIDER_TYPE | The provider type is invalid. |
| DOMAIN_REGISTERED_WITH_ANOTHER_ENTITY | The domain is registered with another entity. |
| RHINO_PARSING_EXCEPTION_ERROR | Parsing Exception during JSON Logic processing. |
| AMQ_PUBLISH_ERROR | Fail to publish AMQ message. |
| AMQ_PUBLISH_EXCEPTION | Exception during AMQ message publishing. |
| INVALID_BENEFICAL_OWNER_DECLARATION | Invalid Beneficial Owner Declaration |
| TIMEOUT_EXCEPTION | Timeout Exception |
| INSTRUMENT_ALREADY_ASSOCIATED | Instrument is already associated with another user |
| INSTRUMENT_BLOCKED | Instrument is currently blocked |
| INVALID_ACCOUNT_TYPE | Not a valid business type account |