Démarrage rapide

Créez votre première session de vérification nouko en sandbox, ouvrez le parcours client et recevez le webhook en 5 minutes.

1. Obtenir une clé de test

Créez un compte, puis ouvrez Console → Développeurs → Clés API et créez une clé sandbox. Elle commence par nk_test_ et n’est affichée qu’une fois : enregistrez-la dans une variable d’environnement.

export NOUKO_API_KEY="nk_test_…"

2. Créer une session

curl -X POST https://nouko.openclouds.fr/api/public/v1/sessions \
  -H "Authorization: Bearer $NOUKO_API_KEY" \
  -H "Idempotency-Key: commande-001" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "client-42",
    "country": "BJ",
    "tier": 2,
    "redirect_url": "https://votre-site.com/kyc/retour",
    "metadata": { "user_id": "42" }
  }'

Réponse :

HTTP/1.1 201 Created
X-Request-Id: 3b1e…

{
  "id": "6f1c2a9e-…",
  "reference": "client-42",
  "status": "draft",
  "country": "BJ",
  "tier": 2,
  "environment": "sandbox",
  "redirect_url": "https://votre-site.com/kyc/retour",
  "metadata": { "user_id": "42" },
  "expires_at": "2026-10-24T18:00:00.000Z",
  "verification_url": "https://nouko.openclouds.fr/verify/…",
  "replayed": false,
  "sandbox_scenario": null
}

3. Ouvrir le parcours client

Redirigez votre client vers verification_url. En sandbox, le parcours affiche « Parcours de test » : vous pouvez remplir avec des données fictives et choisir le résultat. À la fin, le client revient sur votre redirect_url avec ?nouko_session=…&status=….

4. Recevoir la décision

Dans Console → Développeurs → Webhooks, ajoutez l’adresse de votre serveur et conservez le secret affiché. Puis implémentez le récepteur : voir Vérifier la signature.

Raccourci : tester sans interface

Utilisez la référence test_approve (ou test_decline, test_review, test_expire) : la session avance immédiatement et les vrais webhooks partent. Voir Sandbox.