Funding Sources #

The Funding Sources resource represents payment accounts that can be used to send and/or receive funds. Funding sources are relational to either a Dwolla Master Account or Customer and can be used to reference details on a payment account.

Funding source types #

The three funding source types available with a Dwolla integration include a bank, the Dwolla balance, and a virtual account. Type bank represents any bank account attached as a funding source to Account and Customer resources. Type balance represents the Dwolla Balance made available to Account and Verified Customer resources. Type virtual represents a Virtual Account Number (VAN) funding source which can be used outside of the Dwolla Platform to route ACH payments both to and from a Dwolla Balance.

Bank funding source

Funding sources of type bank include an additional attribute, bankAccountType, denoting the type of the bank account being attached. The bank account types currently supported by Dwolla include checking, savings, general-ledger and loan.

• checking, savings - Checking and savings accounts can be attached to any Customer type. These account types are enabled for all Accounts and Customers, by default.

• general-ledger - General ledger accounts can only be attached to exempt Business Verified Customers. Note: Enabling this account type requires additional Dwolla approvals before getting started. Please contact Sales or your account manager for more information on enabling this account type.

• loan - Loan accounts can only be attached to Verified Customers. These funding-sources can only be credited, meaning funds can only be sent to these accounts. Note: Enabling this account type requires additional Dwolla approvals before getting started. Please contact Sales or your account manager for more information on enabling this account type.

Balance funding source

The Dwolla Balance can be utilized as a digital "wallet", storing USD funds for the Customer or Account with Dwolla’s financial institution partners. Additionally, the Dwolla Balance can be pre-loaded with funds for quicker outgoing ACH transfers to destination funding sources. To get a more in-depth overview of the Dwolla Balance, including functionality and other benefits, check out our developer resource article or view our webinar.

Virtual account funding source

The Virtual Account Number, or VAN, is a funding source that upon creation contains both an account number and routing number which can be utilized outside of the Dwolla Platform to route ACH payments both to and from a Dwolla Balance. VANs cannot be used as a source or destination in POST requests to the /transfers endpoint as they can only be associated with activity that originates from outside of the Dwolla Platform. Because a VAN behaves as a route to a Dwolla balance, only Master Dwolla Accounts and Verified Customers are eligible to create a VAN funding source.

Funding source links #

Funding source resource #

Funding source resource example

{
    "_links": {
        "self": {
            "href": "https://api-sandbox.dwolla.com/funding-sources/fc84223a-609f-42c9-866e-2c98f17ab4fb",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "funding-source"
        },
        "customer": {
            "href": "https://api-sandbox.dwolla.com/customers/241ec287-8d7a-4b69-911e-ffbea98d75ce",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "customer"
        }
    },
    "id": "fc84223a-609f-42c9-866e-2c98f17ab4fb",
    "status": "verified",
    "type": "bank",
    "bankAccountType": "checking",
    "name": "Your Account #1 - CHECKING",
    "created": "2017-08-16T20:06:34.000Z",
    "removed": false,
    "channels": [
        "ach",
        "real-time-payments"
    ],
    "bankName": "SANDBOX TEST BANK",
    "iavAccountHolders": {
        "selected": "account holder",
        "other": [
          "Jane Doe",
          "GeneriCompany LLC"
        ]
    },
    "fingerprint": "4cf31392f678cb26c62b75096e1a09d4465a801798b3d5c3729de44a4f54c794"
}