Retrieve micro-deposits details #

This section shows how to retrieve the status of micro-deposits and check if micro-deposits are eligible for verification. If the status of micro-deposits is failed, a failure object will be returned in the response body which includes the ACH return code and description.

HTTP request #

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

Request parameters #

ParameterRequiredTypeDescription
idnostringid of funding source to check status of validation deposits.

Micro-deposits object #

AttributeDescription
_linksA _links JSON object
createdISO-8601 timestamp
statusPossible values: pending, processed, or failed. pending represents micro-deposits initiated and are en route to their destination. processed represents micro-deposits have reached the destination account and are awaiting verification. failed represents micro-deposits failed to clear successfully to the destination.
failureDetermines if micro-deposits fail to complete to a bank. Failure is an object that contains a code and description, which represents the ACH return code and description of the return.

HTTP status and error codes #

HTTP StatusCodeDescription
200OkPending micro-deposits exist.
404NotFoundThe requested resource was not found.

Request and response #

JavaScript
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var fundingSourceUrl =
  "https://api-sandbox.dwolla.com/funding-sources/692486f8-29f6-4516-a6a5-c69fd2ce854c";

dwolla.get(`${fundingSourceUrl}/micro-deposits`).then((res) => res.body.status); // => "failed"

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.