Language

Operational Notifications

When using Dwolla’s white-label API, your application is responsible for all interactions to your end users. You decide how to customize the payments experience end-to-end, which includes taking on the required delivery of notifications to end users for their account and payment activity. By default, Dwolla provides functionality via Operational Notifications and sends email notifications to your end users on your behalf. When actions occur within the Dwolla Network on a resource (Customers, Transfers, etc.), events are created to record those changes. Dwolla systematically delivers an email using the email address tied to the creation of a Customer when an applicable event occurs.

Operational Notification Events

Email notifications are sent to your end users when they complete the activities focused on the following key functions in your application (powered by the Dwolla Platform) or via the Dwolla Dashboard:

  • Customer creation
  • Bank account management and validation
  • Money added to a balance
  • Money withdrawn from a balance
  • Money sent to another end user (or your company)
  • Money received from another end user (or your company)
  • Customer verification and suspension

A full list of events are listed below. Please review to ensure you know when your users will receive notifications via Operational Notifications. In addition to the email notifications listed in this article, further communications, per Dwolla’s requirements and your own application’s functionality, will need to be sent by you to your end users. Please contact your Integration Manager with questions specific to your integration and recommended (or required) emails.

Customization

When configuring Operational Notifications, there are several items that can be customized to your business. Below is a list of the items that you can currently customize:

ItemRequired?Description
Account NameYesThe name that will display in the From section, defaults to the name on your Dwolla account or specified DBA name.
Example: Your Business Name
From Email AddressYesThe email address that will display in the [From] address, only the local-part can be customized.
Example: yourbusinessname@dwolla.com
Reply-to Email AddressYesThe email address your company will specify to receive replies.
Example: support@yourbusinessname.com
LogoNoThe branded image for your company, to be displayed at the top of the email content. The upload file format must be: .jpg, .png, or .gif. The max file size is 10 MB. The recommended width is 135 pixels.
Logo LinkNoThe link that when the logo is clicked on, will redirect the receiver.
Example: www.yourbusinessname.com
Support AddressYesThe physical address that will display in the email footer, defaulted to the address on the account.
Example: 123 Main Street, Des Moines, IA 50309
Support phoneConditionalAn optional item. Required if a Support email isn’t provided. The phone number that will show up in the support section, defaulted to the account phone number.
Example: "If you have any questions or concerns please contact support at 555-555-5555."
Support Email AddressConditionalAn optional item. Required if a Support phone isn’t provided. The email address that will show up in the support section, optional and defaults to the account email address.
Example: "If you have any questions or concerns please contact support at support@yourbusinessname.com."

Example Email Template

An example email template is shown below for a payment initiated email. At the present time, only the information listed in the customization section can be edited. Emails are viewable within the Dwolla Dashboard upon delivery attempt to your customers.

List of Emails by Type

Dwolla will systematically deliver emails for a subset of events existing in the API. As API enhancements are made, Dwolla may add new emails at any point in the future.

Customer account Emails

Customers
Email Topic NameEmail Subject and Body
customer_created

Subject: Account Created

customer_verified

Subject: Account Verified

customer_suspended

Subject: Account Suspended

customer_verification_document_needed

Subject: Verification Document Required

customer_verification_document_uploaded

Subject: Verification Document Uploaded

customer_verification_document_approved

Subject: Verification Document Approved

customer_verification_document_failed

Subject: Verification Document Failed

customer_reverification_needed

Subject: Verification Required

Funding Sources
Email Topic NameEmail Subject and Body
customer_funding_source_added

Subject: Funding Source Added

customer_funding_source_verified

Subject: Funding Source Verified

customer_funding_source_removed

Subject: Funding Source Removed

customer_microdeposits_added

Subject: Micro-deposits Initiated

customer_microdeposits_completed

Subject: Micro-deposits Completed

customer_microdeposits_failed

Subject: Micro-deposits Failed

Transfers
Email Topic NameEmail Subject and Body
customer_money_sent

Subject: Payment Initiated

customer_money_sent_failed

Subject: Payment Unsuccessful

customer_money_sent_cancelled

Subject: Payment Cancelled

customer_money_received

Subject: Payment Pending

customer_money_received_completed

Subject: Payment Successful

customer_money_received_cancelled

Subject: Payment Cancelled

customer_money_received_failed

Subject: Payment Unsuccessful

customer_money_added

Subject: Money Added

customer_money_add_completed

Subject: Add to Balance Completed

customer_money_add_cancelled

Subject: Add to Balance Cancelled

customer_money_add_failed

Subject: Add to Balance Failed

customer_money_withdrawn

Subject: Money Withdrawn

customer_money_withdrawal_cancelled

Subject: Withdrawal Cancelled

customer_money_withdrawal_failed

Subject: Withdrawal Failure


Status
Production: Operational

Financial institutions play an important role in the Dwolla network.

Dwolla, Inc. is an agent of Veridian Credit Union and all funds associated with your account in our network are held in one or more pooled accounts at Veridian Credit Union. These funds may not be eligible for share insurance by the National Credit Union Share Insurance Fund. Dwolla, Inc. is the operator of a software platform that communicates user instructions for funds transfers to Veridian Credit Union.