Redirect URI – Web

If you wish to use a simple Finicity Connect URL to access the Finicity Connect experience, the following is how you would implement that experience.  Once your user has completed the Finicity Connect flow, the report data will be returned to you via the specified redirectUri.

The simplest implementation is to redirect your users to the redirectURI specified in the body of the Generate Finicity Connect Link API call.  The report data will be returned to the same redirectURI specified in the Generate Finicity Connect Link API call.  This flow is a very simple implementation from a partner perspective.  It allows the user to enter FI credentials and permission accounts directly with the Finicity hosted Connect while not having contact with the partner website for the credentials.  The partner will still get the account data needed, just with less liability as the credentials are passed via a Finicity hosted site.

The redirectUri parameter should not be used if you are embedding Connect in an iframe as it will cause undesired behavior.

Example Implementation

For example, if you specified a redirect uri of https://acme-lending.com/redirectHandler (example below):

Example Redirect URI Request
 {
"partnerId": "{{PARTNER_ID}}",
"customerId": "{{CUSTOMER_ID}}",
"consumerId": "{{CONSUMER_ID}}",
"redirectUri": "https://acme-lending.com/redirectHandler",
"type": "voa",
"webhook": "{{WEBHOOK}}",
"webhookContentType": "application/json"
}

Then the full redirectUri:, after the Connect flow is finished, would look something like this:

https://acme-lending.com/redirectHandler/?success=true&reasonCode=OK&id=quu1svkssc89&portfolioId=90w9y4t1eq5f-port&requestId=jhrsmfrkgf&consumerId=8c58c61c257e3e257a1d19d4d06f5e0b&consumerSsn=6789&type=voa&status=inProgress&source=Finicity%2520Connect&reportId=quu1svkssc89

And, your server would need to specify an endpoint similar to the following:

Example Server Code
 //Ensure you're handling http requests with the GET method
router.get("https://acme-lending.com/redirectHandler""", function(request, response){
//Get data from the query parameters
const { reportId, consumerId, customerId } = request.query;

//TODO: Fetch the report here

//Note: The report probably will not be ready immediately, so you will need to poll.
response.render('
<div>Report successfully generated!</div>
');
});