01 Ce que permet le connecteur
Le connecteur Klarna ajoute le paiement fractionné à vos encaissements Anim'Gest.
- Paiement en plusieurs fois proposé à vos clients via Klarna.
- Rapprochement automatique : à chaque notification de paiement, le règlement est enregistré sur la facture.
- Notification sécurisée (webhook signé HMAC-SHA256) : la signature est vérifiée avant tout enregistrement.
- Une adresse par établissement : l'URL de notification se termine par votre identifiant
tXXXXXX. - Identifiants chiffrés (AES-256), jamais affichés en clair.
02 Prérequis
| Compte Klarna | Un compte marchand Klarna actif. Playground pour tester, Production pour les encaissements réels. |
| Identifiants API | Vos clés d'API Klarna, à renseigner dans Paramètres › API › Klarna. Stockées chiffrées. |
| Identifiant établissement | Au format tXXXXXX, visible dans l'URL de votre espace. Il termine l'adresse du webhook. |
| Accès Merchant Portal | Droits suffisants pour déclarer une URL de notification dans votre espace Klarna. |
03 Configurer le connecteur
Repérer votre identifiant
Notez l'identifianttXXXXXXde votre établissement, visible dans l'URL de votre espace.Récupérer vos identifiants Klarna
Depuis votre Merchant Portal Klarna, récupérez vos clés d'API (Playground ou Production).Renseigner dans Anim'Gest
Dans Paramètres › API › Klarna, collez vos identifiants, choisissez l'environnement, Enregistrez, puis Tester la connexion.Déclarer l'URL de notification
Dans Klarna, déclarez l'adresse propre à votre établissement :https://animgest-app-saas.no-sages-editor.com/api/webhooks/klarna/tXXXXXX.Tester
Déclenchez un paiement de test : la signature est vérifiée et le règlement apparaît sur la facture.
Bon à savoir. L'adresse du webhook est propre à chaque établissement : elle se termine par
tXXXXXX. Ne réutilisez pas l'URL d'un autre établissement.04 Suivi & dépannage
| Cas | Signification & action |
|---|---|
| Test 200 | Identifiants valides, connexion Klarna établie. |
| Test 401 / 403 | Identifiants invalides. Vérifiez la clé et l'environnement (Playground vs Production). |
| Webhook rejeté | Signature invalide. Vérifiez l'URL déclarée côté Klarna et l'identifiant tXXXXXX. |
| Aucune notification | URL non (ou mal) déclarée dans Klarna — recopiez l'adresse de l'étape 4. |
Sans doublon. Un même paiement n'est rapproché qu'une seule fois.
05 Bonnes pratiques
- Playground d'abord, puis Production pour les encaissements réels.
- Une URL par établissement : vérifiez que
tXXXXXXest bien le vôtre. - Après un paiement test, contrôlez le règlement sur la facture.
- Si vous changez d'identifiants, recopiez-les et re-testez la connexion.
Confidentialité. Vos clés Klarna ne doivent jamais être partagées. Stockées chiffrées, non réaffichées.