Intégration en 1 minute

ZYKAY Partner Integration

Vérification d'identité privée pour votre site. Une seule balise script, aucune configuration complexe.

1

Ajoutez un script

Collez ce code juste avant </body> sur n'importe quelle page que vous souhaitez protéger :

Version épinglée (recommandé en production) :

<script
  src="https://widget-app.zykay.com/loader/loader.v1.3.2.js"
  data-zykay-partner-id="partner_yoursite"
  data-zykay-mode="block"
  defer
></script>

Version "latest" (mises à jour automatiques) :

<script
  src="https://widget-app.zykay.com/loader/loader.js"
  data-zykay-partner-id="partner_yoursite"
  data-zykay-mode="block"
  defer
></script>

Conseil : épinglez une version en prod, mettez à jour selon votre calendrier.

Remplacez partner_yoursite par l'ID fourni par ZYKAY (ex. partner_randomsite).

Pour React/Vue/Next.js (SPA/SSR) :

<!-- SPA: place this in the base HTML template (e.g., _document, index.html).
     Avoid injecting dynamically to preserve loading order. -->
<script
  src="https://widget-app.zykay.com/loader/loader.js"
  data-zykay-partner-id="partner_yoursite"
  data-zykay-mode="block"
  defer
></script>

Placez dans le template HTML de base. Évitez l'injection dynamique pour préserver l'ordre de chargement.

C'est tout. Aucun autre code n'est requis.

2

(Optionnel) Choisissez où afficher le widget

Si vous souhaitez que ZYKAY apparaisse dans un conteneur spécifique au lieu de bloquer toute la page, ajoutez un placeholder :

<div id="zykay-gate"></div>
<script
  src="https://widget-app.zykay.com/loader/loader.js"
  data-zykay-partner-id="partner_yoursite"
  data-zykay-mode="inline"
  data-zykay-target="#zykay-gate"
  defer
></script>
blockSuperposition plein écran jusqu'à la vérification
inlineRendu dans #zykay-gate uniquement (le reste de la page reste visible)

Important : Ne mettez inline que si votre contenu sensible est dans #zykay-gate.

3

Ce que vos utilisateurs verront

Un panneau épuré avec deux boutons :

Connexion rapide (wallet)

Ouvre leur portefeuille (extension desktop ou app mobile via lien sécurisé ; QR de secours si nécessaire).

Vérifier mon PDF

Vérification locale du PDF France Identité (rapide, reste sur la page).

Une fois vérifié, le panneau disparaît et votre contenu est visible.

Test rapide (1 minute) :

  1. Charger la page → le panneau ZYKAY s'affiche
  2. Cliquer "Connexion rapide" → le wallet s'ouvre ou un QR s'affiche
  3. Après approbation ou PDF, le panneau disparaît
4

Comment ça marche (en clair)

  • Nous ne vous demandons jamais de données utilisateur.
  • Nous délivrons un grant de courte durée à votre site lorsque l'utilisateur prouve soit qu'il a déjà vérifié son wallet avec ZYKAY, soit qu'il complète une vérification PDF rapide maintenant.
  • Toute la crypto et les preuves ZK sont gérées par nous. Vous incluez simplement le script.
5

Événements minimaux (optionnel)

Vous n'en avez pas besoin, mais si vous voulez des hooks analytics :

Événements de base :

<script>
  window.addEventListener('zykay:ready',    () => console.log('ZYKAY ready'));
  window.addEventListener('zykay:unlocked', () => console.log('Content unlocked'));
  window.addEventListener('zykay:failed',   (e) => console.log('ZYKAY failed', e.detail));
</script>

Exemple concret (déverrouillage de contenu) :

<script>
  window.addEventListener('zykay:unlocked', () => {
    document.documentElement.classList.add('zykay-ok');
  });
</script>
<style>.needs-zykay:not(.zykay-ok) { display:none }</style>

Ce code rend le signal actionnable au-delà de console.log.

6

Style de base (optionnel)

Nous fournissons un design épuré par défaut. Pour ajuster les largeurs en mode inline :

<style>
  #zykay-gate { max-width: 520px; margin: 2rem auto; }
</style>
7

Dépannage (super court)

Rien ne s'affiche ?

Assurez-vous que data-zykay-partner-id est correct.

Le wallet ne s'ouvre pas sur mobile ?

Le navigateur a bloqué la navigation → nous affichons automatiquement un QR ; le scanner continue instantanément.

CSP strict ?

Si la navigation externe est bloquée, nous affichons automatiquement un QR. Aucune modification requise.

8

Confidentialité & sécurité

Aucune PII collectée ou stockée.

Les sorties sont uniquement booléennes (ex : "âge ≥ 18").

La propriété du wallet est prouvée avec une signature de courte durée ; les logs stockent des IDs de wallet hachés.

Les écritures on-chain n'incluent jamais de données personnelles.

9

Support

Email : partners@zykay.com

Joignez l'URL de votre page et la console du navigateur (Cmd/Ctrl+Alt+J → copier) pour accélérer le diagnostic.

Prêt à commencer ?

Copiez le code ci-dessus et ajoutez-le à votre site. Vous serez opérationnel en moins d'une minute.