Errors

Type of errors

There are two types of errors when making account holder verifications with Devengo:

errors before the account holder verification has been processed
errors occurred during the account holder verification process by the provider

The first group includes errors generated by Devengo for different reasons, from validation errors to technical problems. In contrast, the second group contains errors returned by the provider once the verifications has been sent for processing. This second group includes bank communication problems, destination account problems, etc.

Errors before the verification has been processed

Most of these errors will be returned immediately in the body of the response when you try to create an account holder verification. You will receive a 4XX response with a detailed explanation of the error in its body. It's important to note that the verification has not been created in this case.

{
  "error": {
    "message": "The destination bank is not a participant in this service.",
    "code": "AHV-0002",
    "type": "bank_unsupported"
  }
}

There are other potential errors in our validation phase or due to technical problems in our systems. Since it happens in the background, you will receive them as webhook notifications.

Errors during verification processing

As we said before, those account holder verifications has been executed. You will have access to the original error code from the banking network.

Error code	Error type	Error message
AHV-0001	missing_attribute	A required attribute is missing.
AHV-0002	bank_not_member	The destination bank is not a participant in this service.
AHV-0003	bank_unavailable	The destination bank is temporarily unavailable for this service.
AHV-0004	unsupported_attribute	An attribute is not supported for this service.
AHV-0005	services_not_configured	Your account is not configured to use this services. Contact support.
AHV-0006	verification_check_not_possible	The verification check is not possible.
AHV-0007	invalid_account_number	The provided account number is invalid.
AHV-9999	unexpected_error	Unexpected error. Contact support.

Since our processing of verifications is always in the background, you will receive those errors in the tag error of our webhooks or whenever you ask for the details of an account holder verification that has been rejected previously.

You can find in our API documentation a list of IBANs that you can use to force some of these errors in our sandbox.