Verify wallet KYC via TRUST network

POST

/v2/onboarding/wallet

• Staging
• Development

Verify wallet KYC status using SIWE (Sign-In with Ethereum) signature authentication and the TRUST Bulletin Board network. This endpoint verifies wallet ownership through cryptographic signature verification and queries the TRUST network for associated VASP KYC information.

Authorizations

• X-API-Key
• X-API-Secret

Request Body ^required

object

chainId

required

Chain ID of the blockchain network

number

84532

message

required

SIWE (Sign-In with Ethereum) message to be signed

string

localhost wants you to sign in with your Ethereum account:
0x41ABAb3a4bEFC66569C5CCD9f4A687E141fA85b3

Sign in with Ethereum to PakSend

URI: http://localhost:4604
Version: 1
Chain ID: 84532
Nonce: 86946ddd21752b55cef8b3d4ebea5618
Issued At: 2025-11-27T04:18:07.173Z

signature

required

Hex-encoded signature of the SIWE message

string

0x4bdb6ba0c390e09f0ba9ffec19497b29b37496f71dfd584bf6c2b887be6d842b310c6c45151e1c556cfec8ef549b6169e48f218cd1552b1f9769b3193ecb59251b

walletAddress

required

Wallet address (normalized to lowercase with 0x prefix)

string

0x41abab3a4befc66569c5ccd9f4a687e141fa85b3

Responses

201

The wallet KYC verification result including VASP information if the wallet has verified KYC.

object

verificationId

required

Unique verification ID

string

82c4fce1-d2c7-48cb-a647-6993dbe37819

verified

required

Whether the wallet has verified KYC

boolean

true

status

required

Verification status

string

Allowed values: verified not_verified pending invalid_signature invalid_message unsupported_chain trust_error

verified

walletAddress

required

Wallet address that was verified

string

0x41abab3a4befc66569c5ccd9f4a687e141fa85b3

chainId

required

Chain ID

number

84532

chain

Chain name

string

BASE_SEPOLIA

vaspId

VASP identifier (LEI) if wallet KYC is verified

string

5493001KJTIIGC8Y1R12

vaspName

VASP name if wallet KYC is verified

string

Example VASP Inc

vaspEndpoint

VASP PII endpoint if wallet KYC is verified

string

https://vasp.example.com/pii

errorMessage

Error message if verification failed

string

verifiedAt

Timestamp when verification was completed

string

2025-11-27T04:18:07.173Z

createdAt

required

Timestamp when record was created

string

2025-11-27T04:18:07.173Z

kycRequestId

KYC request ID if Sumsub verification was initiated

string

550e8400-e29b-41d4-a716-446655440000

sessionUrl

Sumsub SDK session URL for identity verification

string

https://api.sumsub.com/websdk/init?token=...

message

Message from the verification service

string

KYC verification initiated. Please complete the verification process.

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error