Corporate Verification Services Structure📈
All our Corporate Verification services share a common request and response structure as detailed below.
Request Structure
Request Attribute | Format | Status | Description |
---|---|---|---|
searchParameter | String | Mandatory | The Corporate Verification number you wish to validate would be passed in this field. It could be TIN or CAC verification depending on the identity service you're calling. |
transactionReference | String | Optional | |
companyName | String | Mandatory | The name of the company being validated. |
verificationType | String | Always Mandatory | Every service has its specific verification type. Ensure to pass in the right verification type for the right service. You may view a list of verification types here. |
Response Structure
Response Attribute | Format | Description |
---|---|---|
responseCode | String | '00' indicates success. Full list of response codes can be found here |
description | String | If the transaction failed or an error was encountered, details of the error can be found in the description. |
verificationType | String | The verificationType passed in the request is returned here. |
verificationStatus | String | This field lets you know if the rc verification was successful. Options are: VERIFIED: This means that the RC-VERIFICATION is valid. NOT VERIFIED This means that the RC-VERIFICATION is invalid PENDING This status means that the verification could not be completed. Refer to the responseCode for the specific failure reason. |
transactionStatus | String | This indicates the wallet debit status. The options are successful or failed. |
TransactionReference | String | If you supplied a transactionReference, the same will be returned here. Else, we would generate a reference and return that to you in this field. |
transactionDate | String | Date the transaction was done |
searchParameter | String | The Corporate Verification number that was verified |
response | Json | This contains the actual verification data as retrieved from the identity provider. The format of the data varies depending on the service called. |
Updated about 1 year ago