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.

Business Account Verification Sample Request

{
    "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
}

Found Response

{
    "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": []
}

Error Response

{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}