Verify micro-deposits #

This section covers how to verify micro-deposits for bank verification. Reference the funding source verification resource article for more information on the micro-deposit method of bank account verification. Note: Micro-deposits do not expire. Micro-deposits can be verified anytime in the future after they have a processed status in the Dwolla system.

HTTP request #

POST https://api.dwolla.com/funding-sources/{id}/micro-deposits

Request parameters #

ParameterRequiredTypeDescription
idyesstringid of funding source to verify micro-deposits on.
amount1yesstringAn amount JSON object of first micro-deposit. Contains value and currency.
amount2yesstringAn amount JSON object of second micro-deposit. Contains value and currency.

HTTP status and error codes #

HTTP StatusCodeDescription
200OKMicro-deposits successfully verified.
202TryAgainLaterMicro-deposits have not have not settled to destination bank. A Customer can verify these amounts after micro-deposits have processed to their bank.
400ValidationErrorInvalidAmount, "Wrong amount(s)."
400MaxNumberOfResourcesMicro-deposits already initiated for this funding source.
403InvalidResourceState"Too many attempts.", "Bank already verified."
404NotFoundMicro-deposits not initiated,Funding source not found
500Unknown"Verify micro-deposits returned an unknown error."

Request and response #

JavaScript
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
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",
  },
};

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

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2022 All Rights Reserved
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.