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.
POST /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
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 the 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:
Links returned on the funding source resource, e.g. failed-verification-micro-deposits
, 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, or if it has already failed micro-deposit verification.
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.