Retrieve a transfer failure reason #

When a bank or VAN transfer fails for an Account or Customer, Dwolla returns a failure link when retrieving the transfer by its Id. This failure link is used to retrieve the ACH return code and description. For reference, the list of possible failure codes and descriptions are shown in the Transfer failures resource article.

HTTP Request #

GET https://api.dwolla.com/transfers/{id}/failure

Request parameters #

Request and Response #

// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var transferUrl =
  "https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388";

dwolla.get(`${transferUrl}/failure`).then((res) => res.body.code); // => 'R01'

Note that for VANs, additional details about the external transaction will be available in an achDetails JSON object in the transfer GET response. Either the source or the destination will be present in the object depending on the direction of money movement.