Use this method to fulfill (i.e. "pay") a money request from the user with the associated access token.
HTTP Method: POST
Scope Required: 'Send'
Requires Authentication: YES
https://www.dwolla.com/oauth/rest/requests/{request_id}/fulfill
Request
Response
(click Submit to query the API)
| |
Param |
Description |
| * |
oauth_token |
A valid OAuth token |
| * |
request_id |
The request ID to fulfill
|
| * |
pin |
User's PIN associated with their account
|
| * |
amount |
Amount to pay for the request. The amount specified here must be greater than the request amount, otherwise this call will fail.
|
|
notes |
Note to attach to the transaction. Limited to 250 characters.
|
|
fundsSource |
Id of funding source to send funds from. Balance sourced transfers process immediately. Non-balanced sourced transfers may process immediately or take up to five business days.
|
|
assumeCosts |
Set to true if the user will assume the Dwolla fee. Set to false if the destination user will assume the Dwolla fee. Does not affect facilitator fees.
|
POST https://www.dwolla.com/oauth/rest/requests/{request_id}/fulfill
Content-Type: application/json
{
"oauth_token": "",
"pin": "",
"amount": ""
}
| Param |
Description |
| Success |
Did the request succeed? |
| Message |
|
| Response |
JSON Object |
| Status |
Request status. Values: pending, paid, and cancelled. |
|
Show Response Parameters
|
{"Success":true,"Message":"Success","Response":{"Id":147659,"RequestId":999,"Amount":1,"SentDate":"9/21/2012 10:55:30 AM","ClearingDate":"9/21/2012 10:55:30 AM","Status":"processed","Source":{"Id":"812-693-9484","Name":"Michael Schonfeld","Type":"Dwolla","Image":null},"Destination":{"Id":"812-600-6705","Name":"Michael Schonfeld","Type":"Dwolla","Image":null}}}
| Literal String |
Explanation |
| "Invalid request ID." |
The specific request ID is either empty or invalid. |
| "Request not found for account." |
Could not find a request with the specified ID for the given OAuth token. |
| "Account can not pay their own request." |
Account can not pay their own request. |
| "Request has already been paid" |
Request has already been paid |
| "Amount may not be less than request amount of {0}" |
The fulfilled amount cannot be less than the requested amount. |
| "Notes length is too long. Maximum of 250 character is allowed." |
The 'notes' parameter is too long. See requests parameters for further details. |
| "Invalid funding source provided: {..}" |
The specified funding source is missing, empty, or invalid. |
| "Insufficient funds." |
The are not enough funds in the specified funding source to fulfill this transaction. |
| "Access token is empty." |
No OAuth access token has been supplied. |
| "Invalid access token." |
The OAuth access token supplied is invalid or incorrect. |
| "Token does not have access to requested resource. Token must have {...} scope access." |
The given OAuth token does not have access to the requested scope used. Please review the scopes list. |
| "Invalid account status for user of this access token." |
The account associated with the given OAuth token is in an invalid status. |
| "Application is either not verified or suspended." |
The application used to generate the OAuth token has been unverified or suspended. |
| "Account temporarily locked" |
Too many failed attempts have been made to access this account. The account has been temporarily locked for 30 minutes. |
| "Unexpected error has occurred." |
Something unexpected happened. It has been logged on our end and will be reviewed shortly. |
Literal strings returned in the API do no include the quotation marks used above.