Create a transfer - Facilitator Fees

POST https://api-sandbox.dwolla.com/transfers

Initiate a transfer for either an Account or Customer resource.

Request parameters

ParameterData TypeParameter TypeOptional?Description
_linksyesobjectA _links JSON object describing the desired source and destination of a transfer. Reference the Source and Destination object to learn more about possible values for source and destination.
amountyesobjectAn amount JSON object. Reference the amount JSON object to learn more.
metadatanoobjectA metadata JSON object with a maximum of 10 key-value pairs (each key and value must be less than 255 characters).
feesnoarrayAn array of fee JSON objects that contain unique fee transfers. Reference the facilitator fee JSON object to learn more.
clearingnoobjectA clearing JSON object that contains source and destination keys to expedite or slow down a transfer. Reference the clearing JSON object to learn more.
achDetailsnoobjectAn ACH details JSON object which represents additional information sent along with a transfer to an originating or receiving financial institution. Details within this object can be used to reference a transaction that has settled with a financial institution. Reference the achDetails JSON object to learn more
correlationIdnostringA unique string value attached to a transfer which can be used for traceability between Dwolla and your application.
Must be less than 255 characters and contain no spaces.
Acceptable characters are: a-Z, 0-9, -, ., and _.

Source and destination types

Source TypeURIDescription
Funding sourcehttps://api.dwolla.com/funding-sources/{id}A bank or balance funding source.
Destination TypeURIDescription
Funding sourcehttps://api.dwolla.com/funding-sources/{id}Destination of an Account or verified Customer's own bank or balance funding source. OR A Customer's bank funding source.

Request Body

{"_links"=>{"source"=>{"href"=>"https://api-sandbox.dwolla.com/funding-sources/{{sourceFundingSourceId}}"}, "destination"=>{"href"=>"https://api-sandbox.dwolla.com/funding-sources/{{destinationFundingSourceId}}"}}, "amount"=>{"currency"=>"USD", "value"=>"10.00"}, "fees"=>[{"_links"=>{"charge-to"=>{"href"=>"https://api-sandbox.dwolla.com/customers/{{customerId}}"}}, "amount"=>{"value"=>"2.00", "currency"=>"USD"}}]}

HEADERS

KeyDatatypeRequiredDescription
Acceptstring
Authorizationstring
Content-Typestring
Idempotency-Keystring