Payment Services With Connect Full

Overview

Finicity’s Payment Service guide includes how to connect accounts and pull balance information as well as pulling the full routing and account number for use in payment initiation. This most commonly replaces the use of micro deposits for verification of an account number for payment transfer.

Guide Specific To The Payments Industry. There are additional guides you should read prior to going through this guide.

Prerequisites

Connect Overview

Finicity Connect is an embeddable HTML application that makes it easy for financial applications to integrate with Finicity’s suite of API’s. Applications will use Finicity Connect to allow their customers to connect their financial accounts. After the accounts are connected the partner application can generate reports on the account financial data for their customers to provide them the required service.

Finicity Connect allows a consumer to sign into their financial institution (FI) and permission Finicity to gather data from their accounts.  Finicity completely hosts Finicity Connect. This assures the partner does not have exposure to consumer credentials and authentication information.

Finicity Connect is also required for financial institutions that are secured through OAuth. Connect manages the instructions and proper redirection to the financial institution website. For more details on OAuth connections see our OAuth Connections Guide.

Finicity Connect can be integrated into your application in two different ways:

  • 1

    A Redirected URL

  • 2

    Directly Embedded Into the Application

This guide will describe in detail how to use Finicity Connect, how to integrate it into your application, how to manage and receive Finicity Connect events, and how to manage and receive report generation events.

Related Guides

Create Customer

First step in connecting a customer is creating a customer record in the Finicity API. A Finicity customer record represents your borrower and is the parent record for all other financial data such as account data and transaction data.

Get Fincity Connect Link

The next step is generating a Finicity Connect link. This link is specific to the customer, and is used to permission access to the FI and add accounts. The finicity connect link is called for a specific flow or use case (called a Connect “type”). For the payments industry use case you would call the specific type of “ach” which will give the customer a flow to choose one of their accounts.

Integrate Finicity Connect URL Into Your Application – Web

Having received the Connect URL, you can integrate the Finicity Connect experience into your application. For the web application experience, you can choose to redirect to a new page, or use the SDK to embed it into your application, following the instructions in the link below.

Integrate Finicity Connect URL Into Your Application – Mobile

For mobile integration, please follow these instructions on how to integrate it into your mobile app.

Retrieving ACH Information – Routing and Account Number

Finicity’s ACH Account Verification Service pulls an Account and Routing number for a specified account for use in the payment initiation. This most commonly replaces the use of micro deposits for verification of an account number for payment transfer. Once a customer has connected their account(s) the routing and account number can be retrieved for a specified account using this service with the accountId.

Retrieving Latest Balance Information

By default Finicity will pull the latest register balance and available balance for an account when it is first connected. To get the balance for the first time you will call “Refresh Institution Login Accounts” and then to retrieve the balance you will call the service for account data “Get Customer Account” which will give you all the account data including the register and available balance. That can then be used prior to initiating payment.

In the case that the customer has connected their accounts previously and you are wanting to get an update to date balance before initiating payment Finicity does automatically pull the balance on a 24 hour basis. If you require a balance updated up to the moment before you initiate payment you may do a one time account data refresh from the FI by call the service “Refresh Institution Login Accounts” for the account you need to update the balance on and then utilize the service “Get Customer Account” to pull the balance data before initiating payment.

As a note you can always tell how up to date a balance is by utilizing the “aggregationSuccessDate” timestamp on the account data which will tell you when the balance was last successfully pulled.

Connect Webhook Events

We know that while your customer is in the Finicity Connect flow, it is important to understand what they are doing and what their experience is like. To facilitate this we have provided web hook events that will be sent to the webhook URL you pass in the Generate Connect API call. For a detailed guide of the webhook events you will receive, see the webhooks details link below.

Connect Route Events

In addition to Webhooks events we also provide route events that you can use to receive more immediate updates on application behavior, directly in the browser. Instructions on how to utilize those can be found here.

Utilizing Analytics Systems For Connect

We support passing google or adobe analytics data into the calls as well for tracking. See the article for more details.