This endpoint can be used to facilitate the following use cases: Update Customer information, upgrade an unverified
Customer to a verified
Customer, suspend a Customer, deactivate a Customer, reactivate a Customer, and update a verified Customer's information to retry
verification.
POST https://api.dwolla.com/customers/{id}
A limited set of information can be updated on an existing created Customer. Note: A Customer's information cannot be updated when in a status of document
or suspended
.
NY
.50314
.3334447777
.In addition to the table above, business verified Customers can update the following fields.
https://www.domain.com
An unverified Customer can be upgraded to a verified Customer by supplying the necessary information required to create a verified Customer. Reference the create customer section for required information.
Unverified and Verified Customers can be suspended by specifying a status of suspended
in your request. You'll need to contact Dwolla to unsuspend a Customer.
suspended
.Customers can be deactivated by specifying a status of deactivated
in your request. A Customer cannot be deactivated if the Customer has a suspended
verification status. Customers can be systematically deactivated by Dwolla if certain ACH return codes are triggered on bank transfer failures.
deactivated
.Customers can be reactivated by specifying a status of reactivated
in your request. Reactivated Customers will be moved to the status they were in prior to being deactivated.
reactivated
.If the verified Customer has a status of retry
, some information may have been miskeyed. You have one more opportunity to correct any mistakes using this endpoint. This time, you’ll need to provide the Customer’s full SSN. If the additional attempt fails, the resulting status will be either document
or suspended
.
{
"_links": {
"deactivate": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "customer"
},
"self": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "customer"
},
"edit-form": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f",
"type": "application/vnd.dwolla.v1.hal+json; profile=\"https://github.com/dwolla/hal-forms\"",
"resource-type": "customer"
},
"edit": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "customer"
},
"funding-sources": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f/funding-sources",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "funding-source"
},
"retry-verification": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "customer"
},
"transfers": {
"href": "https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f/transfers",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "transfer"
}
},
"id": "53863b11-1758-47c8-821f-00e6a126f97f",
"firstName": "retry",
"lastName": "doe",
"email": "jdoe@nomail.com",
"type": "personal",
"status": "retry",
"created": "2017-11-06T20:11:13.430Z",
"address1": "99-99 33rd St",
"city": "Some City",
"state": "NY",
"postalCode": "11101"
}
This example goes through retry verification for a Personal Verified Customer.
var customerUrl =
"https://api-sandbox.dwolla.com/customers/53863b11-1758-47c8-821f-00e6a126f97f";
var requestBody = {
firstName: "John",
lastName: "Doe",
email: "johndoe@dwolla.com",
ipAddress: "10.10.10.10",
type: "personal",
address1: "221 Corrected Address St.",
address2: "Fl 8",
city: "Ridgewood",
state: "NY",
postalCode: "11385",
dateOfBirth: "1990-07-11",
ssn: "202-99-1516",
};
dwolla.post(customerUrl, requestBody).then((res) => res.body.id); // => '53863b11-1758-47c8-821f-00e6a126f97f'
{
"code": "InvalidResourceState",
"message": "Resource cannot be modified."
}
personal
or business
. If business, see above for additional required information.CA
.50314
.YYYY-MM-DD
format. Must be between 18 to 125 years of age.3334447777
.Use sandbox environment to test API requests.
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.