VisoChain - API Documentation

Base URL: https://api.visochain.com

🔐 Authentication

POST /api/auth/login Login with wallet address

Request Body

Parameter	Type	Required	Description
`address`	string	Yes	Wallet address (0x...)

Example

{
  "address": "0x90f8bf6a479f320ead074411a4b0e7944ea8c9c1"
}

200 OK 400 Invalid Address

POST /api/auth/verify Verify auth token

Request Body

Parameter	Type	Required	Description
`token`	string	Yes	Auth token from login

200 OK 401 Invalid Token

POST /api/auth/logout Logout and invalidate token

Request Body

Parameter	Type	Required	Description
`token`	string	Yes	Auth token

200 OK

📊 Data Registration

POST /api/data/register API Key Register data fingerprint

Headers

Header	Value
`X-API-Key`	Your partner API key

Request Body

Parameter	Type	Required	Description
`fingerprint`	string	Yes	Data hash (min 10 chars)
`contributor`	string	Yes	Contributor wallet address

Example

{
  "fingerprint": "img_abc123hash456",
  "contributor": "0x90f8bf6a479f320ead074411a4b0e7944ea8c9c1"
}

200 OK 401 Invalid API Key 409 Duplicate

GET /api/data/check/:fingerprint Check if data exists

URL Parameters

Parameter	Type	Description
`fingerprint`	string	Data fingerprint to check

Example Response

{
  "exists": true,
  "asset": {
    "contributor": "0x90f8...",
    "source": "TestPlatform",
    "timestamp": "2025-11-25T...",
    "reward": "100 VCDT"
  }
}

200 OK

GET /api/data/contributor/:address Get contributor stats

URL Parameters

Parameter	Type	Description
`address`	string	Wallet address

200 OK 400 Invalid Address

💳 Payment Gateway

POST /api/payment/create API Key Create payment request

Headers

Header	Value
`X-API-Key`	Your payment API key

Request Body

Parameter	Type	Required	Description
`amount`	number	Yes	Amount in VCDT
`description`	string	No	Payment description
`orderId`	string	No	Your order ID
`callbackUrl`	string	No	Success callback URL
`cancelUrl`	string	No	Cancel redirect URL

Example Response

{
  "success": true,
  "paymentId": "abc123...",
  "payUrl": "https://visochain.com/pay.html?id=abc123",
  "amount": 100,
  "expiresAt": "2025-11-25T..."
}

200 OK 401 Invalid API Key

GET /api/payment/:id Get payment status

URL Parameters

Parameter	Type	Description
`id`	string	Payment ID

200 OK 404 Not Found

POST /api/payment/confirm Confirm payment (internal)

Request Body

Parameter	Type	Required	Description
`paymentId`	string	Yes	Payment ID
`txHash`	string	Yes	Transaction hash
`payer`	string	Yes	Payer wallet address

200 OK 404 Not Found

POST /api/payment/verify API Key Verify payment status

Request Body

Parameter	Type	Required	Description
`paymentId`	string	Yes	Payment ID to verify

200 OK 404 Not Found

GET /api/payment/list API Key List your payments

Headers

Header	Value
`X-API-Key`	Your payment API key

200 OK 401 Invalid API Key

📈 Network

GET /api/stats Network statistics

Example Response

{
  "network": {
    "name": "VisoChain",
    "chainId": 2025,
    "peers": 4,
    "blockNumber": 12345
  },
  "token": {
    "name": "VCDT",
    "totalSupply": "2000200 VCDT"
  },
  "dataRegistry": {
    "totalAssets": "150",
    "currentRewardPerAsset": "100 VCDT"
  }
}

200 OK

GET /api/user/:address User information

URL Parameters

Parameter	Type	Description
`address`	string	Wallet address

200 OK 400 Invalid Address

GET /api/health Health check

Example Response

{
  "status": "ok",
  "blockNumber": 12345,
  "timestamp": "2025-11-25T..."
}

200 OK 500 Error

📡 API Documentation