5-minute EUDI integration

Authentication & setup

• • Keys live under Developers → API keys. Rotate quarterly or when staff changes.
• • Never embed keys client-side; use environment variables or secret managers.
• • Enterprise tenants can upload client TLS certificates for mutual TLS enforcement.
• • Rate limits: Starter 10 req/sec, Professional 100 req/sec, Enterprise custom. Exceeding returns HTTP 429 with Retry-After.

Core API response

{
  "verification_id": "v_abc123xyz",
  "status": "completed",
  "checks": { "age_over_18": true },
  "assurance_level": "substantial",
  "verification_method": "eudi_wallet",
  "timestamp": "2025-01-15T10:30:00Z",
  "audit": {
    "event_id": "evt_9f2c",
    "policy_id": "pol_age_gate",
    "verified_at": "2025-01-15T10:30:15Z"
  }
}

Add metadata (e.g. { userId: "123" }) or callbackUrl per request if you prefer push notifications over global webhooks.

Drop-in UI component

import { NexielVerifyButton } from '@nexiel/eudi-react';

export function SignupForm() {
  return (
    <NexielVerifyButton
      clientKey="pk_sandbox_abc123"
      credentialTypes={['age_attestation']}
      verificationMode="gate"
      scope={['age_over_18']}
      onSuccess={(verification) => {
        console.log('Verification receipt:', {
          session: verification.session_id,
          result: verification.result,
          checks: verification.checks,
        });
      }}
      onError={(error) => console.error(error)}
    />
  );
}

Handles QR vs deep link detection, wallet polling, localization, and theming. Vue/Angular/vanilla bundles share the same props.

Backend integration (Node/Python/Go)

import { NexielAPI } from '@nexiel/eudi-sdk';

const nexiel = new NexielAPI({ apiKey: process.env.NEXIEL_API_KEY });

export async function verifyUser(req, res) {
  // Gate mode (default): booleans only, no PII returned
  const verification = await nexiel.verify({
    mode: 'gate',
    scope: ['age_over_18'],
  });
  res.json({
    verification_id: verification.verification_id,
    decisions: verification.decisions, // { over18: true }
  });
}

from nexiel_eudi import NexielAPI
import os

client = NexielAPI(api_key=os.environ["NEXIEL_API_KEY"])
# Match mode: compare user input vs wallet attributes (no raw PII returned)
verification = client.verify(
  mode="match",
  scope=["name", "dob"],
  user_input={"name": "Jane Doe", "dob": "1990-01-02"},
)
print(verification.matches)

client := nexiel.New(os.Getenv("NEXIEL_API_KEY"))
// Data mode: allow-listed attributes only (requires tenant approval)
verification, err := client.Verify(nexiel.VerifyParams{
  Mode:  "data",
  Scope: []string{"address"},
  Allow: []string{"address"},
})
if err != nil {
  log.Fatal(err)
}
fmt.Println(verification.Data)

Error handling playbook

try {
  await nexiel.verify({ scope: ['name'] });
} catch (error) {
  switch (error.code) {
    case 'VERIFICATION_TIMEOUT':
      promptUserToRetry();
      break;
    case 'USER_DENIED':
      surfaceAlternateFlow();
      break;
    case 'INVALID_SCOPE':
      requestSupportedScopes();
      break;
    case 'RATE_LIMIT':
      wait(error.retryAfter);
      break;
  }
}

• VERIFICATION_TIMEOUT – User never opened or completed the wallet flow. Prompt a retry or fallback to ident.
• USER_DENIED – User rejected consent. Surface alternate onboarding or allow manual upload.
• INVALID_SCOPE – Scope not supported for the wallet country. Request available claims only.
• RATE_LIMIT – Client exceeded quota. Wait for `Retry-After` or upgrade plan.

Compliance & privacy

• • Nexiel stores encrypted audit logs + hashed attributes, never plaintext PII.
• • Wallet-initiated erasure requests propagate to every relying party automatically.
• • Assurance levels "Substantial" and "High" map to eIDAS 2.0 definitions and are surfaced in API responses.
• • Every API call is recorded for DPA review; fetch evidence via /verifications/{id}/audit.

Testing & sandbox

• • Sandbox keys start with sk_test_* and never touch production wallets.
• • Use Nexiel's test wallet CLI (npx nexiel-wallet-sandbox) to emit success/timeout/denial flows.
• • Replay deterministic fixtures under tests/fixtures for CI signal.
• • Prometheus /metrics exposes gateway histograms so you can alert on latency or saturation.

SDKs & libraries

FAQ & troubleshooting

Support & community

• • Email integrators@nexiel.ie for solutions engineers (SLA: next business day).
• • Join the invite-only Slack community via Developers → Community.
• • GitHub discussions: nexielhq/eudi-sdk
• • Status updates at status.nexiel.ie
• • Release notes ship in the dashboard changelog & RSS feed.