Dwolla Developers Logo
Back
API Reference
  • SDK Support
    Drop-in Components
    Authorization
    Root
    Accounts
    Customers
    Knowledge-based Authentication (KBA)
    Beneficial Owners
    Documents
    Funding Sources
    Transfers
    OverviewInitiate a transferRetrieve a transferList and search transfers for a customerList fees for a transferRetrieve a transfer failure reasonCancel a transferCreate an on-demand transfer authorization
    Mass payments
    Labels
    Events
    Webhook subscriptions
    Webhooks
CommunityOpen in new tabChangelog
Get API Keys
CommunityOpen in new tabChangelog
JavaScript
Get API Keys

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.

Info
If a transfer fails to/from a bank account then the bank will automatically be removed from the Dwolla system for all ACH return codes except R01, R09 and R20.

HTTP Request #

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

Request parameters #

ParameterRequiredTypeDescriptionidyesstringTransfer unique identifier.

Request and Response #

JavaScript
// 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.

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2022 All Rights Reserved

Dwolla

  • About
  • Blog
  • Pricing
  • Contact Sales
  • Terms of Service
  • Privacy Policy
Financial institutions play an important role in our network.

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.