Dwolla

API / Requests - Request

Request Money

Use this method to request funds from a source user, originating from the user associated with the authorized access token.

HTTP Method: POST Scope Required: 'Request'   Requires Authentication: YES

URL

https://www.dwolla.com/oauth/rest/requests/

Tools

  Parameter Description Value
* oauth_token A valid OAuth token
* sourceId Identification of the user to request funds from. Must be the Dwolla identifier, Facebook identifier, Twitter screename, phone number, or email address.
* amount Amount of funds to request from the source user.
sourceType Type of source user.
facilitatorAmount Amount of the facilitator fee to override. Only applicable if the facilitator fee feature is enabled. If set to 0, facilitator fee is disabled for transaction. Cannot exceed 50% of the 'amount'.
notes Note to attach to the request. Limited to 250 characters.
senderAssumeCosts Set to true if the fulfilling user (the user who will send the money) will assume the Dwolla fee. Set to false if the destination user will assume the Dwolla fee. Does not affect facilitator fees.
senderAssumeAdditionalFees Set to true if the fulfilling user (the user who will send the money) will assume all Facilitator fees. Set to false if the destination user will assume all Facilitator fees. Does not affect the Dwolla fee.
additionalFees Array of Additional facilitator fees    Add another

Request



    

Response

(click Submit to query the API)
Grab our official library »

	

Request

  Param Description
* oauth_token A valid OAuth token  
* sourceId Identification of the user to request funds from. Must be the Dwolla identifier, Facebook identifier, Twitter screename, phone number, or email address.
* amount Amount of funds to request from the source user.

Note: must be a number. Currency symbols and non-numeric characters are rejected.

sourceType Type of source user.

Possible values: 'Dwolla', 'Email', 'Phone'

Defaults to: 'Dwolla'

facilitatorAmount Amount of the facilitator fee to override. Only applicable if the facilitator fee feature is enabled. If set to 0, facilitator fee is disabled for transaction. Cannot exceed 50% of the 'amount'.
notes Note to attach to the request. Limited to 250 characters.
senderAssumeCosts Set to true if the fulfilling user (the user who will send the money) will assume the Dwolla fee. Set to false if the destination user will assume the Dwolla fee. Does not affect facilitator fees.

Defaults to: 'false'

senderAssumeAdditionalFees Set to true if the fulfilling user (the user who will send the money) will assume all Facilitator fees. Set to false if the destination user will assume all Facilitator fees. Does not affect the Dwolla fee.

Defaults to: 'false'

additionalFees Array of Additional facilitator fees
destinationId Facilitator's Dwolla ID
amount Facilitator Amount
POST https://www.dwolla.com/oauth/rest/requests/
Content-Type: application/json



{
    
    "oauth_token": "",

    "sourceId": "",
    "amount": ""
}

Response

Param Description
Success Did the request succeed?
Message
Response JSON Object
   Show Response Parameters
{"Success":true,"Message":"Success","Response":996}

Error Codes