Obtenir vos identifiants
Pour intégrer ZYKAY, vous avez besoin d'un Partner ID et d'un Partner Secret.
Inscription self-service
- Rendez-vous sur partners.zykay.com/register (opens in a new tab)
- Remplissez le formulaire (email, nom de l'entreprise, site web)
- Vérifiez votre email via le lien magique
- Récupérez vos identifiants sur la page d'onboarding
Ce que vous recevrez
Immédiatement après l'inscription :
| Identifiant | Format | Exemple |
|---|---|---|
| Partner ID | pk_live_ + 32 caractères hex | pk_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 |
| Partner Secret | Base64-encodé (32 octets bruts) | dJDEXhf397yTxR4aa8lzML9LvHDUL9bN... |
⚠️
Le Partner Secret est encodé en base64. Vous devez le décoder en octets bruts avant de l'utiliser comme clé HMAC. Voir la documentation de signature pour les détails.
Consignes de sécurité
🚫
Gardez votre Partner Secret sécurisé !
- Stockez-le dans des variables d'environnement ou un gestionnaire de secrets
- Ne le commitez jamais dans le contrôle de version
- Ne l'exposez jamais dans le code côté client
- Faites-le tourner immédiatement s'il est compromis
Configuration de l'environnement
Développement local
# .env.local (ajoutez à .gitignore !)
ZYKAY_PARTNER_ID=pk_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
ZYKAY_PARTNER_SECRET=dJDEXhf397yTxR4aa8lzML9LvHDUL9bNLbVRX3NO2acProduction
Utilisez la gestion des secrets de votre plateforme :
| Plateforme | Méthode |
|---|---|
| AWS | Secrets Manager / Parameter Store |
| GCP | Secret Manager |
| Vercel | Variables d'environnement (chiffrées) |
| Heroku | Config Vars |
| Docker | Docker Secrets |
Vérifier la configuration
La façon la plus simple de tester vos identifiants :
- Intégrez le widget sur une page de test
- Complétez une vérification
- Vérifiez que votre backend reçoit bien le
grant_code
Pour tester l'API directement, voir la documentation de l'API d'échange qui contient des exemples de code complets.
L'API utilise une signature HMAC avec hash du body et nonce anti-rejeu. Les exemples de code dans la documentation gèrent automatiquement cette complexité.
Étapes suivantes
Une fois vos identifiants obtenus :
- Démarrage rapide - Intégration en 5 minutes
- Intégrer le widget