Format of the errors returned by Devengo
All errors returned by the API will follow this format:
{
"error": {
"code": "specific_error_code",
"message": "Human readable description of the raised error",
"title": "Defined title for the error",
"detail": "Human readable detail of the raised error",
"type": "https://errors.devengo.com/specific_error_code",
"backtrace": null
}
}
Important
Fields
codeandmessagewill be deprecated on TBD.
API consumers can check the specific errors that may be potentially raised for a given endpoint in this page or in its reference documentation.
Account Creation Not Available
{
"error": {
"code": "account_creation_not_available",
"message": "Unable to create account. Please contact [email protected]",
"title": "Unable to create account",
"detail": "Unable to create account. Please contact [email protected]",
"type": "https://errors.devengo.com/account_creation_not_available",
"backtrace": null
}
}
Useful information
At this moment, account creation is not available. This could happen for multiple reasons. Contact [email protected] for further information.
Account Destination Not Active
{
"error": {
"code": "account_destination_not_active",
"message": "Destination account not active",
"title": "Destination account not active",
"detail": "Destination account is not active",
"type": "https://errors.devengo.com/account_destination_not_active",
"backtrace": null
}
}
Useful information
Make sure that the movement of money internally is made to an account that has an active status.
Account Holder Invalid Email
{
"error": {
"code": "account_holder_invalid_email",
"message": "[email protected] is an invalid email",
"title": "Account Holder email is invalid",
"detail": "[email protected] is an invalid email",
"type": "https://errors.devengo.com/account_holder_invalid_email",
"backtrace": null
}
}
Useful information
Make sure the provided email is valid.
Account Holder Invalid Status
{
"error": {
"code": "unprocessable_entity",
"message": "Account Holder Devengo SL has not active status. Current status: validating",
"title": "Account Holder status is invalid",
"detail": "Account Holder Devengo SL has not active status. Current status: validating",
"type": "https://errors.devengo.com/account_holder_invalid_status",
"backtrace": null
}
}
Useful information
This is happening because the used account holder is not in an
activestate. This may be because the account holder was created recently and has not yet been validated by our compliance team. You can always inquire about the state of the account holder by contacting our support team at [email protected]
Account Holder Max Active Accounts
{
"error": {
"code": "account_holder_max_active_accounts",
"message": "Maximum active account has been reached.",
"title": "Maximum active account has been reached.",
"detail": "The limit of allowed active accounts has been reached.",
"type": "https://errors.devengo.com/account_holder_max_active_accounts",
"backtrace": null
}
}
Useful information
The limit of active accounts for the account holder has been reached. . Contact [email protected] for further information.
Account Holder Open Accounts Archive Error
{
"error": {
"code": "unprocessable_entity",
"message": "Account Holder can't be archived. It has open accounts.",
"title": "Error when archiving Account Holder",
"detail": "Account Holder can't be archived. It has open accounts.",
"type": "https://errors.devengo.com/account_holder_open_accounts_archive_error",
"backtrace": null
}
}
Useful information
All account owned by an account holder must be closed before it can be archived. Please, refer to the close account endpoint section of documentation.
Account Holder Wrong Status Archive Error
{
"error": {
"code": "unprocessable_entity",
"message": "Account Holder can't be archived. The current status doesn’t allow it.",
"title": "Error when archiving Account Holder",
"detail": "Account Holder can't be archived. The current status doesn’t allow it.",
"type": "https://errors.devengo.com/account_holder_wrong_status_archive_error",
"backtrace": null
}
}
Useful information
Account holder cannot be archived because its current status doesn't allow it. You can always inquire about the state of the account holder by contacting our support team at [email protected]
Account Not Active
{
"error": {
"code": "account_not_active",
"message": "Unable to perform action to not active account with ID: acc_fYpgX5Ytdxzexuf61lFmw",
"title": "Account is not active",
"detail": "Unable to perform action to not active account with ID: acc_fYpgX5Ytdxzexuf61lFmw",
"type": "https://errors.devengo.com/account_not_active",
"backtrace": null
}
}
Useful information
This error happens because the action you are trying to perform requires the provided account to be active. Make sure the account involved is in this state. If it has been deactivated you should contact [email protected].
Account Not Closable
{
"error": {
"code": "account_not_closable",
"message": "Unable to perform action to not closable account with ID: acc_fYpgX5Ytdxzexuf61lFmw",
"title": "Account is not closable",
"detail": "Unable to perform action to not closable account with ID: acc_fYpgX5Ytdxzexuf61lFmw",
"type": "https://errors.devengo.com/account_not_closable",
"backtrace": null
}
}
Useful information
The account is in a state that prevents it from being closed. Please contact our support team at [email protected] if you don't know the reason.
Account Unsupported Currency
{
"error": {
"code": "unsupported_currency",
"message": "Unable to create account for unsupported currency: USD",
"title": "Currency is not supported",
"detail": "Unable to create account for unsupported currency: USD",
"type": "https://errors.devengo.com/account_unsupported_currency",
"backtrace": null
}
}
Useful information
The currency provided to perform the action is not supported. Make sure the currency provided is correct. Contact [email protected] for further information.
Account With Company Blocked
{
"error": {
"code": "account_with_company_blocked",
"message": "Unable to create account. Company usd is blocked",
"title": "Account company is blocked",
"detail": "Unable to create account. Company usd is blocked",
"type": "https://errors.devengo.com/account_with_company_blocked",
"backtrace": null
}
}
Useful information
When a company is blocked, it cannot be used to perform actions such as creating an account. Contact [email protected] for further information.
Account With Payments In Progress
{
"error": {
"code": "account_with_payments_in_progress",
"message": "Account with ID acc_fYpgX5Ytdxzexuf61lFmw with payments in progress",
"title": "Account has payments in progress",
"detail": "Account with ID acc_fYpgX5Ytdxzexuf61lFmw with payments in progress",
"type": "https://errors.devengo.com/account_with_payments_in_progress",
"backtrace": null
}
}
Useful information
When an account has payments in a transient status, it cannot perform be closed. You can learn more about our payments life cycle here.
API Key Signature Invalid
{
"error": {
"code": "api_key_signature_invalid",
"message": "Signature is invalid",
"title": "Signature is invalid",
"detail": "The signature provided does not correspond to the expected one.",
"type": "https://errors.devengo.com/api_key_signature_invalid",
"backtrace": null
}
}
Useful information
You can check how to generate a valid signature in our documentation. If you are having trouble to perform this action, please contact [email protected].
API Rate Limit Reached
{
"error": {
"code": "too_many_requests",
"message": "API limit reached",
"title": "API limit reached",
"detail": "You have reached the established API request limit",
"type": "https://errors.devengo.com/api_rate_limit_reached",
"backtrace": null
}
}
Useful information
Check our documentation on Rate limits for further information.
Authentication
{
"error": {
"code": "authorization",
"message": "Unauthenticated",
"title": "You are not authenticated",
"detail": "You need to log in to perform this action",
"type": "https://errors.devengo.com/authentication",
"backtrace": null
}
}
Useful information
If you are having trouble to perform an action, please contact [email protected].
Balance Not Zero
{
"error": {
"code": "balance_not_zero",
"message": "Unable to reach action close cause balance is positive for account with ID: acc_fYpgX5Ytdxzexuf61lFmw",
"title": "Account balance is positive",
"detail": "Unable to perform action close because balance is positive for account with ID: acc_fYpgX5Ytdxzexuf61lFmw",
"type": "https://errors.devengo.com/balance_not_zero",
"backtrace": null
}
}
Useful information
Please check the identifier used in your request. Learn how to get the list of available events in this section.
Bank Invalid IBAN
{
"error": {
"code": "bank_invalid_iban",
"message": "Invalid IBAN: ES2820958297603648596978. Errors: Errors",
"title": "Bank invalid IBAN",
"detail": "Invalid IBAN: ES2820958297603648596978. Errors: Errors",
"type": "https://errors.devengo.com/bank_invalid_iban",
"backtrace": null
}
}
Useful information
Provided account numbers must have a valid format.
Bank No Valitic Support
{
"error": {
"code": "bank_no_valitic_support",
"message": null,
"title": "Bank has no verifications support",
"detail": "Destination bank does not support verifications",
"type": "https://errors.devengo.com/bank_no_valitic_support",
"backtrace": null
}
}
Useful information
Destination bank does not support verifications.
Conflict
{
"error": {
"code": "conflict",
"message": "Conflict",
"title": "There was a conflict",
"detail": "We encountered a conflict performing this action",
"type": "https://errors.devengo.com/conflict",
"backtrace": null
}
}
Useful information
A conflict occurred while performing an action. If this error persists, please contact [email protected].
Counterparty Account Not Active
{
"error": {
"code": "counterparty_account_not_active",
"message": "Counterparty account is not active",
"title": "Counterparty account not active",
"detail": "Counterparty account is not active",
"type": "https://errors.devengo.com/counterparty_account_not_active",
"backtrace": null
}
}
Useful information
Destination account has been deactivated, please contact [email protected].
Description Too Long
{
"error": {
"code": "description_too_long",
"message": "Description too long.",
"title": "Description too long",
"detail": "Payment description is too long",
"type": "https://errors.devengo.com/description_too_long",
"backtrace": null
}
}
Useful information
The payment description is too long. Please send a description with a maximum of 140 characters for SEPA and 18 for Faster Payments.
Destination Currency Doesnt Match
{
"error": {
"code": "destination_currency_doesnt_match",
"message": "Destination account (acc_fYpgX5Ytdxzexuf61lFmw) currency does not match payment currency USD",
"title": "Destination account currency does not match payment currency",
"detail": "Destination account (acc_fYpgX5Ytdxzexuf61lFmw) currency does not match payment currency USD",
"type": "https://errors.devengo.com/destination_currency_doesnt_match",
"backtrace": null
}
}
Useful information
This error happens when provided currency does not match destination account currency.
Entity Not Found
{
"error": {
"code": "entity_not_found",
"message": "Entity not found with ID pyo_1iX93wFS1R0yF3Ic4WnsDO",
"title": "Entity not found",
"detail": "Entity not found with ID pyo_1iX93wFS1R0yF3Ic4WnsDO",
"type": "https://errors.devengo.com/entity_not_found",
"backtrace": null
}
}
Useful information
The resource that you are trying to get was not found. Please, check the identifier you are using to ensure it's correct.
Event Slug Not Found
{
"error": {
"code": "event_slug_not_found",
"message": "Event slug not found. Slug: example_slug",
"title": "Event slug not found",
"detail": "Event slug not found. Slug: example_slug",
"type": "https://errors.devengo.com/event_slug_not_found",
"backtrace": null
}
}
Useful information
Probably you are using a wrong identifier in your request. Learn how to get the list of available events in this section.
Forbidden
{
"error": {
"code": "forbidden",
"message": "Forbidden",
"title": "This resource is forbidden",
"detail": "You cannot access this resource",
"type": "https://errors.devengo.com/forbidden",
"backtrace": null
}
}
Useful information
If you are having trouble to perform an action, please contact [email protected].
IBAN Verification In Progress
{
"error": {
"code": "iban_verification_in_progress",
"message": "There is a verification with ID: vrf_2KX8KGkSUMr37APZsRb2l2 in progress for this IBAN",
"title": "Verification in progress for this IBAN",
"detail": "There is a verification with ID: vrf_2KX8KGkSUMr37APZsRb2l2 in progress for this IBAN",
"type": "https://errors.devengo.com/iban_verification_in_progress",
"backtrace": null
}
}
Useful information
Make sure the provided IBAN doesn't already have a verification in a transient status. Learn more about verifications statuses in the verifications' life cycle section.
Idempotency Payload Match Error
{
"error": {
"code": "unprocessable_entity",
"message": "Payload match error",
"title": "Payload match error",
"detail": "The response payload is different than expected",
"type": "https://errors.devengo.com/idempotency_payload_match_error",
"backtrace": null
}
}
Useful information
Check our documentation regarding Idempotency for further information.
Invalid Amount
{
"error": {
"code": "invalid_amount",
"message": "Invalid payment amount",
"title": "Invalid payment amount",
"detail": "Payment amount is invalid",
"type": "https://errors.devengo.com/invalid_amount",
"backtrace": null
}
}
Useful information
Provided amount must be valid, for example, make sure to provided amount is greater than zero.
Invalid Cents Format
{
"error": {
"code": "invalid_cents_format",
"message": "Invalid money cents format. Must be an Integer.",
"title": "Invalid money cents format",
"detail": "Invalid money cents format. Must be an Integer.",
"type": "https://errors.devengo.com/invalid_cents_format",
"backtrace": null
}
}
Useful information
Provided amount must have the correct format. The amount must be a whole number.
Invalid Currency
{
"error": {
"code": "invalid_currency",
"message": "Invalid money currency DZD",
"title": "Invalid money currency",
"detail": "Invalid money currency DZD",
"type": "https://errors.devengo.com/invalid_currency",
"backtrace": null
}
}
Useful information
This error happens when provided currency is not recognized by our system. Make sure it is correctly spelled.
Invalid Destination Bank
{
"error": {
"code": "invalid_destination_bank",
"message": "Unable to find a valid destination bank",
"title": "Destination bank is not found",
"detail": "Destination bank is not found for IBAN: ES2914653111661392648933",
"type": "https://errors.devengo.com/invalid_destination_bank",
"backtrace": null
}
}
Useful information
The destination bank could not be found. Please contact our support team at [email protected] to know more about the reason.
Invalid Destination Country
{
"error": {
"code": "invalid_destination_country",
"message": "Destination country code RU is invalid",
"title": "Destination country is invalid",
"detail": "Destination country code RU is invalid",
"type": "https://errors.devengo.com/invalid_destination_country",
"backtrace": null
}
}
Useful information
Make sure that destination bank account country is in Single European Payments Area (SEPA).
Invalid Destination Taxid
{
"error": {
"code": "invalid_destination_taxid",
"message": "The destination tax ID provided is not valid.",
"title": "Tax ID invalid",
"detail": "The destination tax ID provided is not valid.",
"type": "https://errors.devengo.com/invalid_destination_taxid",
"backtrace": null
}
}
Useful information
Provided destination tax ID is not valid.
Invalid IBAN Format
{
"error": {
"code": "invalid_iban_format",
"message": "Invalid format for IBAN ES2820958297603648596978",
"title": "Invalid IBAN format",
"detail": "Invalid format for IBAN ES2820958297603648596978",
"type": "https://errors.devengo.com/invalid_iban_format",
"backtrace": null
}
}
Useful information
Provided account numbers must have a valid format. You can learn more about the structure of an IBAN here.
Invalid Metadata Compliance Birth Date Format
{
"error": {
"code": "invalid_metadata_compliance_structure",
"message": "Invalid format on compliance metadata birth date: dv_compliance_birth_date must follow 'YYYY-MM-DD'.",
"title": "Invalid format on metadata compliance birth date",
"detail": "dv_compliance_birth_date format must follow 'YYYY-MM-DD'.",
"type": "https://errors.devengo.com/invalid_metadata_compliance_birth_date_format",
"backtrace": null
}
}
Useful information
Provided date must have comply with format detailed in error message.
Invalid Query Params
{
"error": {
"code": "invalid_query_params",
"message": "Invalid query params syntax",
"title": "Invalid query params syntax",
"detail": "Query params syntax are invalid",
"type": "https://errors.devengo.com/invalid_query_params",
"backtrace": null
}
}
Useful information
Please make sure the params provided are correct
Invalid SCAN
{
"error": {
"code": "invalid_scan",
"message": "SCAN is invalid: sort_code 00010251 and account_number 040392",
"title": "Invalid SCAN",
"detail": "SCAN is invalid: sort_code 00010251 and account_number 040392",
"type": "https://errors.devengo.com/invalid_scan",
"backtrace": null
}
}
Useful information
Provided values must have a valid format. Sort code must be 6 digits. Account number must be 8 digits.
Ip Not Allowed
{
"error": {
"code": "ip_not_allowed",
"message": "IP not allowed",
"title": "IP is not allowed",
"detail": "Your IP is not allowed to make requests",
"type": "https://errors.devengo.com/ip_not_allowed",
"backtrace": null
}
}
Useful information
You can add your IP to the allowed list using the Control Panel. If you are having trouble to perform an action, please contact [email protected].
Manager Not Found
{
"error": {
"code": "manager_not_found",
"message": "Manager not found",
"title": "Manager not found",
"detail": "Manager was not found",
"type": "https://errors.devengo.com/manager_not_found",
"backtrace": null
}
}
Useful information
This happens when provided member data does not exist in our system. Make sure you are providing the right data in your request.
Metadata Key Size Limit
{
"error": {
"code": "invalid_metadata_param",
"message": "The metadata key 'Key Name' exceeds the limit: 64 bytes.",
"title": "A metadata key exceeds the size limit",
"detail": "The metadata key 'Key Name' exceeds the limit: 64 bytes.",
"type": "https://errors.devengo.com/metadata_key_size_limit",
"backtrace": null
}
}
Useful information
Metadata keys have a size limit of 64 characters. Learn more about metadata limitations here.
Metadata Keys Number Limit
{
"error": {
"code": "invalid_metadata_param",
"message": "The number of metadata keys exceeds the limit: 64",
"title": "The number of metadata keys exceeds the limit",
"detail": "The number of metadata keys exceeds the limit: 64",
"type": "https://errors.devengo.com/metadata_keys_number_limit",
"backtrace": null
}
}
Useful information
Keys number have a limit of 64. Learn more about metadata limitations here.
Metadata Value Size Limit
{
"error": {
"code": "invalid_metadata_param",
"message": "The metadata key 'Key Name' value exceeds the limit: 512 bytes.",
"title": "A metadata key value exceeds the size limit",
"detail": "The metadata key 'Key Name' value exceeds the limit: 512 bytes.",
"type": "https://errors.devengo.com/metadata_value_size_limit",
"backtrace": null
}
}
Useful information
Metadata value have a size limit of 512 characters. Learn more about metadata limitations here.
Not Available Balance
{
"error": {
"code": "not_available_balance",
"message": "Not available balance",
"title": "Not enough available balance",
"detail": "Available balance is not enough",
"type": "https://errors.devengo.com/not_available_balance",
"backtrace": null
}
}
Useful information
The available balance is less than the requested amount. Please, add necessary funds to the account to perform the requested operation.
Parameter Missing
{
"error": {
"code": "parameter_missing",
"message": "Missing required param: parameter_missing_name",
"title": "A required parameter was not provided",
"detail": "The following parameter is missing: parameter_missing_name",
"type": "https://errors.devengo.com/parameter_missing",
"backtrace": null
}
}
Useful information
Operation was attempted to be performed without all the necessary data. Add the needed parameter to your request and repeat the operation.
Parameters Missing
{
"error": {
"code": "parameters_missing",
"message": "Parameters missing: field_missing, other_field_missing",
"title": "Required parameters were not provided",
"detail": "Parameters missing: field_missing, other_field_missing",
"type": "https://errors.devengo.com/parameters_missing",
"backtrace": null
}
}
Useful information
Operation was attempted to be performed without all the necessary data. Add the needed parameters to your request and repeat the operation.
Payment To Origin Account
{
"error": {
"code": "payment_to_origin_account",
"message": "Payments to the origin account are not allowed",
"title": "Payment to origin account",
"detail": "Payments to the origin account are not allowed",
"type": "https://errors.devengo.com/payment_to_origin_account",
"backtrace": null
}
}
Useful information
The destination account must be different to the origin account.
Pending Manager Error
{
"error": {
"code": "pending_manager_error",
"message": "Unauthorized action",
"title": "You are not authorized to perform this action",
"detail": "You have not the necessary permissions to perform this action",
"type": "https://errors.devengo.com/pending_manager_error",
"backtrace": null
}
}
Useful information
Finish member activation process and try to perform this action again. If you are having trouble with this, please contact [email protected]
Product Not Active
{
"error": {
"code": "forbidden",
"message": "Verifications product is not active for Devengo SL company",
"title": "The product is not active",
"detail": "Verifications product is not active for Devengo SL company",
"type": "https://errors.devengo.com/product_not_active",
"backtrace": null
}
}
Useful information
This product is not available for your account. If it should be available, please contact [email protected].
Unable Process Record
{
"error": {
"code": "unable_process_record",
"message": "Unable to process record with ID: pyo_4JgnTOvdXQWn81NK1bOhIY",
"title": "Unable to process record",
"detail": "Unable to process record with ID: pyo_4JgnTOvdXQWn81NK1bOhIY",
"type": "https://errors.devengo.com/unable_process_record",
"backtrace": null
}
}
Useful information
This error occurs when the ID of the resource that wants to perform the action is malformed. Make sure the ID is correct.
Unexpected Internal Error
{
"error": {
"code": "unexpected_internal_error",
"message": "An unexpected error has occurred. Please contact [email protected] for further information",
"title": "An unexpected error has occurred",
"detail": "Please contact [email protected] for further information",
"type": "https://errors.devengo.com/unexpected_internal_error",
"backtrace": null
}
}
Useful information
Contact [email protected] for further information.
Unsupported Currency
{
"error": {
"code": "unsupported_currency",
"message": "Account acc_fYpgX5Ytdxzexuf61lFmw does not support USD payments",
"title": "Currency is not supported",
"detail": "Account acc_fYpgX5Ytdxzexuf61lFmw does not support USD payments",
"type": "https://errors.devengo.com/unsupported_currency",
"backtrace": null
}
}
Useful information
This error happens when provided currency does not match account supported currency.
Verification Invalid Code
{
"error": {
"code": "unprocessable_entity",
"message": "Verification code is not valid",
"title": "Verification code invalid",
"detail": "Verification code is not valid",
"type": "https://errors.devengo.com/verification_invalid_code",
"backtrace": null
}
}
Useful information
Check the code you are entering in your request is correct.
Verification Max Attempts Reached
{
"error": {
"code": "unprocessable_entity",
"message": "Maximum attempts reached",
"title": "Maximum attempts reached",
"detail": "The maximum number of attempts has been reached",
"type": "https://errors.devengo.com/verification_max_attempts_reached",
"backtrace": null
}
}
Useful information
Verifications can only be attempted 5 times. If you have exhausted this limit, you should create a new verification to continue.
Verification Not Created
{
"error": {
"code": "verification_not_created",
"message": "Unable to create verification. Please contact [email protected]",
"title": "Unable to create verification",
"detail": "Unable to create verification. Please contact [email protected]",
"type": "https://errors.devengo.com/verification_not_created",
"backtrace": null
}
}
Useful information
This error happens when a verification cannot be created because of a problem with the payment sending. Contact [email protected] for further information.
Verification Not Delivered
{
"error": {
"code": "unprocessable_entity",
"message": "Verification cannot be confirmed because it has not been delivered. Status: created. Verification ID: vrf_6gwS6FHtPRcahLBSlsG7TW",
"title": "Verification has not been delivered",
"detail": "Verification cannot be confirmed because it has not been delivered. Status: created. Verification ID: vrf_6gwS6FHtPRcahLBSlsG7TW",
"type": "https://errors.devengo.com/verification_not_delivered",
"backtrace": null
}
}
Useful information
For the verification to be confirmed it is necessary that the code has reached the account holder. In some occasions this can take time, the verification ETA field can help you know approximately when the code will be delivered.
Verification Status Expired
{
"error": {
"code": "unprocessable_entity",
"message": "Verification with ID vrf_6gwS6FHtPRcahLBSlsG7TW is expired. Current status: expired",
"title": "Verification status is expired",
"detail": "Verification with ID vrf_6gwS6FHtPRcahLBSlsG7TW is expired",
"type": "https://errors.devengo.com/verification_status_expired",
"backtrace": null
}
}
Useful information
Verifications expire after 7 days. You should create a new verification to continue.
Verification Status Not Delivered
{
"error": {
"code": "unprocessable_entity",
"message": "Verification with ID vrf_6gwS6FHtPRcahLBSlsG7TW is not in delivered status. Current status: created",
"title": "Verification status not delivered",
"detail": "Verification with ID vrf_6gwS6FHtPRcahLBSlsG7TW is not in delivered status. Current status: created",
"type": "https://errors.devengo.com/verification_status_not_delivered",
"backtrace": null
}
}
Useful information
For the verification to be confirmed it is necessary that the code has reached the account holder. In some ocassions this can take time. Try to perform this operation again after some minutes.
Webhook Not Valid
{
"error": {
"code": "webhook_not_valid",
"message": "Webhook is not valid. Errors",
"title": "Webhook is not valid",
"detail": "Webhook is not valid. Errors",
"type": "https://errors.devengo.com/webhook_not_valid",
"backtrace": null
}
}
Useful information
Webhook creation must comply with requirements detailed in error message.