Transfers
Retrieve a transfer failure reason
Retrieve detailed failure information for a failed bank or VAN transfer including the ACH return code, description, and explanation. Returns failure details with links to the failed funding source and associated Customer for comprehensive error analysis. Available only for transfers with failure status and accessed through the failure link from transfer retrieval. Critical for troubleshooting payment failures and understanding ACH return reasons.
GET
/
transfers
/
{id}
/
failure
cURL
GET https://api-sandbox.dwolla.com/transfers/8997ebed-69be-e611-80ea-0aa34a9b2388/failure
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY// 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'
# Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python
transfer_url = 'https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388'
failure = app_token.get('%s/failure' % transfer_url)
failure.body['code'] # => 'R01'
<?php
// Using dwollaswagger - https://github.com/Dwolla/dwolla-swagger-php
$transferUrl = 'https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388';
$transfersApi = new DwollaSwagger\TransfersApi($apiClient);
$transferFailure = $transfersApi->failureById($transferUrl);
$transferFailure->code; # => "R01"
?>
# Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby
transfer_url = 'https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388'
failure = app_token.get "#{transfer_url}/failure"
failure.code # => "R01"
{
"code": "R03",
"description": "No Account/Unable to Locate Account",
"_links": {},
"explanation": "The account number does not correspond to the individual identified in the entry or a valid account."
}{
"code": "Forbidden",
"message": "The supplied credentials are not authorized for this resource."
}{
"code": "NotFound",
"message": "The requested resource was not found."
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
FlowClient Credentials
- Token URL
- /token
Headers
The media type of the response. Must be application/vnd.dwolla.v1.hal+json
Available options:
application/vnd.dwolla.v1.hal+json Path Parameters
Transfer unique identifier
Was this page helpful?
⌘I
cURL
GET https://api-sandbox.dwolla.com/transfers/8997ebed-69be-e611-80ea-0aa34a9b2388/failure
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY// 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'
# Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python
transfer_url = 'https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388'
failure = app_token.get('%s/failure' % transfer_url)
failure.body['code'] # => 'R01'
<?php
// Using dwollaswagger - https://github.com/Dwolla/dwolla-swagger-php
$transferUrl = 'https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388';
$transfersApi = new DwollaSwagger\TransfersApi($apiClient);
$transferFailure = $transfersApi->failureById($transferUrl);
$transferFailure->code; # => "R01"
?>
# Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby
transfer_url = 'https://api-sandbox.dwolla.com/transfers/83eb4b5e-a5d9-e511-80de-0aa34a9b2388'
failure = app_token.get "#{transfer_url}/failure"
failure.code # => "R01"
{
"code": "R03",
"description": "No Account/Unable to Locate Account",
"_links": {},
"explanation": "The account number does not correspond to the individual identified in the entry or a valid account."
}{
"code": "Forbidden",
"message": "The supplied credentials are not authorized for this resource."
}{
"code": "NotFound",
"message": "The requested resource was not found."
}