Validating the end user's email

You need a logged in User to use this functionality.

All of Bridge's end users need to register a valid email address with Bridge.

Email validation is done within the Connect funnel, which is completely hosted as a web application by Bridge.

First, you need to check whether the User still needs to validate an email by calling the following endpoint:

curl "https://sync.bankin.com/v2/users/me/email/confirmation?client_id=<my_client_id>&client_secret=<my_client_secret>" \
     -H 'Bankin-Version: 2018-06-15' \
     -H 'Authorization: Bearer <returned_access_token>'

{
  "name": "email",
  "is_confirmed": false
}

If !is_confirmed, then the User needs to validate an email.

The following endpoint returns the appropriate URL to the funnel, with a token identifying your App and the User:

## Get user email confirmation url
curl "https://sync.bankin.com/v2/connect/users/email/confirmation/url?client_id=<my_client_id>&client_secret=<my_client_secret>" \
     -H 'Authorization: Bearer <returned_access_token>' \
     -H 'Bankin-Version: 2018-06-15'

The response should return the URL to the funnel:

{
  "redirect_url": "https://connect.bridgeapi.io/?email=true&token_uuid=<authentication_token>"
}

Calling the redirect_url URL will start the funnel.