Business Account Verification

Business Account Verification

POST {{baseurl}}/v2/api/verifications/za/business-account

Headers

Name
Type
Description

token*

String

API secret token

Request Body

Field
Type
Description

registrationNumber*

String

The registration number of the business. (required)

businessPayload*

Object

The payload containing business details. (required)

branchNumber

String

The branch number.

batchNumber

String

The batch number.

enquiryAmount

String

The enquiry amount.

accountVerifications*

Object[]

The list of account verifications. (required)

accountHolder*

String

The account holder's name.

accountNumber*

String

The account number.

accountType*

String

The account type.

branchCode

String

The branch code.

registrationNumber

String

The registration number.

bankCodes*

Object[]

The list of bank codes.

accountHolder

String

The account holder's name.

accountNumber

String

The account number.

bankAbbreviation

String

The bank abbreviation.

branch

String

The branch.

branchCode

String

The branch code.

creditAmount

String

The credit amount.

specialInstructions

String

The special instructions.

termsGiven

String

The terms given.

tradeReferences*

Object[]

The list of trade references.

branch

String

The branch.

contactName

String

The contact name.

telephoneDialingCode

String

The telephone dialing code.

telephoneNumber

String

The telephone number.

tradeName

String

The trade name.

isConsent*

Boolean

Indicates whether consent is given. (required)

Business Account Verification

With this endpoint, you have access to the verification of the client's business account.

{
    "registrationNumber": "201133333323",
    "businessPayload": {
        "branchNumber": "88",
        "batchNumber": "11",
        "enquiryAmount": "5000",
        "accountVerifications": [
            {
                "accountHolder": "ITC DISTRIBUTORS PTY LTD",
                "accountNumber": "050610025211",
                "accountType": "CUR",
                "branchCode": "254905",
                "registrationNumber": "197905643207"
            }
        ],
        "bankCodes": [
            {
                "accountHolder": "",
                "accountNumber": "",
                "bankAbbreviation": "",
                "branch": "",
                "branchCode": "",
                "creditAmount": "",
                "specialInstructions": "",
                "termsGiven": ""
            }
        ],
        "tradeReferences": [
            {
                "branch": "",
                "contactName": "",
                "telephoneDialingCode": "",
                "telephoneNumber": "",
                "tradeName": ""
            }
        ]
    },
    "isConsent": true
}
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "66a7965de3034410d8af076e",
        "status": "found",
        "businessId": "628b38f03ae28a14f52d4bf7",
        "parentId": null,
        "isConsent": true,
        "type": "za_company_account",
        "searchTerm": "201133333323",
        "name": "ITC DISTRIBUTORS (PTY) LTD",
        "registrationNumber": "201133333323",
        "requestedAt": "2024-07-29T13:17:20.029Z",
        "country": null,
        "createdAt": "2024-07-29T13:17:20.303Z",
        "lastModifiedAt": "2024-07-29T13:17:20.303Z",
        "itNumber": null,
        "bankName": null,
        "branchCode": "254905",
        "accountNumber": "050610025211",
        "accountHolder": "ITC DISTRIBUTORS PTY LTD",
        "accountVerification": {
            "verifiedDate": "2024-07-25",
            "accountFound": "Y",
            "idMatch": "N",
            "surnameMatch": "N",
            "accountOpen": "Y",
            "accountDormant": "U",
            "accountOpen3Months": "Y",
            "accountAcceptsDebits": "Y",
            "accountAcceptsCredits": "Y",
            "branchCode": null,
            "errorReason": "Success",
            "verified": "N"
        },
        "websiteEmail": null,
        "branchAddress": null,
        "headOfficeAddress": null,
        "objectives": null,
        "amlReport": null,
        "adverseMediaReport": null,
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "628b38f03ae28a5a122d4bf3"
        }
    },
    "links": []
}
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}

Last updated