Getting Started

Get up and running with WalletGate in less than 5 minutes.

Prerequisites

• Node.js 18+ or any modern JavaScript environment
• A WalletGate account

Step 1: Get Your API Key

1. Create an account if you haven't already
2. Navigate to the Keys section in your dashboard
3. Copy your test API key (starts with wg_test_)

Free Test Environment

Test keys come with 100 free verifications per month and never expire. No credit card required!

Getting an API Key

• New user? Register to get a test key (wg_test_*)
• Returning? Log in to view/manage keys
• Live keys (wg_live_*) are available on paid plans and used for production requests

Step 2: Install the SDK

npm

npm install @walletgate/eudi

yarn

yarn add @walletgate/eudi

pnpm

pnpm add @walletgate/eudi

Step 3: Create Your First Verification

import { WalletGate } from '@walletgate/eudi';

// Initialize the client
const client = new WalletGate({
  apiKey: process.env.WALLETGATE_API_KEY, // wg_test_...
});

// Create a verification session
const session = await client.createSession({
  checks: [
    { type: 'age_over', value: 18 },
    { type: 'residency_eu' },
  ],
  redirectUrl: 'https://your-app.com/success',
  webhookUrl: 'https://your-app.com/webhook',
});

console.log('Verification URL:', session.verificationUrl);
console.log('Session ID:', session.id);

Step 4: Display QR Code to User

Show the verificationUrl as a QR code for users to scan with their EU Digital Identity Wallet:

import QRCode from 'qrcode';

// Generate QR code
const qrCodeDataUrl = await QRCode.toDataURL(session.verificationUrl);

// Display in your UI
// <img src={qrCodeDataUrl} alt="Scan with your EU Digital Identity Wallet" />

Step 5: Handle Verification Results

Option A: Webhooks (Recommended)

Receive real-time updates when verification completes:

import express from 'express';
import crypto from 'crypto';

const app = express();
app.use(express.json());

app.post('/webhook', (req, res) => {
  // Verify webhook signature
  const signature = req.headers['wg-signature'];
  const timestamp = req.headers['wg-timestamp'];
  const payload = JSON.stringify(req.body);

  const expectedSignature = crypto
    .createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(`${timestamp}.${payload}`)
    .digest('hex');

  if (signature !== expectedSignature) {
    return res.status(401).send('Invalid signature');
  }

  // Process the webhook
  const { event, data } = req.body;

  if (event === 'verification.completed') {
    console.log('Verification completed:', data.sessionId);
    console.log('Results:', data.results);
    // Update your database, notify user, etc.
  }

  res.status(200).send('OK');
});

Option B: Polling

Query the session status periodically:

// Poll every 2 seconds
const pollSession = setInterval(async () => {
  const session = await client.getSession(sessionId);

  if (session.status === 'completed') {
    console.log('Verification results:', session.results);
    clearInterval(pollSession);
  } else if (session.status === 'failed') {
    console.error('Verification failed:', session.error);
    clearInterval(pollSession);
  }
}, 2000);

What's Next?

• 📖 Learn about Test vs Live environments
• 🔄 Understand the Verification Flow
• 🔔 Set up Webhooks
• 📚 Browse the API Reference
• 🎮 Try the Interactive API

Need Help?

• 📧 Email: [email protected]
• 💬 Join our Discord community
• 📖 Check the FAQ