🎭Validate Bank Account Owner

Validate the Bank Account Owner against the Customer Record

Please note that we will perform the validation on the Bank Account Owner against the customer details provided in the POST Create New Customer endpoint.

Validate Bank Account Owner

POST {{baseUrl}}/bank-accounts/:bank_account_id/verify-statement

Run this request to validate the Bank Account Owner against the information stored for the customer initially creates.

Path Parameters

Name	Type	Description
bank_account_id*	String	The UUID for a Bank Account that gets generated and returned in the POST Create new Bank Account response.

Request Body

Name	Type	Description
statement*	form-data	Select the file you would like to upload. The file needs to be a valid bank PDF statement that the customer has downloaded from their internet banking. See here for more information on the types of statements that can be uploaded. There is a maximum of 1 bank statement that can be uploaded.

200: OK Successful validation

```postman_json
{
    "data": {
        "id": "{{BankAccountId}}",
        "customer_id": "{{customerId}}",
        "tenant_customer_reference": "temp",
        "session_id": "temp",
        "type": "statement",
        "bank": "fnb",
        "account_holder": "MR JOHN L DOE",
        "account_verification": {
            "status": "full_validation",
            "reason": {
                "first_initial": true,
                "second_initial": true,
                "gender": true,
                "surname": true
            }
        }

200: OK Partial validation

```postman_json
{
    "data": {
        "id": "{{bankAccountId}}",
        "customer_id": "{{customerId}}",
        "tenant_customer_reference": "temp",
        "session_id": "temp",
        "type": "statement",
        "bank": "fnb",
        "account_holder": "John Doe",
        "account_verification": {
            "status": "partial_validation",
            "reason": {
                "first_initial": true,
                "second_initial": false,
                "gender": false,
                "surname": true
            }
        }
    }
}
```

200: OK Failed validation

```postman_json
{
    "data": {
        "id": "{{bankAccountId}}",
        "customer_id": "{{customerId}}",
        "tenant_customer_reference": "temp",
        "session_id": "temp",
        "type": "statement",
        "bank": "fnb",
        "account_holder": "Miss Kirsten Jessica Hancock",
        "account_verification": {
            "status": "failed_validation",
            "reason": {
                "first_initial": false,
                "second_initial": false,
                "gender": false,
                "surname": false
            }
        }
    }
}
```

404: Not Found Missing / Invalid BankAccountId

```postman_json
{
    "errors": {
        "code": "entity_not_found",
        "message": "Record not found in module_bank_accounts"
    }
}
```

Customer Record

        "first_name": "Kirsten",
        "middle_name": "Jessica",
        "last_name": "Hancock",
        "full_name": "Kirsten Jessica Hancock",
        "initials":"K"

Customer Bank Statement

Bank Statement - Account Holder Details

Bank Account Owner Validation Response

{
    "data": {
        "id": "{{bankAccountId}}",
        "customer_id": "{{customerId}}",
        "type": "statement",
        "bank": "fnb",
        "account_holder": "MISS KIRSTEN J HANCOCK",
        "account_verification": {
            "status": "full_validation",
            "reason": {
                "first_initial": true,
                "gender": true,
                "surname": true
            }
        }
    }
}

Validation Fields	Validation Description
first_initial	The first_initial identified on the bank statement will be compared against the surname created in POST Create New Customer. K - K: true K - D: false
gender	The gender will be identified based on the pre-fix found on the bank statement provided. Miss: true Mr: true Null: false
surname	The surname identified on the bank statement will be compared against the surname created in POST Create New Customer. Hancock - Hancock: true Hancock - Doe: false