Onboarding

Onboarding refers to the process of bringing a new merchant or business onto a payment processing platform or network. It typically involves gathering information about the merchant such as Business name, Client type, Entity type, Address, Bank details and so on. With the help of onboarding , we can conclude whether the merchants are legitimate, financially stable, and pose an acceptable level of risk to the payment platform. Only the Mandatory fields are provided in the sample post parameters , Rest of the fields in the sample post parameters will be provided in the relevant menu ( KYC , Web Crawling , AML , NDI )

Onboarding

POST https://secctrl.tutelar.io/api/v1/onboarding-protect/create

Post parameters description is given below

Parameter
Type
Is Mandatory
Description

merchant_ref_id

String

Yes

It should be unique. It helps to identify the new merchant that comes from which client.

source_from

String

Yes

It can contain one of the following values: APP, DIRECT, WEBSITE, or RESELLER.

reseller_ref_id

String

Optional

If source_from is RESELLER, then reseller_ref_id is mandatory.

email

String

Yes

phone

String

Yes

business

Object

Optional Except (name and address)

If field verification is purchased, address field is mandatory

business.deliveryMode

String

Optional

Delivery mode for the business. Allowed values are: • onlineoffline

business.authorized

Array of Objects

Optional

List of authorized individuals associated with the business (e.g., signatories, directors, ).

business.authorized[].name

String

Optional

Full name of the authorized individual (Signatory/Director). Must be alphabetic and valid.

business.authorized[].authorizer_type

String

Optional

Type of authorization for the person. Must be one of the following: • signatory – Individual authorized to sign documents • director – Individual who serves as a director • signatory_director – Individual who is both Signatory and Director mandatory if the signatory/director name is provided.

business.authorized[].panNumber

String

Optional

PAN number of the authorized individual (Signatory/Director). Must be a valid 10-character alphanumeric value and is mandatory if the signatory/director name is provided.

business.authorized[].dateOfBirth

String

Optional

Date of birth of the authorized individual (Signatory/Director). Must be a valid date in DD-MM-YYYY format.

business.authorized[].fathersName

String

Optional

Father’s name of the authorized individual (Signatory/Director). Must contain valid alphabetic characters.

business.authorized[].address

String

Optional

Residential address of the authorized individual (Signatory/Director).

business.authorized[].kycType

Object

Optional

Must be selected from the supported document types:

  • Voter ID (ind_voter_id)

  • Aadhaar Card (ind_aadhaar)

  • Driving License (ind_driving_license)

  • Passport (ind_passport)

business.authorized[].kycNumber

String

Optional

Unique identification number from the selected KYC type

client_type

Object

Yes

entity_type

Object

Yes

mcc

Object

Yes

contactPerson.name

String

Optional

Name of the contact person (CPV Name). Must be alphabetic, properly formatted, and not exceed 100 characters.

contactPerson.mobileNumber

String

Optional

Contact person's mobile number. Must be a valid mobile format as per system validation rules

is_field_verify

Object

Optional

Sample Post Parameters

Last updated