Yes. There are 3 ways that you can include additional information with a transfer request in Dwolla. You can utilize the
metadata object with the transfer request, the
addenda object, or the
correlationId parameter (which can also be used as a search parameter on transfers). All parameters are optional fields in a transfer request, but can be used to attach additional information to a transfer resource. Note the Addenda feature is only applicable to Business to Business transfers and needs further approval from the Dwolla team to be enabled for a Master Account.
metadata - A metadata JSON object with a maximum of 10 key-value pairs (each key and value must be less than 255 characters).
correlationId - A string value attached to a customer which can be used for traceability between Dwolla and your application. Must be less than 255 characters and contain no spaces. Acceptable characters are:
. , and
_ . More information can be found in our Docs.
addenda - An addenda object contains a
values key which is an array of comma separated string addenda values. Addenda record information is used for the purpose of transmitting transfer-related information from a business. Transfers must be sent to/from a business entity’s bank to guarantee addenda delivery. Please find more details in our Docs regarding these features.
Here’s an example transfer request with all of the above parameters,
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
"note": "payment for completed work Dec. 1",
HTTP/1.1 201 Created
I’m afraid the webhook callback we deliver has a set payload and doesn’t include any of the above additional parameters. It’s recommended to store information on the actual resource itself within a metadata or correlationId field. When you receive the webhook, you’d then call the Dwolla API to obtain information that you passed into those fields.
Whenever a transfer is created and has exported on our ACH file, the transfer resource is assigned a unique individualAchId. This ID will also appear in the bank line alongside the transfer. This field can be used to reconcile bank statements. However, this won’t correspond with the Receipt# on your end. You may be able use the addenda feature to pass you Receipt# as an addendum with the transfer, and the number will appear in the bank line, given that the bank belongs to a Business. It’s ultimately up to the individual Financial Institution on whether or not they choose to display information passed in the Addenda record field.
Hope that helps. Let me know if you have any questions!