5 min setup

Quickstart Guide

Get up and running with okID in minutes. Choose between our JavaScript SDK for quick integration or REST API for full control.

Choose Your Integration Method

Recommended for web apps

JavaScript SDK Quickstart

Get started with our drop-in modal solution in 3 easy steps.

Install the SDK

npm install @okid/verification-sdk

Include SDK Files

<!-- Include CSS -->
<link rel="stylesheet" href="https://cdn.okid.io/sdk/modal.css">

<!-- Include SDK -->
<script src="https://cdn.okid.io/sdk/verification-sdk.js"></script>

Initialize and Start Verification

// Initialize the SDK
const sdk = new VerificationSDK({
  baseUrl: 'https://verify.okid.io',
  onSuccess: function(data) {
    console.log('Verification completed:', data);
    // Handle successful verification
  },
  onError: function(error) {
    console.error('Verification error:', error);
    // Handle errors
  },
  onClose: function() {
    console.log('Modal closed');
    // Handle modal close
  }
});

// Start verification
sdk.startDirectVerification();

That's it!

Your users will see a verification modal when they click the verification button.

Complete Example

Here's a complete example of a verification button implementation:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="https://cdn.okid.io/sdk/modal.css">
</head>
<body>
  <button id="verify-btn" class="verify-button">
    Verify Your Identity
  </button>

  <script src="https://cdn.okid.io/sdk/verification-sdk.js"></script>
  <script>
    // Initialize SDK
    const sdk = new VerificationSDK({
      baseUrl: 'https://verify.okid.io',
      onSuccess: function(data) {
        // Success! Update UI
        document.getElementById('verify-btn').textContent = 'Verified ✓';
        document.getElementById('verify-btn').disabled = true;
        
        // Send verification data to your server
        fetch('/api/verification-complete', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify(data)
        });
      },
      onError: function(error) {
        alert('Verification failed. Please try again.');
      }
    });

    // Attach click handler
    document.getElementById('verify-btn').onclick = function() {
      sdk.startDirectVerification();
    };
  </script>
</body>
</html>