Démarrage Rapide

Intégrez ZYKAY en 3 étapes avec le loader v4.

1. Obtenez vos identifiants

Créez votre compte sur partners.zykay.com (opens in a new tab).

Identifiant	Format	Usage
`partner_id`	`pk_live_xxx`	Frontend + backend
`partner_secret`	Base64	Backend uniquement

⚠️

Le partner_secret est encodé en base64. Vous devez le décoder avant la signature HMAC.

2. Ajoutez le loader v4 (frontend)

<script src="https://widget-app.zykay.com/v4/loader.min.js"
        data-partner-id="pk_live_xxx"
        data-success-path="/verified"
        data-scopes="isAdult"></script>

Comportement:

Desktop: QR code à scanner avec l'app ZYKAY
Mobile: ouverture directe de l'app (deep link)
Succès: redirection vers data-success-path#grant_code=...

3. Échangez le grant côté backend

// POST /api/zykay/exchange (votre backend)
// Body: { "grant_code": "g_xxx" }
 
const response = await fetch('https://api.zykay.com/v1/exchange', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Partner-ID': partnerId,
    'X-Partner-Timestamp': timestamp,
    'X-Partner-Nonce': nonce,
    'X-Partner-Signature': signature,
  },
  body: JSON.stringify({ grant_code }),
});

Récupérer `grant_code` depuis l'URL

const hash = new URLSearchParams(window.location.hash.slice(1));
const grantCode = hash.get('grant_code');
if (grantCode) {
  await fetch('/api/zykay/exchange', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ grant_code: grantCode }),
  });
}

Le fragment #grant_code=... est utilisé pour éviter la fuite de données dans le header Referer.

Prochaines étapes

Frontend complet: /integration/script-tag
Backend complet: /integration/backend
CSP/CORS: /guides/csp-cors

Introduction Prerequisites