Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ach.netevia.com/llms.txt

Use this file to discover all available pages before exploring further.

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
}