A webhook is a means of notifying your application of the occurrence of an event with some relevant information. Events are created each time a resource is created or updated in Dwolla. For example, when an External Party is created or a Funding Source is removed, a external_party:created
and external_party.funding_source:removed
event will be created, respectively. These events are what trigger HTTP webhook requests to your subscribed URL if you have an active webhook subscription.
Each webhook contains an Event with _links
to the following resources:
Example webhook payload:
{
"_links": {
"account": {
"href": "https://api-sandbox.dwolla.com/accounts/3b0f270c-9cfd-4724-bae8-aa4b1659cbb1"
},
"resource": {
"href": "https://api-sandbox.dwolla.com/transfers/d75a1882-a051-4c92-9631-bfe0b252a24e"
},
"self": {
"href": "https://api-sandbox.dwolla.com/events/021e2d1b-a71e-496e-8e5f-0c7bceac21c5"
}
},
"created": "2023-09-27T15:44:30.152Z",
"id": "021e2d1b-a71e-496e-8e5f-0c7bceac21c5",
"resourceId": "d75a1882-a051-4c92-9631-bfe0b252a24e",
"topic": "account.transfer:created"
}
In this guide we will walk through creating a webhook subscription along with validating and processing webhook requests.
You will need to have a Sandbox account already set up. Although not required, this guide assumes that you have some familiarity with Amazon Web Services (AWS); specifically Lambda and SQS, or other similar services.
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.