KYC Flow (Unity SDK)

The KYC flow enables users to provide information and documents to verify identity. Upon submission, users' information will immediately be processed.

They will see a success screen detailing whether their application was approved or whether human review is required. Any updates or further requests for information will happen via email exchange with Tilia’s Compliance Team.

Unity KYC

Prerequisites

The KYC flow requires only an Authorized User Password Token (A User Password Token is a string that enables Tilia Pay to verify that a request belongs to an authorized session).

note

All methods and flows in the Tilia SDK require you to have a server setup that communicates with Tilia’s APIs (your server will have a private api key which needs to remain secure and should never be exposed to client-side applications). Your client application should communicate with your own api (ensuring user authentication) to retrieve data required by the Tilia SDK.

Server-Side Code Example to Retrieve User Access Token

Requires your server to retrieve a client credentials access token. See more here .
Requires an account id for a user that has been registered with Tilia. See more here .

Copy

Copied

curl -i -X POST \
  https://auth.staging.tilia-inc.com/authorize/user \
  -H 'Authorization: Bearer <CLIENT_CREDENTIALS_ACCESS_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "<USER_ACCOUNT_ID_HERE>",
    "return_token": true,
  }'

Example Responce Payload

Copy

Copied

{
    "status": "Success",
    "message": [],
    "codes": [],
    "payload": {
        "token": {
            "access_token": "USER_PASSWORD_TOKEN",
            "token_type": "Bearer",
            "refresh_token": "REFRESH_TOKEN",
            "expiry": "TOKEN_EXPIRATION"
        }
    }
}

C# Code Example

These code snippets are an example of how to execute the KYC Flow from inside your own code.

These example assumes that your code contains a variable called TiliaManager that is a valid reference to a TiliaUIManager class that is active in your Unity scene (part of the standard Tilia Canvas Group).
TiliaUIMessages.Message is a static function that assumes you have the TiliaUIMessages class active in your Unity scene (part of the standard Tilia Canvas Group).

Copy

Copied

public void DoKYCFlow()
{
    TiliaManager.KYCFlow((result) =>
    {
        // Completed
        // result is a TiliaEvent class
		// result.Data is the KYC application ID
        // result.Payload is a TiliaKYCApplication class object containing all of the details of the successfully submitted application
        TiliaUIMessages.Message("The user submitted their KYC application.");
    },
    (result) => {
        // Canceled
        // result is a TiliaEvent class
        TiliaUIMessages.Message("The user canceled the KYC flow.");
    },
    (result) => {
        // Error
		// result is a TiliaEvent class
        // result.Payload is an object of TiliaResponse type which includes API error data such as the web server response code and any API specific messages.
        TiliaUIMessages.Message("There was an error while attempting to execute KYC flow.");
    });
}