The TransUnion TLOxp connector lets you verify a user's identity information in your PingOne DaVinci flow by checking TransUnion's trusted data sources.
After you have collected a user's personally identifying information, such as their name and date of birth, you can use the connector to:
- Match a user's personal information against TransUnion's records
- TransUnion searches for a person that matches the provided information then provides a report token, an overall match score, and individual match scores for each attribute that was provided. You can adjust your search scope to return a single person, allow multiple results, or allow TransUnion to expand the search parameters if it doesn't find a result right away.
- Get additional information about a person
- With the token provided from a information match report, you can search TransUnion for more information associated with the same person.
Setup
Resources
For information and setup help, see the following:
- DaVinci documentation:
Requirements
To use the connector, you'll need TransUnion TLO API credentials. For help getting credentials, speak to a TransUnion representative.
Setting up TransUnion TLOxp
You must contact TransUnion support to get DaVinci and PingOne IP addresses added to the allow list for your TransUnion tenant.
For lists of IP addresses, see:
Configuring the TransUnion TLOxp connector
Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.
Connector configuration
For help with these settings, speak to a TransUnion representative.
API URL
Username
Password
DPPA Purpose Code
GLB Purpose Code
The DPPA and GLBA codes are legal declarations required to safeguard the proper use of personal information. The codes you provide must correspond to allowable codes for your industry. To determine which codes are allowed for your industry, go to https://tloxp.tlo.com/account.php?action=api and sign on with your TLOxp API credentials. For help, speak to a TransUnion representative.
The example flows below use the following TransUnion TLOxp demo API settings:
- API URL: https://demoapi.tlo.com/TLOWebService.asmx
- DPPA Purpose Code: 1
- GBL Purpose Code: 1
Ask a TransUnion representative for a username and password to access the demo API.
Testing the connector
To test the connector, use the Echo Test capability and output the result in an HTML message.
- In your flow, add the TransUnion TLOxp connector and select the Echo Test capability. Select the node that appears in your flow.
- Following your Echo Test node, add an HTTP node and select the Custom HTML Message capability. Select the node that appears in your flow.
- In the Message field, click {} and select the rawResponse object from your Echo Test node by clicking (+).
- Click Apply. Save, deploy, and run your flow.
- If you receive an error, check the log for the Echo Test node. For help, see Viewing flow analytics.
Using the connector in a flow
To see these use cases in a flow, search for TransUnion TLOxp in the Flow Library.
Build these two use cases in the order presented to create a single flow.
If you want to follow them exactly as described, use the TransUnion demo API information mentioned in the Connector configuration section.
Looking up a person with TransUnion VerifyPlus
This flow collects user information with an HTML form, uses the connector to send it to TransUnion, then shows the results on an HTML page.
- Download the TransUnion TLOxp - VerifyPlus identity lookup flow template. For help, see Using DaVinci flow templates.
- (Optional) Customize the verification form:
- Select the Sign On Form node.
- In the HTML Template field, customize the page that users see when signing on. Click Apply.
- (Optional) Customize how the connector sends user information to TransUnion:
- Select the Verify Plus node.
- (Optional) Turn on Find Best Match if you want TransUnion to apply additional checks and possibly additional searches in an attempt to match the results against the search criteria. For details, speak to a TransUnion representative.
- (Optional) Turn off Do Not Modify Search if you want TransUnion to expand the search parameters in cases where no match was found.
- Click Apply.
- Test the flow:
- Click Save, Deploy, then Run.
- Enter the following test information:
- Social Security Number (SSN): 903-25-8349
- First Name: Xavier
- Last Name: Clark
- Click Check my information.
- On the Your results page, we can see that TransUnion found one matching record with a total score of 50.
You can use the Function connector to check these variables to make branching decisions. For example:
- When the
errorCode
attribute is anything other than0
, bypass the verification process. - When the
totalScore
attribute is below 50, show an error.
For a complete list of attributes you can work with in your flow, see the capability's output schema (
).Getting more information about a person
This flow takes the result of a VerifyPlus lookup and requests additional information about the person.
- Download the TransUnion TLOxp - Additional personal information flow template. For help, see Using DaVinci flow templates.
- (Optional) Customize the verification form:
- Select the Sign On Form node.
- In the HTML Template field, customize the page that users see when signing on. Click Apply.
- (Optional) Customize how the connector sends user information to TransUnion:
- Select the Verify Plus node.
- (Optional) Turn on Find Best Match if you want TransUnion to apply additional checks and possibly additional searches in an attempt to match the results against the search criteria. For details, speak to a TransUnion representative.
- (Optional) Turn off Do Not Modify Search if you want TransUnion to expand the search parameters in cases where no match was found.
- Click Apply.
- Test the flow:
- Click Save, Deploy, then Run.
- Complete the Verification Form:
- Enter the following test information:
- Social Security Number (SSN): 903-25-8349
- First Name: Xavier
- Last Name: Clark
- Click Check my information.
- Enter the following test information:
- On the Your results page, click Get more information.
- Review the information that TransUnion matched for Xavier Clark. It provides his various email addresses, names, phone numbers, and so on.
How you process this information will vary depending on your organization's needs. When you build your flow, follow your Person Search with Report Token node with a Function connector to branch your flow based on the results from TransUnion.
Capabilities
- Echo Test
-
Test whether your credentials can reach the API
Properties - Verify Plus
-
Verify your identity with TransUnion's Verify Plus endpoint.
Properties - Person Search with Report Token
-
Search for a person in TransUnion with a report token.
Properties