Atomic logo

Banno Onboarding Guide

To start the process, you will first need to be set up in the Atomic system.

Visit the Request a Demo Page to connect and get set up in our backend systems. If you're already set up in our system, please proceed to the next step.

You will need to create a new External Application in Banno People. Navigate to the External Applications Page in Banno People. This page will have additional properties added for filling out, once the Redirect URIs are populated.

Fill out the following properties with the values provided:

  • Name: Atomic Financial Plugin
  • Client Type: Check Confidential and Require PKCE
  • Leave User consent required unchecked.
For the next step, you will need the Client ID and Client Secret from this page in Banno People. You will add them to the Atomic Console, which will give you the Redirect URIs needed to reveal the rest of this page.
Screenshot of the Banno People application showing the configuration options for an External Application.

Once you have gotten connected with the Atomic team, they will enable your Financial Institution in our backend system. This will give you access to the Atomic Console.

To get set up in the Console follow these steps:

  1. Log in to the Atomic Console.
  2. Go to the Banno page in the Console settings.
    If this page is missing you are not set up in the Atomic system. Please contact your sales representative.
  3. At the top right of the page is a dropdown for Sandbox and Production. When you first login, it will be set to Sandbox, please switch this to Production.
    Screenshot of the dropdown selector in Atomic Console. Shows options for Production or Sandbox.
  4. Put your Client ID and Client Secret from Banno People into the input boxes. The Environment field is the location your users go to on the internet to access your FI's Banno system. Click Save to securely transact your details to our backend so our systems can communicate with each other.
    Screenshot of the Atomic Console showing the External Application Configuration section of the Banno page
  5. Next, you will need to copy the 2 Redirect URIs from our system and paste them into Banno People in the same order they are displayed in the Console.
    Screenshot of the Atomic Console showing the redirects URIs section of the Banno page.
  6. The order of the Redirect URIs is important, so please copy them to Banno People in the same order they are shown in the Atomic Console.

The last things you'll need to do to get your External App set up in Banno People are as follows:

  1. Copy the Redirect URIs from the Atomic Console settings page into the Redirect URIs section of Banno People in the same order they are displayed in the Atomic Console.
    Once the Redirect URIs are added, more fields will become visible on the page.
  2. Set the Link type field to: PluginCard.
  3. Set the Link title to be: Direct Deposit.
  4. Under Endpoint Version, check Use v0 endpoints in Banno Apps.
  5. User type: Select All from the dropdown.
  6. Click the "Enabled" toggle at the bottom of the page to enable the External Application.
Screenshot of the Banno People application showing the External Application configuration options with the Redirect URIs input fields and the Enable toggle areas circled in red to hightlight where they are on the page.

Now you will need to create a Plugin. A Plugin is the card which will be displayed to your users in their dashboard. Go to the Dashboard Configuration page in Banno People and fill out the following properties:

  • Title: Direct Deposit
  • Description: Set up direct deposit to your account by connecting your paycheck.
  • External Application: Select "Atomic Financial Plugin". This is the External Application you created earlier.
  • Initial Height: 156
  • Icon: circle dollar
  • When you are ready to enable this for your users, you can enable the "Available to everyone" option here.
  • Do not change anything in either the Label or External Application fields. The External Application field must not be connected to an External Application, so please leave as is.
  • You have now created the Plugin which will be viewable for your users! You will want to add this plugin card to your user's default dashboard in an appropriate position, so please do so now. Be sure to let everyone know about the newly available functionality!
Screenshot of the Plugin configuration screen inside the Banno People App.

Now that you have your plugin configured, you have two ways to test your Atomic-Banno integration

  1. Via the Atomic Console.
  2. Directly through your plugin.

Both of these options utilitze our test credentials. These work by using the test- credentials as the user name when logging in to the payroll system. The credentials are intercepted in our backend and do not actually communicate with the employer or payroll systems, but are useful for testing the various flows which an end user can take when interacting with Transact.

You also have 5 free live-tests available in production. To take advantage of the live-tests, launch the plugin and log in to a payroll with a tester's credentials. You will progress through the flow as normal, communicating with the employer or payroll systems; however, no charges are associated with these tasks. When a live-test is used, it will switch the direct deposit of the user, so please use with caution.

Email us at banno@atomicfi.com when you are ready to go live for your customers and we will move you from live testing in our backend systems to full access.

Let us know if you have any questions or ideas!

If you need assistance please reach out to your Atomic representative or email us at banno@atomicfi.com