Face Capture + Face Match🤳🏻

Overview

The link generation process enables the user to create a personalized link which is used for face capture. It can be generated when some headers and request payloads are passed through our API. The documentation is a guide to show you how to integrate and generate links successfully.

🚧
Important!
Before you proceed, ensure you review the prerequisites for integrating into our APIs for a more detailed guide.

API EndPoint

<https://api.verified.africa/sfx-verify/v3/sdk/generate-api-verification-link>

Headers

Our service accepts headers for authentication. See below the headers to pass to the API

Header	Type	Description
userid	String	This is your user id retrieved from the portal. Check the getting started article to understand how to retrieve your userid
publicKey	String	This is your publickey retrieved from the portal. Check the getting started article to understand how to retrieve your publicKey

Request Parameters

Parameter	Required	Description	Test Data
tokenId	yes	The tokenId gotten from the portal will be passed into this field	VF-1111111111111
authenticationToken	yes	The authenticationToken gotten from the portal will be passed into this field	8299c793606e51e5f49922fa6e9b04f01ab7cf1b45d29ff75294dbcb8ccc5af17cf6ff123fe4f4082d91ddb64c2d9695c259eaf69a334e3e4e5c71e884c62370681b63a9e9de3fa3b3326d5b0c8f4a1c
linkIdentifier	yes	This is a field that uniquely identifies your transaction. We generate this field if you leave it empty; however, we encourage you to generate it for proper reconciliation	String
callbackUrl	yes	The callbackUrl is the webhook where captured image and the background cleanup image will be sent to after a successful capture	<https://webhook.site/5632cc57-c2cf-4aa6-853f-9c5fc9c9068b>
redirectUrl	yes	The redirectUrl is a link where the user will be redirected at the end of a successful capture	<https://verified.africa>
sourceImage	yes	This is the primary image that would be matched against the captured/target image during verification.	Base64 Image
personalizationDetail	yes	The identity of the person to be verified will be passed into this field	Kelechi Mary

{
 "tokenId": "VF-1111111111111",
  "authenticationToken": "8299c793606e51e5f49922fa6e9b04f01ab7cf1b45d29ff75294dbcb8ccc5af17cf6ff123fe4f4082d91ddb64c2d9695c259eaf69a334e3e4e5c71e884c62370681b63a9e9de3fa3b3326d5b0c8f4a1c",
   "callbackUrl": "https://webhook.site/758260e2-8e2d-4ff3-9866-f8860500f621",
   "sourceImage": "/9j/4AAQSkZJRgABAQEA",
   "redirectUrl" : "https://verified.africa",
   "personalizationDetail": "Kelechi mARY",
   "linkIdentifier": "goeism"
}

Parameter	Type	Description
status	String	This is a status of the response received.
responseCode	String	Please reference Response Codes page for details on all possible responses
description	String	This is a description of the response received.
generatedLink	String	This is the link generated to continue with the faceCapture
verificaionFlowId	String	This is the unique Id of your verification flow
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.
userDetails	String	This is the details of the user performing the request

{
    "status": "success",
    "responseCode": "00",
    "description": "Links generated successfully",
    "generatedLink": "https://portal.verified.africa/#/consumer?token=1606f39af2ca50580bbea97cd8c5b2361fad1674ac1eddc86eacc704dd9c714411c27eca2fa605b52c3c6ef2d995a17616a35d78c5c531c3c10a4c5180d0a9dc6ba46151cfa1f7fbac034689c2326a57",
    "verificationFlowId": "VF-1680278122794",
    "transactionReference": "223344556677"
}

Error Responses

Status Code

Description
400	Bad Request - Invalid input parameters
401	Unauthorized - Invalid API Key
500	Internal Server Error - Something went wrong on the server side