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 #

Parameter	Required	Type	Description
id	yes	string	id of funding source to verify micro-deposits on.
amount1	yes	string	An amount JSON object of first micro-deposit. Contains `value` and `currency`.
amount2	yes	string	An amount JSON object of second micro-deposit. Contains `value` and `currency`.

HTTP status and error codes #

HTTP Status	Code	Description
200	OK	Micro-deposits successfully verified.
202	TryAgainLater	Micro-deposits have not have not settled to destination bank. A Customer can verify these amounts after micro-deposits have processed to their bank.
400	ValidationError	InvalidAmount, "Wrong amount(s)."
400	MaxNumberOfResources	Micro-deposits already initiated for this funding source.
403	InvalidResourceState	"Too many attempts.", "Bank already verified."
404	NotFound	Micro-deposits not initiated,Funding source not found
500	Unknown	"Verify micro-deposits returned an unknown error."

Request and response #

Raw

POST https://api-sandbox.dwolla.com/funding-sources/e52006c3-7560-4ff1-99d5-b0f3a6f4f909/micro-deposits
Authorization: Bearer 8tJjM7iTjujLthkbVPMUcHLqMNw4uv5kG712g9j1RRBHplGpwo
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json

{
    "amount1": {
        "value": "0.03",
        "currency": "USD"
    },
    "amount2": {
        "value": "0.09",
        "currency": "USD"
    }
}

HTTP 200 OK

Initiate micro-deposits

Retrieve a funding source balance

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.