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.

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.