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