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 |
Updated 6 months ago