Company Onboarding

addKybInformation

Know Your Business (KYB) Process

Endpoint allows to add the information required for Know Your Business (“KYB”) process. The aim is to verify business information with official records.

Employer Identification Number (EIN)

Definition: An EIN, also known as a Federal Tax Identification Number, is a unique nine-digit number.
Purpose: It’s assigned by the Internal Revenue Service (IRS) to business entities operating in the United States for the purposes of identification.

Entity Type: Importance in Payroll

Role: The entity type helps determine taxation and reporting requirements.
Why It Matters: Different types of business entities have different payroll needs and obligations. Knowing the entity type ensures accurate and compliant payroll processing.

POST

companyOnboarding#addKybInformation

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/companyOnboarding#addKybInformation' \
  --header 'Content-Type: application/json' \
  --data '{
  "method": "addKybInformation",
  "kybInformation": {
    "companyId": "8b77ce43-4596-4af7-bf1b-3bfc946ad5e4",
    "ein": "899991112",
    "entityType": "LLP",
    "dateOfIncorporation": "2023-02-25"
  }
}'

{
  "1": {
    "summary": "Success",
    "value": {
      "kybInformation": {
        "kybInformationId": "44BF4454-FFCB-42BA-8918-E7A820E6497E",
        "status": "KYB Verification Pending",
        "message": "The KYB information for wil food has been saved successfully."
      }
    }
  }
}

Body

application/json

method

string

default: addKybInformationrequired

kybInformation

object

required

Response

200 - application/json