☑️Return DT Account Verification

Verify the information provided for the Customer's bank account details which are stored in the accountVerificationId against the available from Direct Transact.

To perform this verification, you need to have POPI consent. You should collect this consent when creating the Customer or Business and ensure you have set the "popi" field as true inCreate New Customer or Create a Business without a Customer.

DT Account Verification

POST {{baseUrl}}/account-verifications/:account_verification_id/verify-accoun

Request Body

Name	Type
account_verification_id*	String	This is the UUID for an Account Verification that is generated and returned in the POST Create New Customer Account or POST Create New Business Account response.

Status Codes

Please note that particular fields in this response such as idNumberMatch, initialsMatch, surnameOrCompanyNameMatch, emailAddressMatch and cellPhoneNumberMatch will be verified against the data stored on the customerId or businessId

200: OK Successful

{
    "id": "5d458027-4aa8-4ce2-9f0f-246b7f41970d",
    "account_holder": "Mr John Smith",
    "bank": "fnb",
    "account_number": "XXX96664XXX",
    "account_type": "current",
    "branch_code": "250655",
    "data": {
        "avs": {
            "response_avs": {
                "accountFound": "Y",
                "accountOpen": "Y",
                "accountType": "Y",
                "idNumberMatch": "Y",
                "initialsMatch": "Y",
                "surnameOrCompanyNameMatch": "Y",
                "accountAcceptsDebits": "Y",
                "accountAcceptsCredits": "Y",
                "accountLength": "Y",
                "emailAddressMatch": "N",
                "cellPhoneNumberMatch": "Y"
            }
        }
    }
}

422: Unprocessable Entity

Invalid Account Type

{
    "errors": {
        "code": "direct_transact_error_verifying_account",
        "message": "Invalid Account Type. Please Update Account and provide a valid Account Type."
    }
}

POPI Consent Required

{
    "errors": {
        "code": "direct_transact_error_verifying_account",
        "message": "You need to collect POPI consent for this Customer before trying to process an Account Verification. Please update the Customer details."
    }
}