Life Cycle

When you want to guarantee the owner of a bank account there are a variety of ways to verify. At Devengo, we provide a simple process where you’re able to ensure ownership of it.

Everything starts with a simple POST request.

But before that, it's important to note that all this happens asynchronously. Yep, that means that when you send your POST request, our response only implies that the holder verification has been accepted, and in this response, you will receive the holder verification's ID that you will be able to match seconds later with the notifications you will receive every time your holder verification enters a new state.

States of an holder verification

Created

The initial state of any holder verification is created. Before its creation Devengo checks that all the provided information is syntactically valid (well-formatted IBANs and recipients).
So your holder verification has passed that first filter, congrats! However, the holder verification process has not started yet.

Interestingly, with this event, you will receive the holder verification's ID and the selected holder verification counterparty.

Webhook sent: holder_verification.created.

Processed

Your holder verification has been processed and it’s being evaluated.

Webhook sent: holder_verification.processed.

Rejected

This is the final state for an holder verification whose ownership can't be verified.

Webhook sent: holder_verification.rejected.

Confirmed

This is the successful final state when your holder verification request is confirmed with a match.

Webhook sent: holder_verification.confirmed.

Failed

The holder verification process has failed since there is a no_match response from the counterparty's financial institution. This is a final state.

Webhook sent: holder_verification.failed.