Onboarding

Onboarding is a web flow offered by CAF to obtain data and documents of people or companies, providing agility and simplicity in onboarding new users. The product was designed to fit different types of registration. Therefore, the flow/steps and layout can be fully customised according to the customer's preference. In addition, we allow the creation of unlimited onboarding templates so that they can be used for different purposes.

The end user needing to be verified will start the onboarding steps directly on CAF hosted webpage which is presented to them through a client redirect URL or alternatively via email or SMS (with the CAF registration link). When all the defined registration steps have been completed by the user, a transaction is automatically initiated with the data obtained, and call back response with the result data shall be sent to your pre-configured webhook.

Each onboarding link can be created by the API or the CAF TRUST Platform with association to an onboarding template and pre-configured service query model.

Create Web Onboarding link

Submission of the necessary person or company data and the template model against which the verification services shall be executed, as well as the set of rules to be validated.

POSThttps://api.combateafraude.com/v1/onboardings

Query parameters

Header parameters

Body

application/json

type*enum

Type of onboarding. Possible values are PF, PJ or PF_PF.

Example: "PF"

PFPJPF_PF

transactionTemplateId*string

ID of the Query Template (configured in Trust Platform).

Example: "62b620ee3f07fb0009361111"

templateIdstring

The ID of the onboarding template that will be used, If the value is not provided then the onboarding template already associated with the given Query Template in Trust Platform will be used otherwise CAF default onboarding template shall be the fallback.

Example: "6388ac6b409eff000804dadf"

transactionPFTemplateIdstring

ID of the Query Template to be used in onboarding the related persons. Exclusive and required attribute for type PF_PF.

transactionQsaTemplateIdstring

ID of the Query Template to be used for onboarding company partners. Exclusive and required attribute for type PJ.

emailstring (email)

The email address that the onboarding web link will be sent to.

Example: "[email protected]"

smsPhoneNumberstring

The cell phone number to which the link from the Onboarding Web will be sent, we must use the format: [country code][number including area code] *The SMS service will be charged according to the number of sends in the billing month

Example: "5551999999999"

noExpireboolean

Set whether the weblink URL generated for the onboarding can be used only once or multiple times. When the value is set to true, the link will accept multiple registrations. By default, this is set to false.

Example: true

noNotificationboolean

Optional field, which avoids triggering an email or sms. Recommended if you use our web onb. inside an iFrame or WebView. By default, this is set to false.

Example: false

variablesobject

Additional information can be sent to the onboarding template for prefilling. There is a limit of 20 attributes and "token" variable is reserved for internal use.

metadataobject

Additional information can be sent to the onboarding.

_callbackUrlstring

Callback URL (webhook).

attributesobject

Additional information that can be submitted with the onboarding link.

Response

200400401500

Success

Body

application/json

requestIdstring

Unique identifier of request.

Example: "6cb8093c-14ef-4fd1-810b-ee9fa5f9aae9"

idstring

Unique identifier of created onboarding link.

Example: "6021a21b3811c35ecb8dea20"

tokenstring

Token of created onboarding link.

Example: "0a8fb7b1c3eec7919967eXXXXXXXXXX"

urlstring

URL link to access onboarding.

Example: "https://link-onbording?token=0a8fb7b1c3eec7919967eXXXXXXXXXX"

Request

JavaScriptCurlPython

const response = await fetch('https://api.combateafraude.com/v1/onboardings?origin=text', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "type": "PF",
      "transactionTemplateId": "62b620ee3f07fb0009361111"
    }),
});
const data = await response.json();

Response

200400401500

{
  "requestId": "6cb8093c-14ef-4fd1-810b-ee9fa5f9aae9",
  "id": "6021a21b3811c35ecb8dea20",
  "token": "0a8fb7b1c3eec7919967eXXXXXXXXXX",
  "url": "https://link-onbording?token=0a8fb7b1c3eec7919967eXXXXXXXXXX"
}