Update a customer - Retry verification - verified business customer - corporation,llc, or partnership
POST https://api-sandbox.dwolla.com/customers
A retry
status occurs when a Customer’s identity scores are too low during the initial verification attempt. Dwolla will require the full 9-digits of the Controller’s SSN on the retry attempt in order to give our identity vendor more information in an attempt to receive a sufficient score to approve the Customer account. The Customer will have one more opportunity to correct any mistakes.
Resources
Article - Customer verification
Request parameters
Parameter | Required | Type | Description |
---|
firstName | yes | string | The legal first name of the Account Admin or individual signing up the business verified Customer. |
lastName | yes | string | The legal last name of the Account Admin or individual signing up the business verified Customer. |
email | yes | string | Email address of the Account Admin creating and managing the Customer account. |
ipAddress | no | string | ipAddress of registering user is recommended. |
type | yes | string | Value of: business |
address1 | yes | string | Street number, street name of business’ physical address. |
address2 | no | string | Apartment, floor, suite, bldg. # of business’ physical address |
city | yes | string | City of business’ physical address. |
state | yes | string | Two-letter US state or territory abbreviation code of business’ physical address. For two-letter abbreviation reference, check out the US Postal Service guide. |
postalCode | yes | string | Business’ US five-digit ZIP or ZIP + 4 code. |
businessName | yes | string | Registered business name. |
doingBusinessAs | no | string | Preferred business name -- also known as fictitious name, or assumed name. |
businessType | yes | string | Business structure. Possible values are corporation , llc , partnership . |
businessClassification | yes | string | The industry classification Id that corresponds to Customer’s business. Reference our Dev Docs to learn how to generate this Id. |
ein | yes | string | Employer Identification Number. Note: If the businessType is soleProprietorship , then ein and controller can be omitted from the request. |
website | no | string | Business’ website |
phone | no | string | Business's 10 digit phone number. No hyphens or other separators, e.g. 3334447777. |
controller | conditional | object | A controller JSON object. Controllers are not required if businessType is soleProprietorship |
Controller JSON object
Parameter | Required | Type | Description |
---|
firstName | yes | string | The legal first name of the controller. |
lastName | yes | string | The legal last name of the controller. |
title | yes | string | Job title of the Customer’s Controller. e.g. Chief Financial Officer |
dateOfBirth | yes | string | The date of birth of the controller. Formatted in YYYY-MM-DD format. Must be 18 years or older. |
ssn | conditional | string | Full nine digits of Controller’s social security number. Required for Controllers who reside in the United States. |
address | yes | object | A controller address JSON object. Full address of the controller's physical address. See below |
passport | conditional | object | An optional controller's passport JSON object. Required for non-US individuals. Includes passport identification number and country. See below |
Controller address JSON object
Parameter | Required | Type | Description |
---|
address1 | yes | string | Street number, street name of Controller’s physical address. |
address2 | no | string | Apartment, floor, suite, bldg. # of Controller’s physical address. |
address3 | no | string | Third line of the street address of the Controller's physical address. |
city | yes | string | City of Controller’s physical address. |
stateProvinceRegion | yes | string | Two-letter US state or territory abbreviation code of controller’s physical address. For two-letter abbreviation reference, check out the US Postal Service guide. |
postalCode | no | string | Controller’s’ US five-digit ZIP or ZIP + 4 code. |
country | yes | string | Country of controller's physical address. Two digit ISO code, e.g. US . |
Controller passport JSON object
Parameter | Required | Type | Description |
---|
number | conditional | string | Required for a non-U.S. person who has no Social Security number. |
country | conditional | string | Country of issued passport. Two digit ISO code, e.g. US . |
Request Body
{"firstName"=>"Account", "lastName"=>"Admin", "email"=>"accountAdmin@email.com", "ipAddress"=>"143.156.7.8", "type"=>"business", "address1"=>"99-99 33rd St", "city"=>"Some City", "state"=>"NY", "postalCode"=>"11101", "controller"=>{"firstName"=>"John", "lastName"=>"Controller", "title"=>"CEO", "ssn"=>"123456789", "dateOfBirth"=>"1980-01-31", "address"=>{"address1"=>"1749 18th st", "address2"=>"apt 12", "city"=>"Des Moines", "stateProvinceRegion"=>"IA", "postalCode"=>"50266", "country"=>"US"}}, "businessClassification"=>"9ed3f670-7d6f-11e3-b1ce-5404a6144203", "businessType"=>"llc", "businessName"=>"Jane Corp", "ein"=>"00-0000000"}
Key | Datatype | Required | Description |
---|
Accept | string | | |
Content-Type | string | | |
Authorization | string | | |