Page Redirects

The Verified platform gives you the ability to implement a redirect strategy for some of your transaction workflows. Instead of relying on IFrames or web components, you can simply redirect the user to a new page with the corresponding URL parameters.

By updating the template for that transaction type, you can then control where a user is redirected to based on their acceptance or rejection of a transaction.

caution

Currently, this information only applies for verification transactions. There are planned updates to include customization of selfie and proof transactions.

Updating Template for Redirects

Using the information from the response body when customizing transactions, you can view a resource directly by calling the GetCustomOperationResource API endpoint using the ExternalId from the operation and resource objects respectively.

Example response body:

{
  "Content": "{\r\n\r\n\t\"main\": {\r\n\t\t\"titlecolor\"  : \"#FFFFFF\",\r\n\t\t\"titlebgcolor\": \"\",\r\n\t\t\"bordercolor\" : \"\",\r\n\t\t\"title\": \"VERIFICATION TRANSACTION TITLE\",\r\n\t\t\"approve\": 0,\r\n\t\t\"message\": \"Custom transaction message\",\r\n\t\t\"info1\": \"Info line 1\",\r\n\t\t\"info2\": \"Info line 2\"\r\n\t},\r\n\r\n\t\"accept\": {\r\n\t\t\"title\": \"VERIFICATION AUTHORIZED\",\r\n\t\t\"custom_html\": \"\",\r\n\t\t\"target_url\": {\r\n\t\t\t\"web\": \"https://authid.ai\",\r\n\t\t\t\"ios\": \"\",\r\n\t\t\t\"android\": \"\"\r\n\t\t}\r\n\t},\r\n\r\n\t\"reject\": {\r\n\t\t\"title\": \"VERIFICATION DECLINED\",\r\n\t\t\"custom_html\": \"\",\r\n\t\t\"target_url\": {\r\n\t\t\t\"web\": \"https://authid.ai\",\r\n\t\t\t\"ios\": \"\",\r\n\t\t\t\"android\": \"\"\r\n\t\t}\r\n\t}\r\n\r\n}",
  "CreatedDate": "2022-03-23T16:53:55.14",
  "DeletedDate": null,
  "ExternalId": "157a0a57-898a-4eae-b05d-0cdf9e00b6f0",
  "Locale": "default",
  "Name": "ExecForm",
  "Version": 5
}

The content field is what controls the redirects, and will be returned as raw JSON. Below is a formatted example:

{
	"main": {
		"titlecolor"  : "#FFFFFF",
		"titlebgcolor": "",
		"bordercolor" : "",
		"title": "VERIFICATION TRANSACTION TITLE",
		"approve": 0,
		"message": "Custom transaction message",
		"info1": "Info line 1",
		"info2": "Info line 2"
	},
	"accept": {
		"title": "VERIFICATION AUTHORIZED",
		"custom_html": "",
		"target_url": {
			"web": "https://authid.ai",
			"ios": "",
			"android": ""
		}
	},
	"reject": {
		"title": "VERIFICATION DECLINED",
		"custom_html": "",
		"target_url": {
			"web": "https://authid.ai",
			"ios": "",
			"android": ""
		}
	}
}

This template allows you to control where the user will be redirected to once they have accepted or rejected the transaction. Additionally, there are options for iOS and Android devices to assist with deeplinking to installed apps.

To update the redirect URLs, you can call the UpdateCustomOperationResource API endpoint to update the Content field of the resource with your custom URLs to redirect the user.

Example request body:

{
  "Content": "{\"your\": \"custom content\"}",
  "CreatedDate": "2022-03-23T16:53:55.14",
  "DeletedDate": null,
  "ExternalId": "157a0a57-898a-4eae-b05d-0cdf9e00b6f0",
  "Locale": "default",
  "Name": "ExecForm",
  "Version": 5
}