Skip to main content

How to Use Securitize’s KYC Services

  • Updated

This guide will walk you through how to use Securitize’s KYC (Know Your Customer) services in your platform. We’ll cover each step to help you integrate the KYC process smoothly and make sure your investors can complete their verification successfully. 🚀

📋 Overview of the KYC Process

Here’s a quick summary of the steps you’ll follow:

  1. Whitelist your redirect URL
  2. Redirect the investor to the Securitize ID login or signup page
  3. Redirect the investor to the KYC process page
  4. Use the access token to check the investor’s KYC status
  5. (Optional) Subscribe to webhook notifications for real-time updates

Let’s go through each step in detail! 👇

🛡️ Step 1: Whitelist Your Redirect URL

You’ll need to whitelist the callback URL where you want to send your investors after they complete the KYC process.

👉 Follow this guide: How to whitelist your domain

This step is essential — if your URL isn’t whitelisted, the redirection won’t work.

🔐 Step 2: Redirect Investor to Log In or Sign Up

Investors must first log in or sign up using Securitize ID.

👉 Follow this guide: How to initiate the OAuth process

Once the login is successful, you’ll direct the investor to the KYC page using this link:

https://id.{environment}.securitize.io/#/profile/verification/type?issuerId={domainId}&scope={scope}&redirecturl={redirect_url}

Parameters:

  • issuerId: Your application’s clientId or domainId provided by Securitize.
  • scope: The data access you require. Supported scopes:
    • info – Personal information (name, email, address)
    • details – KYC status, suitability, accreditation
    • verification – Account verification and status checks

👉 Important:
Scopes should be space-separated without quotes. Example:

scope=info details verification
  • redirecturl: The URL where you want to send the investor after they complete the KYC process.
    ⚡️ This URL must already be whitelisted from Step 1.

🔍 Step 3: Check Investor’s KYC Status

Once the KYC process is complete, you can retrieve the investor’s KYC status by calling this API:

curl --location 'https://connect-gw.{environment}.securitize.io/api/sid/v1/investor/verification' \
--header 'Authorization: securitize' \
--header 'access-token: {access_token}'

Parameters:

  • access-token: This is the token you received during the login process.

Example Response: 

{
  "status": "verified",
  "investorId": "607f29dc3073230022ff532c",
  "createDate": "2021-04-26T21:34:01.236Z",
  "updateDate": "2022-09-15T17:23:22.722Z",
  "errors": [],
  "isManual": true
}

Possible KYC Status Values:

  • None
  • Processing
  • Updates Required
  • Manual Review
  • Verified
  • Rejected
  • Expired

👉 You can explore detailed definitions of these statuses here: KYC values

🧪 Testing Different KYC Scenarios

If you want to simulate different KYC results (like “Verified,” “Rejected,” or “Manual Review”) to test your platform’s flows:

  • Contact your Customer Success Manager or someone from the Implementation Team.
  • They can help update the KYC status for a specific test user email so you can validate your integration in all possible scenarios.

📢 Step 4: Webhook Notifications (Optional)

If you’ve subscribed to webhook notifications, you can receive real-time updates when an investor’s KYC status changes.

👉 Learn more here: Webhook Notification Setup

Related articles