With this request, you can update the KYB information for an existing onboarded business. You will need to provide all KYB-related details using this API and ensure that the business’s KYB status is either null or Failed.

This route is secured with processor and vendor token authentication.

​
Endpoint

PUT   /3p/api/v2/users/{uuid}/kyb

 

​
Example

{
  "first_name": "Jack",
  "last_name": "Jones",
  "email": "[email protected]",
  "phone": "2457856494",
  "business": {
    "name": "Jack Inc.",
    "tin": "958455211",
    "trading_name": "Jack Corp.",
    "entity_type": "Sole Trader",
    "incorporation_date": "2024-03-01",
    "incorporation_state": "CO",
    "address_type": "Registered",
    "address": {
      "line_1": "10554",
      "city": "spaces",
      "state": "CA",
      "zip": "80127"
    }
  }
}

​
Body Parameters

FieldsTypeIs RequiredDescription
first_namestringYesMax characters: 56 Only accepts letters (a-z, A-Z, À-ÿ), numbers (0-9), hyphens (-), periods (.), apostrophes (’), and spaces.
last_namestringYesMax characters: 56 Only accepts letters (a-z, A-Z, À-ÿ), numbers (0-9), hyphens (-), periods (.), apostrophes (’), and spaces.
emailstringYes
phonestringYeswithout prefix +1 for eg. 2092370450
business.namestringYesLegal name of the business Max characters: 64 Only accepts letters (a-z, A-Z), numbers (0-9), ampersand(&), hyphens (-), periods (.), apostrophes (’), comma(,), plus (+) and spaces.
business.tinstringYesmust consist of 9 digit without any special character
business.trading_namestringYesTrading name of the business
business.entity_typestringYesBusiness entity type. For eg. Sole Trader, Limited Company etc.
business.incorporation_datedate:Y-m-dYesDate when the company was incorporated
business.incorporation_statestring(2)YesState where the company was incorporated (US only)
business.industrystringNoNature of business
business.industry_classification.code_typestringType of industry classification code. eg. SIC etc. Required if industry_classification exists
business.industry_classification.codesarray stringIndustry classification codes Required if industry_classification exists
business.industry_classification.descriptionstringDescription of the industry classification code Required if industry_classification exists
business.source_of_wealthstringNoSource of wealth of the company
business.source_of_fundsstringNoSource of initial deposit of the company
business.first_transaction_completed_atdatetime:Y-m-d H:i:sNoOriginal timestamp of when the person completed their first transaction
business.product_typestringNo
business.registered_as_inactivebooleanNo
business.address_typestringYesType of address. For eg. Registered, Trading, Legal etc.
business.address.line_1stringYes
business.address.citystringYes
business.address.statestring(2)Yes
business.address.zipstringYesmust consist of 5 digit without any special character

​
Response

{
    "status": true,
    "message": "The business KYB has been updated.",
    "data": null,
    "errors": null,
    "error_code": null
}