Docs
Get API Keys

    Changelog #

    Keep up to date on new product features and enhancements, API docs, tools changes, and development updates.

    Upcoming #

    Completed #

    2024-02-20 #

    ADDED

    • Added a new retry-with-full-ssn link to the Customer resource. This link appears whenever retry information is required for the Controller in order to verify the business verified Customer.
    • Check out our Developer documentation for more information.

    2024-01-11 #

    SUNSET

    • Dwolla has retired the dwolla.js library, which supported adding an unverified bank funding source. Check out the official announcement.
    • The legacy dwolla.js has been replaced with functionality that has been added to our Drop-in Components library. This library will serve as our primary web UI components library and offer an enhanced developer experience. Please refer to our migration guide for more details, including alternative solutions.
    • The following API endpoints are removed as part of the sunset: /customers/{id}/iav-token and /customers/{id}/funding-sources-token.

    2023-05-15 #

    ADDED

    2023-05-31 #

    DEPRECATED

    • Dwolla has discontinued support for the Push-to-Debit product feature, which was powered by dwolla-cards.js. Includes removal of card related webhooks as well as the funding source type for cards to support Push-to-Debit payments.

    2022-12-31 #

    DEPRECATED

    • Dwolla has discontinued support for the Instant Account Verification (IAV) product, which was powered by Dwolla.js.
    • As alternative bank account verification options, we recommend utilizing one of our integrated third-party data providers — Finicity or MX via our Secure Exchange, or Plaid.

    2022-10-31 #

    ADDED

    • Added support for including facilitator fees when creating transfers from Verified Customer's Bank into their Dwolla balance. Previously, fees could only be applied to transactions between two parties.

    2022-10-27 #

    ADDED

    • Added the correlationId attribute to the webhook payload for transfer related webhooks if a value was specified on transfer creation.

    2022-10-26 #

    ADDED

    • Added new API endpoints for Exchanges and Exchange Partners with the release of the Secure Exchange solution. The Secure Exchange solution connects clients with integrated ecosystem partners to seamlessly share data and initiate account-to-account payments.

    2022-06-28 #

    ADDED

    • Added a new document failure reason, ForeignPassportNotAllowed, for when a foreign passport is uploaded for Personal Verified Customers. Foreign passports are still accepted when uploaded for Business Controllers or Beneficial Owners.

    2022-06-14 #

    ADDED

    • Added volume-based rate limits for all Dwolla API endpoints. To learn more, check out our Rate Limits section under API Reference.

    2022-03-28 #

    ADDED

    • Added a new document failure reason, ScanIdUnrecognized, for both business and personal customers.

    2021-11-12 #

    ADDED

    • Added a new documentVerificationStatus field to the document resource. This field indicates the status of the document after it has been reviewed by Dwolla. Possible values include pending, accepted and rejected.
    • Check out our Developer documentation for more information and an example API response.

    2021-10-07 #

    ADDED

    • Added a new upload-dba-document link to the Customer resource. This link appears whenever a DBA (Doing Business As) document is required from the Customer to verify their business.
    • Added an _embedded object to the Customer resource which contains a list of errors related to getting the Customer verified. The _embedded object appears whenever the Customer is in retry or document.
    • Check out our Developer documentation for more information.

    2021-09-21 #

    ADDED

    • Added client-side form validation to the Add a Debit Card form in dwolla-cards.js. This enables the form to display helpful error messages to the user whenever they enter invalid data.

    2021-08-27 #

    ADDED

    • Added new Business document failure reasons to the API - BusinessDocNotSupported, BusinessNameMismatch, BusinessTypeMismatch.
    • Updated failure descriptions for ScanFailedOther and ScanNameMismatch to provide more details about the failure reason.
    • Check out our Developer documentation.

    2021-03-10 #

    ADDED

    2021-01-05 #

    ADDED

    2020-12-08 #

    ADDED

    • Added Drop-in components. These are pre-built UI components that provide a low-code solution for integrating parts of the Dwolla API into your application. Learn more about Drop-in components in our documentation and check out our guide on building with Drop-in components.

    2020-12-02 #

    ADDED

    • Added support for simulating document status for Business Verified Customers in Sandbox. Check out our Testing in the Sandbox guide to learn more.

    2020-09-15 #

    ADDED

    • Added a new funding source type for cards to support Push-to-Debit payments.
    • Sunset Notice: Push-to-Debit was sunset on 2023-05-31.

    2020-08-05 #

    UPDATED

    2020-03-10 #

    CHANGED/ADDED

    2020-03-06 #

    CHANGED/ADDED

    • Removed support for uploading duplicate documents for a Customer in document status. If a request to upload a duplicate document is sent, it will fail with a validation error response that includes a link to the existing uploaded document for the Customer.

    2019-10-09 #

    ADDED

    • Added a new Knowledge-based Authentication (KBA) resource to the API.
    • KBA is a component of verifying the identity of Personal Verified Customers.
    • Head over to our API Docs or check out our blog post to learn more.

    2019-10-09 #

    ADDED

    • Added support for including the clearing JSON object when creating a mass payment.
    • The clearing object allows for the clearing time of individual mass payment items to be upgraded or downgraded from the default ACH processing time.
    • Head over to our API Docs to learn more.

    2019-09-06 #

    CHANGED

    • Added a new JSON object called allFailureReasons to the Document resource, which helps with further identifying the reason for the rejection of an identity verification document uploaded for a Verified Customer.
    • Check out our Developer documentation.

    2019-08-26 #

    CHANGED

    • Updated the me-to-me funds flow to support creating transfers between two banks of a Customer with a single transfer request.
    • Check out our Resource Article to learn more.

    2019-08-26 #

    ADDED

    • Added a new Kotlin SDK.
    • Check it out on our Github for more information and to provide feedback.

    2019-05-31 #

    ADDED

    • Added a new total attribute to the Balance object in the API.
    • Introducing total and available balance amounts for a Dwolla Balance.
    • Head over to our API Docs or check out our resource article to learn more.

    2019-05-16 #

    ADDED

    • Added a new Labels resource to the API.
    • A Label represents a designated portion of funds within a Verified Customer’s balance.
    • Head over to our API Docs or check out our blog post to learn more.

    2019-03-01 #

    ADDED

    • Added a new attribute called traceId to the achDetails object within the Transfer resource, which helps with further identifying a transfer to/from a user’s bank account. Jump to our API Docs.

    2019-02-21 #

    UPDATED

    • Dwolla allows an application to request an access token using its Client Id and Client Secret by leveraging the Client Credentials OAuth grant type. Access tokens are used to make requests to the Dwolla API on behalf of an application and its users (customers).
    • Previously, applications made a call to https://www.dwolla.com/oauth/v2/token and specified the application/x-www-form-urlencoded Content-Type header, passing their client credentials (App Key and App Secret) through the body of the HTTP message sent to Dwolla.
    • With this update, the token URL as well as the manner in which an application’s client credentials are sent to Dwolla, will change to be inline with OAuth spec.
    • The new Dwolla token exchange endpoint is https://api.dwolla.com/token
    • Reference our API Reference Docs to learn more.

    2019-01-07 #

    DEPRECATED

    • Dwolla has discontinued support for the v1 API and Transfer API
    • Learn more on our blog post for more information.

    2018-06-30 #

    ADDED

    • Addenda support–The addenda record is used to provide additional information to the payment recipient about the payment. This value will be passed in a transfer request and can be exposed on your user’s bank statement. Addenda records provide a unique opportunity to supply your users with more information about their transactions.
    • Learn more on our blog post.

    2018-06-30 #

    DEPRECATED

    • Dwolla has discontinued support for TLS 1.0 and TLS 1.1.
    • Learn more on our blog post.

    2018-06-04 #

    UPDATED

    • Dwolla has discontinued support for .tif file upload.

    2018-05-30 #

    UPDATED/ADDED

    • New webhook funding_source_negative and customer_funding_source_negative
    • Jump to our dev docs.

    2018-05-30 #

    UPDATED - SDK - C#

    • New version of C# SDK.
    • Breaking changes:
    • DwollaClient no longer throws on API errors, they should be properly deserialized into RestResponse.Error instead.
    • DwollaException, RestException, and RestResponse.Exception are removed.
    • Use EmptyResponse instead of object in DwollaClient interface.
    • Check it out on our Github

    2018-05-11 #

    CHANGED

    • Change in verified business Customer creation flow across Platform. Check out our developer guide to learn how to create this Customer type within the new flow.
    • In order to comply with United States Federal law, Dwolla also requires beneficial owners to be added to a Customer. Read our blog post to learn more about why we need to comply with US customer due diligence rules.

    2018-04-11 #

    CHANGED

    • Verified business Customers creation flow has changed in sandbox. Check out our developer guide to learn how to create this Customer type within the new flow.
    • In order to comply with United States Federal law, Dwolla also requires beneficial owners to be added to a Customer. Read our blog post to learn more about why we need to comply with US customer due diligence rules.
    • Please note that this change will go live in across platform on May 11th, 2018.

    2018-04-11 #

    ADDED - Developer Guide

    • Added a new Developer Guide that goes over the new business verified Customer creation flow with Dwolla.
    • Click here to view the article

    2018-04-11 #

    UPDATED/ADDED - Dev Docs update

    2018-04-03 #

    UPDATED - Dev Docs update

    • Added method and URL to Documents section

    2018-03-30 #

    UPDATED - Developer Resources Article

    • Changed screenshot to reflect the proper On-Demand Auth Language.

    2018-03-28 #

    UPDATED - Developer Resources Article

    • Updated transfer failures doc
    • Updated verification handling doc

    2018-02-12 #

    UPDATED - Dev Docs update

    • Updated docs to reflect business name updates.

    2017-11-16 #

    CHANGED

    • Bank balance check functionality changing to be asynchronous and immediately return an HTTP 202. The response body for the 202 will contain a status relating to the processing of this request. Subsequent requests to this endpoint will return a 202 up until processing completes and then either return an HTTP 200 with the current balance or an HTTP 400 if there was an error (i.e. UnsupportedBank).

    2017-11-16 #

    ADDED

    • Added a new customer_balance_inquiry_completed event. Upon checking a Customer’s bank balance, Dwolla will immediately return an HTTP 202 with response body that includes a status of processing. This event will be triggered when the bank balance check has completed processing. To read more on how to trigger this event, check out our forum post.

    2017-11-04 #

    ADDED

    • Added a new customer_bank_transfer_creation_failed event. This event will be triggered when an attempt to initiate a transfer to a verified Customer’s bank was made, but failed. Transfers initiated to a verified Customer’s bank must pass through the verified Customer’s balance before being sent to a receiving bank. Dwolla will fail to create a transaction intended for a verified Customer’s bank if the funds available in the balance are less than the transfer amount. To read more on how to trigger this event, check out our forum post.

    2017-06-29 #

    CHANGED/DEPRECATED

    • Changing "uat" in the subdomain of public facing and API URLs with "sandbox". Reference this blog post for more information.

    2016-05-02 #

    ADDED

    • Release support for a new (optional) backButton and subscriber options for IAV within dwolla.js. Note: Dwolla.js is a premium feature only available for Dwolla API customers.

    2017-04-27 #

    DEPRECATED

    • Removal of the Sandbox Console tool which exists at: https://sandbox-uat.dwolla.com/

    2016-12-01 #

    ADDED

    • Release support for a new clearing request parameter when initiating a transfer. Clearing is a JSON object that supports specifying same-day and standard ACH clearing per API request. Note: The clearing request parameter is a premium feature available for Dwolla API customers.

    2016-12-01 #

    DEPRECATED

    2016-12-01 #

    CHANGED

    • Automatic pause of webhook subscriptions after 400 consecutive failed delivery attempts. Reference the API docs for more information.

    2016-10-19 #

    CHANGED

    2016-10-19 #

    ADDED

    • Added a new bankName attribute to the funding source object that is returned when retrieving a funding source of type bank.

    2016-07-21 #

    DEPRECATED

    Remove the profileId request parameter from the Off-Site Gateway in API v1.

    2016-06-17 #

    ADDED

    • Release support for an optional Idempotency-Key header on requests to API v2.

    2016-06-01 #

    CHANGED/DEPRECATED

    • Change in functionality for removing a funding source in API v2. The method for removing a funding source changes from a DELETE to a POST with the need to supply {"removed": true} in the body of the request.
    • A removed attribute is added to the funding source object.
    • A removed querystring request parameter is supplied when listing an Account or Customer’s funding sources. By default, all funding sources are returned from the listing unless the removed request parameter is set to false.

    2016-02-29 #

    DEPRECATED

    • Removal of the description field in API v2 error responses. Replacing description with the message field which is a duplication of description.
    • Removing the X-Request-Signature header from webhook requests. Replacing with a X-Request-Signature-SHA-256 header which is a SHA-256 HMAC hash of the request body with the key being your webhook secret.

    2015-11-25 #

    ADDED

    • Release endpoint in API v2: retrieve a list of business classifications for a Customer. POST /business-classifications
    • Release endpoint in API v2: retrieve a business classification by it’s id for a Customer. POST /business-classifications/{id}
    • Release business verified Customer creation in API v2.

    2015-11-19 #

    ADDED

    • Release endpoint in API v2: generate a funding sources token for a Customer. POST /customers/{id}/funding-sources-token
    • Release endpoint in API v2: retrieve ACH transfer failure reason. GET /transfers/{id}failure

    2015-11-13 #

    ADDED

    • Release endpoint in API v2: generate an IAV token for a Customer. POST /customers/{id}/iav-token
    • Release dwolla.js to the CDN. https://cdn.dwolla.com/1/dwolla.js

    2015-11-12 #

    CHANGED

    • Error changes - Introduce new message field in error response. Errors now include a profile link in the Content-Type header. Error responses with the top-level error code ValidationError will return an _embedded object containing a list of errors.

    2015-11-02 #

    CHANGED

    • OAuth redirect_uri must match the OAuth Redirect URL field set in Dwolla application’s settings.

    2015-10-30 #

    ADDED

    • Release endpoint in API v2: initiate or verify micro-deposits for bank verification. POST /funding-sources/{id}/micro-deposits
    2024 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.