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

ParameterRequiredTypeDescription
firstNameyesstringThe legal first name of the Account Admin or individual signing up the business verified Customer.
lastNameyesstringThe legal last name of the Account Admin or individual signing up the business verified Customer.
emailyesstringEmail address of the Account Admin creating and managing the Customer account.
ipAddressnostringipAddress of registering user is recommended.
typeyesstringValue of: business
address1yesstringStreet number, street name of business’ physical address.
address2nostringApartment, floor, suite, bldg. # of business’ physical address
cityyesstringCity of business’ physical address.
stateyesstringTwo-letter US state or territory abbreviation code of business’ physical address. For two-letter abbreviation reference, check out the US Postal Service guide.
postalCodeyesstringBusiness’ US five-digit ZIP or ZIP + 4 code.
businessNameyesstringRegistered business name.
doingBusinessAsnostringPreferred business name -- also known as fictitious name, or assumed name.
businessTypeyesstringBusiness structure. Possible values are corporation, llc, partnership.
businessClassificationyesstringThe industry classification Id that corresponds to Customer’s business. Reference our Dev Docs to learn how to generate this Id.
einyesstringEmployer Identification Number. Note: If the businessType is soleProprietorship, then ein and controller can be omitted from the request.
websitenostringBusiness’ website
phonenostringBusiness's 10 digit phone number. No hyphens or other separators, e.g. 3334447777.
controllerconditionalobjectA controller JSON object. Controllers are not required if businessType is soleProprietorship

Controller JSON object

ParameterRequiredTypeDescription
firstNameyesstringThe legal first name of the controller.
lastNameyesstringThe legal last name of the controller.
titleyesstringJob title of the Customer’s Controller. e.g. Chief Financial Officer
dateOfBirthyesstringThe date of birth of the controller. Formatted in YYYY-MM-DD format. Must be 18 years or older.
ssnconditionalstringFull nine digits of Controller’s social security number. Required for Controllers who reside in the United States.
addressyesobjectA controller address JSON object. Full address of the controller's physical address. See below
passportconditionalobjectAn optional controller's passport JSON object. Required for non-US individuals. Includes passport identification number and country. See below

Controller address JSON object

ParameterRequiredTypeDescription
address1yesstringStreet number, street name of Controller’s physical address.
address2nostringApartment, floor, suite, bldg. # of Controller’s physical address.
address3nostringThird line of the street address of the Controller's physical address.
cityyesstringCity of Controller’s physical address.
stateProvinceRegionyesstringTwo-letter US state or territory abbreviation code of controller’s physical address. For two-letter abbreviation reference, check out the US Postal Service guide.
postalCodenostringController’s’ US five-digit ZIP or ZIP + 4 code.
countryyesstringCountry of controller's physical address. Two digit ISO code, e.g. US.

Controller passport JSON object

ParameterRequiredTypeDescription
numberconditionalstringRequired for a non-U.S. person who has no Social Security number.
countryconditionalstringCountry 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"}

HEADERS

KeyDatatypeRequiredDescription
Acceptstring
Content-Typestring
Authorizationstring