KYC Submission

Submitting KYC data and receiving SBT

KYC Submission

Users must complete KYC before they can transact on the platform. After KYC submission, a Soulbound Token (SBT) is issued to prove identity verification.

Submit KYC

curl -X POST http://api.paywithz.com/api/kyc/submit \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "kycData": {
      "fullName": "John Doe",
      "country": "US",
      "dateOfBirth": "1990-01-15",
      "email": "[e-mail]",
      "phoneNumber": "[phone]"
    }
  }'

Request Fields

Field	Required	Description
wallet	Yes	Solana wallet address
kycData.fullName	Yes	User’s full name
kycData.country	Yes	Country code (ISO 3166-1 alpha-2)
kycData.dateOfBirth	Yes	Date of birth (YYYY-MM-DD)
kycData.email	No	Email address
kycData.phoneNumber	No	Phone number with country code

Response Fields

Field	Description
kycHash	Cryptographic hash of KYC data
sbtTokenAccount	SBT token account address
txSignature	Solana transaction signature
expiry	SBT expiry timestamp (Unix)
explorerUrl	Link to view transaction on Solana Explorer

What Happens

1. Backend validates KYC data format
2. Creates hash of KYC data
3. Stores full KYC data in database (secure)
4. Calls SBT Manager program
5. Issues SBT to user’s wallet
6. Stores hash on-chain in SBT metadata

Privacy: Full KYC data is never stored on-chain. Only a cryptographic hash is stored. This protects user privacy while proving verification.

SBT Characteristics

Non-Transferable

SBT cannot be sent to another wallet. Bound to original wallet.

Contains KYC Hash

Cryptographic hash of KYC data stored on-chain.

Required for Transfers

Both sender and receiver must have SBT to transfer.

Revocable

Admin can revoke SBT if compliance fails.

Verify KYC Status

After submission, check wallet status:

curl http://api.paywithz.com/api/wallet/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU/status

Get Your API Key

Request API Key

Join our pilot program to get API access. Banks, fintechs, and financial institutions welcome.

Next Steps

Stablecoin Operations

Mint and transfer tokens after KYC

Overview

See all API examples