ZYKAY Partner Integration
Vérification d'identité privée pour votre site. Une seule balise script, aucune configuration complexe.
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.
(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>
block | Superposition plein écran jusqu'à la vérification | 
inline | Rendu dans #zykay-gate uniquement (le reste de la page reste visible) | 
Important : Ne mettez inline que si votre contenu sensible est dans #zykay-gate.
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) :
- Charger la page → le panneau ZYKAY s'affiche
 - Cliquer "Connexion rapide" → le wallet s'ouvre ou un QR s'affiche
 - Après approbation ou PDF, le panneau disparaît
 
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.
 
É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.
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>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.
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.
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.