Ask AI or search...
Get API Keys

Remove a funding source #

This section outlines how to remove a funding source, both bank account and VAN, by id. A removed funding source is soft deleted and can still be accessed when retrieved.

When a bank funding source with an unverified status is removed, an attempt to re-add it within 48 hours of the initial created date will re-activate the removed funding source and maintain the same id. Removing and re-adding a VAN however, will create a different id.

Things to remember

If a funding source has an outgoing transfer (ACH debit / pull), removing it will not result in the cancellation of any pending transfer(s). In other words, even if a funding source is removed, all pending transfers will continue to export and process to their respective destinations. If you wish to cancel any pending transfers that haven’t yet been exported, you will need to do so by calling the endpoint for cancelling a transfer. Determining if a transfer has been exported or not can be done by retrieving the transfer resource and looking for the cancel link in the response -- if the transfer has been exported, the cancel link is removed.

If a funding source has an incoming transfer (ACH credit / push), we recommend not removing it until the transfer has been processed. Removing it will result in the cancellation of any pending transfer(s). If the recipient is a Verified Customer type, removing it prior to an incoming transfer processing will result in the funds settling to the balance funding source rather than the intended bank funding source.

HTTP request #

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

Request parameters #

ParameterRequiredTypeDescription
idyesstringid of funding source to delete.
removedyesstringSpecify a value of true to remove the associated funding source.

HTTP status and error codes #

HTTP StatusMessage
404Funding source not found.

Request and response - bank funding source #

Raw
POST https://api-sandbox.dwolla.com/funding-sources/692486f8-29f6-4516-a6a5-c69fd2ce854c
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
{
    "removed": true
}

...

HTTP 200 OK
{
  "_links": {
    "self": {
      "href": "https://api-sandbox.dwolla.com/funding-sources/692486f8-29f6-4516-a6a5-c69fd2ce854c",
      "type": "funding-source"
    }
  },
  "id": "692486f8-29f6-4516-a6a5-c69fd2ce854c",
  "status": "verified",
  "type": "bank",
  "bankAccountType": "checking",
  "name": "Test bank account",
  "created": "2016-06-08T21:37:30.000Z",
  "removed": true,
  "fingerprint": "4cf31392f678cb26c62b75096e1a09d4465a801798b3d5c3729de44a4f54c794"
}

Request and response - VAN funding source #

Raw
POST https://api-sandbox.dwolla.com/funding-sources/62c88abb-96cb-4f1e-8ca9-7f45b5308d16
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
{
    "removed": true
}

...

HTTP 200 OK
{
    "_links": {
        "self": {
            "href": "https://api-sandbox.dwolla.com/funding-sources/62c88abb-96cb-4f1e-8ca9-7f45b5308d16",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "funding-source"
        }
    },
    "id": "62c88abb-96cb-4f1e-8ca9-7f45b5308d16",
    "status": "verified",
    "type": "virtual",
    "bankAccountType": "checking",
    "name": "My First VAN",
    "created": "2021-11-19T13:56:11.000Z",
    "removed": true,
    "channels": [
        "external"
    ],
    "fingerprint": "a6f548e4b427191bab4284dc240f673d03046270a4fd519a8a8f82623f2814ac"
}
Test in the Sandbox for free today.
Use sandbox environment to test API requests.
Get API Keys
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.