Select Language

Getting Started
Testing in the Sandbox
Generate an OAuth Access Token
Send Money to Users
Receive Money from Users
Transfer Money Between Users
Transfer Money Me-to-Me
Building With Drop-in Components
Customers
Create a Business Verified Customer
Create a Personal Verified Customer
Funding Sources
Add a Debit Card Using Dwolla-cards.js
Add a Bank Using Dwolla.js
Add a Bank Using Dwolla.js + IAV
Overview Step 1: Create a container for IAV Step 2: Create an IAV token Step 3: Configure and call function Step 4: Handle JavaScript callback
Verify Bank with Micro-deposits
Add Bank via Dwolla + Plaid Integration
Webhooks
Working with Webhooks

Add a Bank Using Dwolla.js + IAV #

For Dwolla API customers, dwolla.js has the added function of facilitating Instant Account Verification (IAV) on their customer's bank or credit union account. This resource guide will walk you through the process of generating an IAV token, and rendering the IAV flow to attach a verified bank funding-source to a Customer account. By calling a separate function dwolla.iav.start(), your application can render the IAV flow within a specified container. dwolla.iav.start() allows for customization through configurable options such as:

stylesheets - a list of CSS stylesheets for styling the IAV flow
microDeposits - presents a selection screen for the user to choose the micro-deposit method of bank verification throughout the IAV flow
fallbackToMicroDeposits - presents a selection screen for the user to fallback to selecting the micro-deposit method of bank verification within the IAV flow
backButton - displays a back button throughout the IAV flow
subscriber - a function that can be used by an application to subscribe to state changes throughout the IAV flow

dwolla.iav.start()

ParameterTypeValueiav-tokenstringA single use IAV token generated on your server.optionsobjectAn object containing configurable options. Contains keys: container, stylesheets, microDeposits, fallbackToMicroDeposits, backButton, and subscriber. See example below.
container represents a string value container element where IAV will render.
stylesheets represents an array list of stylesheets to load IAV styles.
microDeposits represents a boolean true or false value which determines if the micro-deposit method of bank verification is presented as an option throughout the IAV flow.
fallbackToMicroDeposits represents a boolean true or false value which determines if a fallback selection screen appears for choosing an alternative bank verification method.
backButton represents a boolean true or false value which determines if a back button is displayed throughout the IAV flow.
subscriber is a function that can be used to subscribe to state changes throughout the IAV flow. This function will be called with an object containing a currentPage and an optional error attribute.callbackfunctionA callback function that handles the response from Dwolla.

Example

javascript

dwolla.iav.start(
  "8zN400zyPUobbdmeNfhTGH2Jh5JkFREJa9YBI8SLXp0ERXNTMT",
  {
    container: "iavContainer",
    stylesheets: [
      "https://fonts.googleapis.com/css?family=Lato&subset=latin,latin-ext",
    ],
    microDeposits: false,
    fallbackToMicroDeposits: true,
    backButton: true,
    subscriber: ({ currentPage, error }) => {
      console.log("currentPage:", currentPage, "error:", JSON.stringify(error));
    },
  },
  function (err, res) {
    console.log(
      "Error: " + JSON.stringify(err) + " -- Response: " + JSON.stringify(res)
    );
  }
);

Getting Started: Initial configuration #

Include dwolla.js

Begin the client-side implementation by including dwolla.js in the HEAD of your HTML page. You can include either the development version(<script src="https://cdn.dwolla.com/1/dwolla.js"></script>) or the minified version (<script src="https://cdn.dwolla.com/1/dwolla.min.js"></script>) of dwolla.js.

html

<head>
  <script src="https://cdn.dwolla.com/1/dwolla.js"></script>
</head>

Step 1: Create a container for IAV

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys

Dwolla

Product

Developers

Financial institutions play an important role in our network.

All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.