DocsStep 3: Retrieve funding sources #
Now that you’ve created a Customer and associated its funding source, you are close to being able to initiate your first transfer. The transfer requires the following information:
- The funding source to pull the funds from (a bank attached to your Dwolla Master Account)
- The funding source to push the funds to (a bank attached to your created Customer)
Dwolla uses URLs to represent relations between resources. Therefore, you’ll need to provide the full URL of the funding source when creating the transfer.
Step 3A: Retrieve your Dwolla Master Account's list of available Funding Sources #
Use the list an account’s funding sources endpoint to fetch a list of your own funding sources. You’ll need your account URL which can be retrieved by calling the Root of the API.
Request and Response (view schema in raw)
GET https://api-sandbox.dwolla.com/accounts/ad5f2162-404a-4c4c-994e-6ab6c3a13254/funding-sources?removed=false
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer 0Sn0W6kzNicvoWhDbQcVSKLRUpGjIdlPSEYyrHqrDDoRnQwE7Q
{
"_links": {
"self": {
"href": "https://api-sandbox.dwolla.com/accounts/ad5f2162-404a-4c4c-994e-6ab6c3a13254/funding-sources"
}
},
"_embedded": {
"funding-sources": [
{
"_links": {
"transfer-from-balance": {
"href": "https://api-sandbox.dwolla.com/transfers",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "transfer"
},
"self": {
"href": "https://api-sandbox.dwolla.com/funding-sources/b5e68264-7d4d-42a9-88d4-5616c77c6baa",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "funding-source"
},
"remove": {
"href": "https://api-sandbox.dwolla.com/funding-sources/b5e68264-7d4d-42a9-88d4-5616c77c6baa",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "funding-source"
},
"transfer-send": {
"href": "https://api-sandbox.dwolla.com/transfers",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "transfer"
},
"transfer-receive": {
"href": "https://api-sandbox.dwolla.com/transfers",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "transfer"
},
"account": {
"href": "https://api-sandbox.dwolla.com/accounts/ad5f2162-404a-4c4c-994e-6ab6c3a13254",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "account"
}
},
"id": "b5e68264-7d4d-42a9-88d4-5616c77c6baa",
"status": "verified",
"type": "bank",
"bankAccountType": "checking",
"name": "ABC Bank Checking",
"created": "2019-03-14T15:18:51.336Z",
"removed": false,
"channels": [
"ach"
],
"bankName": "SANDBOX TEST BANK"
},
{
"_links": {
"self": {
"href": "https://api-sandbox.dwolla.com/funding-sources/b268f6b9-db3b-4ecc-83a2-8823a53ec8b7",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "funding-source"
},
"balance": {
"href": "https://api-sandbox.dwolla.com/funding-sources/b268f6b9-db3b-4ecc-83a2-8823a53ec8b7/balance",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "balance"
},
"transfer-send": {
"href": "https://api-sandbox.dwolla.com/transfers",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "transfer"
},
"with-available-balance": {
"href": "https://api-sandbox.dwolla.com/funding-sources/b268f6b9-db3b-4ecc-83a2-8823a53ec8b7",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "funding-source"
},
"transfer-receive": {
"href": "https://api-sandbox.dwolla.com/transfers",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "transfer"
},
"account": {
"href": "https://api-sandbox.dwolla.com/accounts/ad5f2162-404a-4c4c-994e-6ab6c3a13254",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "account"
}
},
"id": "b268f6b9-db3b-4ecc-83a2-8823a53ec8b7",
"status": "verified",
"type": "balance",
"name": "Balance",
"created": "2014-07-09T20:39:33.000Z",
"removed": false,
"channels": []
}
]
}
}
When the funding sources list is successfully retrieved, you will receive a 200 HTTP response with the details of each funding source. After retrieving your list of funding sources, we recommend storing the full URL for future use as it will be referenced when creating the transfer to your user’s bank account.
Step 3B: Fetch your Customer's list of available funding sources #
Use the list an Customer’s funding sources endpoint to fetch a list of your own funding sources. You’ll need the Customer URL which can be retrieved from the API.
Request and Response (view schema in raw)
GET https://api-sandbox.dwolla.com/customers/ad5f2162-404a-4c4c-994e-6ab6c3a13254/funding-sources
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer 0Sn0W6kzNicvoWhDbQcVSKLRUpGjIdlPSEYyrHqrDDoRnQwE7Q
{
"_links": {
"self": {
"href": "https://api-sandbox.dwolla.com/customers/ad5f2162-404a-4c4c-994e-6ab6c3a13254/funding-sources"
}
},
"_embedded": {
"funding-sources": [
{
"_links": {
"self": {
"href": "https://api-sandbox.dwolla.com/funding-sources/0094b1b4-e171-4dc8-865b-cb121c2377bb"
},
"customer": {
"href": "https://api-sandbox.dwolla.com/customers/ad5f2162-404a-4c4c-994e-6ab6c3a13254"
},
"with-available-balance": {
"href": "https://api-sandbox.dwolla.com/funding-sources/0094b1b4-e171-4dc8-865b-cb121c2377bb"
}
},
"id": "0094b1b4-e171-4dc8-865b-cb121c2377bb",
"status": "verified",
"type": "balance",
"name": "Balance",
"created": "2013-09-07T14:42:52.000Z"
},
{
"_links": {
"self": {
"href": "https://api-sandbox.dwolla.com/funding-sources/b5e68264-7d4d-42a9-88d4-5616c77c6baa"
},
"customer": {
"href": "https://api-sandbox.dwolla.com/customers/ad5f2162-404a-4c4c-994e-6ab6c3a13254"
}
},
"id": "b5e68264-7d4d-42a9-88d4-5616c77c6baa",
"status": "verified",
"type": "bank",
"name": "ABC Bank Checking",
"created": "2014-09-04T23:19:19.543Z"
}
]
}
}
When the list of funding sources is successfully retrieved, you will receive a 200 HTTP response with the details for the funding sources. After retrieving the funding sources, we recommend storing the full URL for future use as it will be referenced when creating the transfer to this user’s bank account.
Previous
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.