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

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.
branchoptional	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	Indicate subject has given consent. Must be true

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
} 

Business Account Verification Sample 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": []
}SA