Dwolla Developers Logo
Back
Guides
  • 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
    Verify Bank with Micro-deposits
    OverviewStep 1: Initiate micro-depositsStep 2: Verify micro-deposits
    Add Bank via Dwolla + Plaid Integration
  • Webhooks
    Create a Webhook Subscription
API DocsOpen in new tabChangelog
Get API Keys
API DocsOpen in new tabChangelog
JavaScript
Get API Keys

Verify micro-deposits #

In the Dwolla production environment, you must wait until the micro-deposits actually post to the customerā€™s bank account before the account can be verified, which can take 1-2 business days. A microdeposits_completed event will be triggered once micro-deposits have successfully posted to the bank. Once micro-deposits have completed, a verify-micro-deposits link relation will return on the funding source letting your application know the funding source can be verified. When the amounts are entered for verification, the order in which they are entered doesn't matter.

Info
In the Sandbox environment, any amount below $0.10 will allow you to verify the account immediately.
JavaScript
var fundingSourceUrl =
  "https://api-sandbox.dwolla.com/funding-sources/e52006c3-7560-4ff1-99d5-b0f3a6f4f909";
var requestBody = {
  amount1: {
    value: "0.03",
    currency: "USD",
  },
  amount2: {
    value: "0.09",
    currency: "USD",
  },
};

appToken.post(`${fundingSourceUrl}/micro-deposits`, requestBody);

Handle failed verification attempts #

Your customer will have only three attempts to correctly input the two posted micro-deposit amounts. If your customer reaches the max attempts allowed, a microdeposits_maxattempts event will be triggered and a failed-verification-micro-deposits link will be returned in the response for the funding-source. As a result, they will no longer be allowed to verify the funding source using those same two posted micro-deposit amounts. In order to retry bank account verification via micro-deposits, the following steps will need to be taken by your customer and application:

  1. Removal of the funding source with failed micro-deposit verification attempts.
  2. Wait 48 hours after the initial funding source was added to re-add the funding source.
  3. Initiate new micro-deposits to the funding source.
  4. Verify the funding source using the new posted micro-deposit amounts.

Links returned on the funding source resource, either initiate-micro-deposits or verify-micro-deposits, will give your application insight into whether the funding source is eligible to receive or verify micro-deposits.

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2021 All Rights Reserved

Dwolla

  • About
  • Blog
  • Pricing
  • Contact Sales
  • Terms of Service
  • Privacy Policy
Financial institutions play an important role in our network.

Dwolla, Inc. is the operator of a software platform that communicates user instructions for funds transfers to our financial institution partners.

Dwolla is an agent of Veridian Credit Union. All ACH and Wire transfers are performed by Veridian Credit Union. Your Dwolla Balance, if any, is held in one or more pooled holding accounts held by Veridian Credit Union. These funds may not be eligible for share insurance by the National Credit Union Share Insurance Fund.

Sponsorship and Settlement of Push-to-Debit payment services provided by MetaBankĀ®, N.A.
Push-to-Debit payments are typically available within 30 minutes.

Real-Time Payments are performed by Cross River Bank, which holds funds on behalf of the Receiver of such transactions in one or more pooled custodial accounts. These funds are not subject to FDIC pass-through deposit insurance.