using Verifyo.SDK;
using Verifyo.SDK.Models;
// Initialize the client
var client = new VerifyoClient("vfy_sk_your_api_key");
// Check a wallet address
var response = await client.CheckAddressAsync("0x742d35...", "ethereum");
if (response.HasResults())
{
var verification = response.GetFirstResult();
if (verification.MeetsBasicRequirements())
{
Console.WriteLine("✅ User is KYC verified");
Console.WriteLine($"KYC Level: {verification.KycLevel}");
Console.WriteLine($"Country: {verification.DocumentCountry}");
}
}
Configuration
// With custom configuration
var options = new VerifyoClientOptions(
BaseUrl: "https://api.verifyo.com", // Optional: custom API endpoint
Timeout: TimeSpan.FromSeconds(60), // Optional: custom timeout
Debug: true // Optional: enable debug logging
);
var client = new VerifyoClient("vfy_sk_your_api_key", options);
API Methods
CheckAddressAsync
Check KYC verification status for a wallet address:
// Check with network specification
var response = await client.CheckAddressAsync(
address: "0x742d35...",
network: "ethereum",
cancellationToken: cancellationToken
);
// Check without network (auto-detection)
var response = await client.CheckAddressAsync("3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy");
Response Structure
CheckResponse
The main response wrapper:
if (response.HasResults())
{
Console.WriteLine($"Found {response.ResultCount()} verification(s)");
foreach (var result in response.Results)
{
// Process each verification
}
}
// Check rate limits
if (response.RateLimitInfo != null)
{
Console.WriteLine($"API Usage: {response.RateLimitInfo.Used}/{response.RateLimitInfo.Limit}");
if (response.RateLimitInfo.IsNearLimit())
{
Console.WriteLine("⚠️ Approaching rate limit!");
}
}
VerificationResult
Individual verification details:
var verification = response.GetFirstResult();
// Basic properties
Console.WriteLine($"Status: {verification.KycStatus}");
Console.WriteLine($"Level: {verification.KycLevel}");
Console.WriteLine($"Country: {verification.DocumentCountry ?? "Not provided"}");
// Age verification
Console.WriteLine($"Over 18: {verification.AgeOver18}");
Console.WriteLine($"Over 21: {verification.AgeOver21}");
// Convenience methods
if (verification.IsVerified())
{
Console.WriteLine("User has completed KYC");
}
if (verification.MeetsBasicRequirements())
{
// User is verified, 18+, passes AML, and wallet is safe
Console.WriteLine("User meets all basic compliance requirements");
}
Wallet Information
var wallet = verification.Wallet;
Console.WriteLine($"Address: {wallet.Address}");
Console.WriteLine($"Ownership: {wallet.OwnershipStatus}");
Console.WriteLine($"Sanctioned: {wallet.Sanctioned}");
Console.WriteLine($"High Risk: {wallet.HighRisk}");
if (wallet.IsSafeToInteract())
{
Console.WriteLine("✅ Wallet is safe for transactions");
}
AML Screening
var aml = verification.Aml;
Console.WriteLine($"Sanctioned: {aml.Sanctioned}");
Console.WriteLine($"PEP: {aml.Pep}");
Console.WriteLine($"Criminal: {aml.Criminal}");
Console.WriteLine($"Adverse Media: {aml.AdverseMedia}");
if (aml.PassesAmlScreening())
{
Console.WriteLine("✅ Passes all AML checks");
}
Error Handling
The SDK provides specific exception types for different error scenarios:
// In Program.cs or Startup.cs
builder.Services.AddSingleton<VerifyoClient>(provider =>
{
var configuration = provider.GetRequiredService<IConfiguration>();
var apiKey = configuration["Verifyo:ApiKey"];
var options = new VerifyoClientOptions(
Debug: builder.Environment.IsDevelopment()
);
return new VerifyoClient(apiKey, options);
});
// In your controller
[ApiController]
[Route("api/[controller]")]
public class VerificationController : ControllerBase
{
private readonly VerifyoClient _verifyoClient;
public VerificationController(VerifyoClient verifyoClient)
{
_verifyoClient = verifyoClient;
}
[HttpGet("check/{address}")]
public async Task<IActionResult> CheckAddress(string address)
{
try
{
var response = await _verifyoClient.CheckAddressAsync(address);
return Ok(response);
}
catch (AuthenticationException)
{
return Unauthorized("Invalid API credentials");
}
catch (RateLimitException ex)
{
Response.Headers.Add("X-RateLimit-Limit", ex.Limit.ToString());
Response.Headers.Add("X-RateLimit-Remaining", ex.Remaining.ToString());
return StatusCode(429, "Rate limit exceeded");
}
}
}
Thread Safety
The VerifyoClient class is thread-safe and can be used as a singleton in your application. It's recommended to create a single instance and reuse it throughout your application's lifetime.
Best Practices
Use a Single Client Instance: Create one VerifyoClient instance and reuse it
Handle Rate Limits: Implement exponential backoff when hitting rate limits
Fail-Safe: Always deny access when verification fails or errors occur
Monitor Usage: Check RateLimitInfo to avoid hitting limits
Use Cancellation Tokens: Pass cancellation tokens for proper request cancellation
Log Errors: Log all exceptions for debugging and monitoring
