Gérer les erreurs (client JS)
Cette page décrit le traitement des erreurs d'intégration.
Si vous souhaitez personnaliser la gestion des erreurs survenant lors du refus d'une transaction, consultez l'article suivant :
Comment sont affichées les erreurs ?
Pour le formulaire JavaScript, les erreurs sont automatiquement affichées dans la div kr-form-error :
Il vous suffit de l'ajouter.
Gérer les erreurs manuellement
Pour gérer les erreurs manuellement, il vous suffit d'intercepter le message d'erreur par defaut et de le personnaliser. Dans l'exemple suivant, le message d'erreur personnalisé sera placé dans la div de classe customerror :
Codes d'erreur JS
L'API REST dispose de nombreux codes d'erreur décrits ici :
Les codes d'erreur préfixés par CLIENT_ correspondent à des erreurs survenant dans le navigateur de l'acheteur. Elles se produisent avant que les données de paiement ne soient envoyées sur nos serveurs. Cela concerne, par exemple, des erreurs de validation de données du formulaire effectuées localement, ou des erreurs d'intégration du client JavaScript.
Les codes d'erreur compris entre CLIENT_700 et CLIENT_799 sont des avertissements, pour vous aider à intégrer le client JavaScript.
| CODE | DEFINITION |
|---|---|
| CLIENT_001 | Paiement refusé |
| CLIENT_004 | Clé publique invalide |
| CLIENT_100 | formToken invalide |
| CLIENT_101 | Transaction abandonnée |
| CLIENT_103 | Délai d'attente dépassé |
| CLIENT_104 | Erreur passerelle (50x) |
| CLIENT_105 | Paiement non finalisé |
| CLIENT_200 | Aucun bouton ou formulaire trouvé |
| CLIENT_300 | Données invalides |
| CLIENT_301 | Numéro de carte invalide |
| CLIENT_302 | Date d'expiration invalide |
| CLIENT_303 | Code de sécurité invalide |
| CLIENT_304 | champ obligatoire non défini |
| CLIENT_305 | Pas de formToken défini |
| CLIENT_306 | Veuillez choisir un type de pièce d'identité |
| CLIENT_307 | Le numéro de la pièce d'identité est invalide |
| CLIENT_308 | nom du porteur invalide |
| CLIENT_309 | mode de paiement invalide |
| CLIENT_311 | Veuillez sélectionner une carte |
| CLIENT_500 | Aucun bouton de formulaire n'a été défini |
| CLIENT_501 | Le paramètre kr-public-key est vide ou absent |
| CLIENT_502 | Le paiement a déjà été effectué (le bouton de retour du navigateur n'est pas supporté) |
| CLIENT_503 | Le moyen de paiement sélectionné n'est pas disponible |
| CLIENT_504 | Aucune carte disponible avec ce filtre |
| CLIENT_505 | Le SmartForm n'est pas supporté avec le thème actuel |
| CLIENT_506 | Navigateur non supporté avec le thème actuel |
| CLIENT_507 | Les pages incluant Apple Pay doivent utiliser le protocole HTTPS |
| CLIENT_508 | Le paiement par carte n'est pas disponible |
| CLIENT_509 | KR.openSelectedPaymentMethod() n'est disponible qu'avec le SmartForm |
| CLIENT_510 | L'URL fournie est invalide |
| CLIENT_511 | Erreur de callback du marchand |
| CLIENT_512 | formToken invalide |
| CLIENT_513 | Format de réponse invalide |
| CLIENT_600 | Apple Pay doit être activé à la suite d'une action utilisateur. Dans le cas contraire, KR.openPaymentMethod sera bloqué. |
| CLIENT_601 | Veuillez sélectionner une méthode de paiement |
| CLIENT_702 | kr-style ignored because kr-theme is defined |
| CLIENT_704 | Vous devez charger Font Awesome dans la section HEAD |
| CLIENT_705 | viewport non défini ( |
| CLIENT_706 | Le contenu de |
| CLIENT_707 | les paramètres kr-get-url-success et kr-post-url-success ne peuvent pas être définis en même temps |
| CLIENT_708 | les paramètres kr-get-url-refused et kr-post-url-refused ne peuvent pas être définis en même temps |
| CLIENT_709 | Le conteneur |
| CLIENT_710 | Le champ 'kr-form-token' a été ignoré car 'formToken' est déjà fourni. |
| CLIENT_711 | L'application est lancée localement dans le navigateur, elle doit être lancée depuis un serveur avec un prefix d'url en https:// ou http:// url |
| CLIENT_712 | Vous ne pouvez pas utiliser les arguments kr-embedded et kr-popin en même temps |
| CLIENT_713 | Configuration du formulaire invalide |
| CLIENT_714 | La propriété %property% n'est pas configurable |
| CLIENT_715 | Erreur de KR.renderElements : |
| CLIENT_716 | L'élément doit avoir exactement l'une des classes suivantes ('kr-embedded', 'kr-smart-form', 'kr-smart-button') |
| CLIENT_717 | Plusieurs éléments .kr-embedded détectés, seul le premier sera rendu |
| CLIENT_718 | Plusieurs éléments .kr-smart-form détectés, seul le premier sera rendu |
| CLIENT_719 | La méthode KR.renderElements accepte seulement 0 ou 1 paramètre |
| CLIENT_800 | Le formulaire de paiement a été bloqué suite à l'erreur PSP_099. Vous devez définir le paramètre kr-post-url-refused pour rediriger l'acheteur vers votre page de refus de paiement |
| CLIENT_993 | Erreur Javascript |
| CLIENT_994 | Mettez à jour %browser%, votre version est obsolète |
| CLIENT_995 | Erreur javascript (PASS) |
| CLIENT_996 | Opération non autorisée |
| CLIENT_997 | Erreur de configuration du Endpoint |
| CLIENT_998 | FormToken de démo utilisé, paiement désactivé. Consultez la documentation pour obtenir un formToken réel. |
| CLIENT_999 | Erreur technique |
Détail des codes d'erreur
CLIENT_004
| Code | CLIENT_004 |
| Définition | Clé publique invalide |
| Catégorie | Erreurs |
La clé publique définie dans kr-public-key n'est pas valide, elle doit être de la forme : [NUMERO]:[CHAINE]
par exemple : 69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5
Pour plus d'informations, rendez-vous ici : Récupérer mes clés.
CLIENT_100
| Code | CLIENT_100 |
| Définition | formToken invalide |
| Catégorie | Erreurs |
Le formToken que vous avez défini dans kr-form-token est invalide. Pour plus d'informations sur la création d'un formToken, rendez-vous ici: guide d'intégration.
CLIENT_101
| Code | CLIENT_101 |
| Définition | Transaction abandonnée |
| Catégorie | Erreurs |
La transaction a été abandonnée par l'acheteur. Cette erreur se produit, par exemple, lorsque l'acheteur ferme la pop-in 3D-Secure avant de s'être authentifié.
Si l'acheteur n'effectue pas d'autre tentative, une transaction refusée est automatiquement créée lorsque le formToken arrive à expiration.
CLIENT_300
| Code | CLIENT_300 |
| Définition | Données invalides |
| Catégorie | Erreurs |
Lorsque plusieurs champs du formulaire sont invalides, une erreur générale CLIENT_300 est retournée. La liste détaillée de toutes les erreurs détectées sera contenue dans le champ children :
{
"errorCode": "CLIENT_300",
"errorMessage": "Invalid form data",
"children": [{
"errorCode": "CLIENT_301",
"errorMessage": "Invalid card number",
"field": "pan",
(...)
}, {
"errorCode": "CLIENT_302",
"errorMessage": "Invalid expiry date",
"field": "expiryDate",
(...)
}, {
"errorCode": "CLIENT_303",
"errorMessage": "Invalid security code",
"field": "securityCode",
(...)
}],
"detailedErrorCode": null,
"detailedErrorMessage": null,
(...)
}CLIENT_301
| Code | CLIENT_301 |
| Définition | Numéro de carte invalide |
| Catégorie | Erreurs |
Le champ kr-pan (numéro de carte) du formulaire de paiement est invalide.
CLIENT_302
| Code | CLIENT_302 |
| Définition | Date d'expiration invalide |
| Catégorie | Erreurs |
Le champ kr-expiry (date d'expiration) du formulaire de paiement est invalide.
CLIENT_303
| Code | CLIENT_303 |
| Définition | Code de sécurité invalide |
| Catégorie | Erreurs |
Le champ kr-security-code (code de sécurité ou CVV) du formulaire de paiement est invalide.
CLIENT_304
| Code | CLIENT_304 |
| Définition | champ obligatoire non défini |
| Catégorie | Erreurs |
Un champ additionnel déclaré comme obligatoire est vide. Pour plus de détails, rendez-vous ici : Champs de formulaire personnalisés.
CLIENT_305
| Code | CLIENT_305 |
| Définition | Pas de formToken défini |
| Catégorie | Erreurs |
Le formToken n'existe pas ou n'est pas conforme. Pour plus de détails, rendez-vous ici : undefined.
CLIENT_500
| Code | CLIENT_500 |
| Définition | Aucun bouton de formulaire n'a été défini |
| Catégorie | Erreurs |
Aucun bouton de formulaire de paiement n'a été trouvé dans le code HTML. Vérifiez si les balises nécessaires sont bien présentes, ou s'il n'y a pas une erreur de syntaxe.
CLIENT_501
| Code | CLIENT_501 |
| Définition | Le paramètre kr-public-key est vide ou absent |
| Catégorie | Erreurs |
La clé publique n'est pas définie dans kr-public-key.
CLIENT_502
| Code | CLIENT_502 |
| Définition | Le paiement a déjà été effectué (le bouton de retour du navigateur n'est pas supporté) |
| Catégorie | Erreurs |
L'application a détecté que l'acheteur est revenu sur la page de paiement à l'aide du bouton de retour, sur son navigateur internet. Le formulaire de paiement a été bloqué.
Notez que cette détection n'est fonctionnelle que sur certains navigateurs.
CLIENT_505
| Code | CLIENT_505 |
| Définition | Le SmartForm n'est pas supporté avec le thème actuel |
| Catégorie | Erreurs |
Le thème material n'est pas supporté par le formulaire smartForm.
Il faut impérativement changer et choisir entre
le thème néon ou le thème classic.
Voir :"Thèmes".
CLIENT_508
| Code | CLIENT_508 |
| Définition | Le paiement par carte n'est pas disponible |
| Catégorie | Erreurs |
Assurez-vous de disposer d'un contrat de paiement par cartes actif et associé à votre boutique
CLIENT_704
| Code | CLIENT_704 |
| Définition | Vous devez charger Font Awesome dans la section HEAD |
| Catégorie | Avertissements |
Un champ additionnel utilise des icônes de font Awesome mais la librairie n'est pas chargée. Pour plus de détails, rendez-vous ici: Champs de formulaire personnalisés.
CLIENT_705
| Code | CLIENT_705 |
| Définition | viewport non défini ( |
| Catégorie | Avertissements |
La balise <meta>, via la directive "viewport" indique au navigateur la manière de contrôler les dimensions et l'échelle de la page à afficher.
Il est recommandé de l'utiliser sur l'ensemble des pages en HTML5.
CLIENT_997
| Code | CLIENT_997 |
| Définition | Erreur de configuration du Endpoint |
| Catégorie | Erreurs |
Le formToken a été créé sur une autre plateforme que celle où le client JavaScript a été téléchargé. L'URL d'appel aux web service REST doit être le même que celle du client JavaScript.
CLIENT_998
| Code | CLIENT_998 |
| Définition | FormToken de démo utilisé, paiement désactivé. Consultez la documentation pour obtenir un formToken réel. |
| Catégorie | Erreurs |
Le formulaire de paiement utilise un formToken de démonstration qui ne permet pas d'interaction avec le serveur. Utilisez un formToken valide : Charge/CreatePayment.
CLIENT_999
| Code | CLIENT_999 |
| Définition | Erreur technique |
| Catégorie | Erreurs |
Erreur inconnue, merci de contacter le support avec les informations suivantes :
- Numéro de boutique,
- URL du formulaire,
- Nom et version du navigateur,
- Type et version du système d'exploitation,
- Périphérique utilisé (Iphone 6S, PC, Ipad Pro ...),
- Date et heure de l'erreur.
