All our Corporate Verification services share a common request and response structure as detailed below.
|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.|
|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.|
|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 17 days ago