Introduction

The verify API call is used to verify South African ID numbers and bank account numbers through CDV checks.

These API calls are provided through SwitchTransact and is included in all packages.

Verify SAID

This API will verify a South African ID number via a CDV check.

Query Parameters:

Valid SAID Response:

{
    "valid": true
}

Invalid SAID Response:

{
    "valid": false
}

Error Response:

{
    "status": false,
    "error": "Not authorized to make this API call. Requesting Read on General."
}

When you get this API response ensure that under the API keys section your API Key has the correct permissions: API Keys

Verify Bank Accounts

This API will verify a South African bank account number via a CDV check.

Query Parameters:

Valid Account Response:

{
    "status": true,
    "message": "CDV check on account is valid",
    "modifiedAccountNumber": "1111111111"
}

Invalid Account Response:

{
    "status": false,
    "message": "CDV check found the account is invalid. CDV check procedure failed.",
    "modifiedAccountNumber": "2222222222"
}

Error Response:

{
    "status": false,
    "error": "Not authorized to make this API call. Requesting Read on General."
}

When you get this API response ensure that under the API keys section your API Key has the correct permissions: API Keys