CDV Message Flow
The diagram below shows the CDV message flow, which is a synchronous flow.
- You send Electrum a
validateIdentifierUsingCheckDigit
message (CheckDigitVerficationRequest
schema) containing the bank account number to be verified, and the bank branch.
CheckDigitVerificationRequest Schema
The name of the verification scheme to be used to verify the provided data.
Identifies this account identifier as generic, always GENERIC
Identifies the scheme that defines the identification of a generic account.
The entity that assigns the identification
Unique and unambiguous identification of a branch of a financial institution.
The name by which this branch is known and is usually used to identify the branch.
- Once the verification has been done, Electrum sends you a
CheckDigitVerficationReport
containing the outcome of the verification. The outcome field will be populated withPASSED
,FAILED
, orSKIPPED
(if the verification was not done for some reason).
CheckDigitVerificationReport Schema
Indicates whether the check digit verification was successful or not.
PASSED
: The provided data passed verification.
FAILED
: The provided data failed verification.
SKIPPED
: No verification was performed.
Provides detailed information on a verification reason.
Error Handling
Error at Electrum
If there is a system or other error at Electrum after you have sent a CheckDigitVerificationRequest
, then Electrum will respond with an ErrorDetail
message describing the failure. No further messaging is required and the channel may retry the transaction.
Timeout at Bank
If you do not receive a CheckDigitVerificationReport
from Electrum after a specified period then your system will time out. No further messaging is required. The channel may retry the transaction.
Error at Bank
If an error is encountered on your system, then you may notify the channel of the error. No further messaging is required. The client may retry the transaction.