Verify wallet KYC via SIWE signature

POST

/v2/send/kyc/verify

• Staging
• Development

Same response as initiate KYC; adds SIWE signature validation step. Verifies wallet ownership and queries the TRUST network for KYC status. Registers the wallet-endUser mapping for notification routing.

Authorizations

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

Parameters

Header Parameters

X-API-Key

string

API Key

X-API-Secret

string

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

endUserId

required

End user ID for wallet-user mapping

string format: uuid

e271bc5c-f870-44cd-8462-54280d0411f6

Responses

201

KYC status result (same shape as initiate KYC): verified, status, walletAddress, chainId, verificationId, kycRequestId, sessionUrl, message.

object

verified

required

Whether the wallet is KYC verified

boolean

true

status

required

KYC verification status

string

Allowed values: verified not_verified pending in_progress rejected

verified

walletAddress

required

Wallet address

string

0x1234567890abcdef1234567890abcdef12345678

chainId

required

Blockchain chain ID

number

84532

verificationId

Verification record ID

string format: uuid

kycRequestId

KYC request ID (if initiated)

string format: uuid

sessionUrl

KYC provider session URL (if initiated)

string format: uri

message

Human-readable message

string

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error