Trusset Protocol - Infrastructure for Asset Tokenization

This page is for the engineer sending investors through hosted KYC. After reading it you will know how to create a link, how to lock one to a single wallet, and which links can no longer be revoked or resent. The idLinks sub-module manages KYC verification links powered by . Each link directs an investor to a hosted verification flow where they complete identity checks and optionally connect a wallet.

Create a verification link

const link = await trusset.customers.idLinks.create({
  recipientEmail: '[email protected]',
  investorType: 'RETAIL',
  country: 'DE',
  expiryDays: 30,
  sendVia: ['email'],
  note: 'Series A allocation',
})

The created link carries:

Field	Holds
`link.id`	Internal link ID
`link.token`	Unique token in the verification URL
`link.verificationUrl`	Full URL to send to the investor
`link.status`	`PENDING` on creation
`link.delivery`	Per-channel send result, as `{ email: { sent: true } }`

At least one of recipientEmail, recipientWallet, or recipientPhone is required. If recipientWallet is set, the investor must verify from that specific address. If omitted, any wallet can be connected during verification.

Show CreateIdLinkInput fields

string

Investor’s email address.

string

Lock the link to a specific Ethereum address.

string

Investor’s phone number for SMS delivery.

string[]

Delivery channels: email, sms, or both. If omitted, the link is created but not sent.

number

default:30

Days until the link expires. Range: 1-365.

string

default:"RETAIL"

MiFID II classification assigned on completion.

string

ISO country code.

string

Internal note visible only in the Issuer Platform.

string

Custom message included in the email or SMS sent to the investor.

string

URL to redirect the investor after successful verification.

number

Charge the investor a one-time verification fee before the KYC flow starts. Integer cents, 50 - 1,000,000. Payment runs through a hosted Stripe checkout; the KYC flow unlocks once paid.

string

Required when feeCents is set: eur or usd.

Charge for a verification link

Links can carry a fee the investor pays before verification starts. feeCents is in integer cents, so 2500 is 25.00 in the given currency.

const paid = await trusset.customers.idLinks.create({
  recipientEmail: '[email protected]',
  feeCents: 2500,
  currency: 'eur',
})

The created link echoes feeCents and currency. List items expose feeCents, currency, and paidAt so you can track outstanding payments.

List links

status filters on PENDING, COMPLETED, or EXPIRED. The result carries links as IdLinkListItem[] and total as a number.

const result = await trusset.customers.idLinks.list({
  status: 'PENDING',
  limit: 50,
  offset: 0,
})

Revoke a link

Expires a link immediately so it can no longer be used. Completed links cannot be revoked.

await trusset.customers.idLinks.revoke('link-id')

Resend a link

Only links with status PENDING can be resent. Completed or expired links throw a TrussetError.

const result = await trusset.customers.idLinks.resend('link-id', ['email', 'sms'])

The result returns verificationUrl and a per-channel delivery object, as { email: { sent: true }, sms: { sent: true } }.

Getting Started

Customers

ID Links

Create a verification link

Charge for a verification link

List links

Revoke a link

Resend a link

​Create a verification link

​Charge for a verification link

​List links

​Revoke a link

​Resend a link

Create a verification link

Charge for a verification link

List links

Revoke a link

Resend a link