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, 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, we recommend not removing it until the transfer has been processed. If the recipient Customer has multiple funding sources attached, doing so will result in the funds processing to a randomly chosen bank funding source. If the recipient is a Verified Customer type with only one bank funding source attached, 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 #

HTTP status and error codes #

Request and response - bank funding source #

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 #

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"
}