Gérer les erreurs (client JS)

Cette page décrit le traitement des erreurs d'intégration et pour personnaliser la gestion des erreurs survenant lors du refus d'une transaction.

Comment sont affichées les erreurs ?

Pour le formulaire JavaScript, les erreurs sont automatiquement affichées dans la div kr-form-error :

https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L81-L82

    <!-- error zone -->
    <div class="kr-form-error"></div>

    <!-- error zone -->
    <div class="kr-form-error"></div>

Il vous suffit de l'ajouter.

Gérer les erreurs manuellement

Voir : Gérer les erreurs manuellement.

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_321	Numéro de carte requis
CLIENT_322	Date d'expiration requise
CLIENT_323	Code de sécurité requis
CLIENT_324	Le numéro de la pièce d'identité est requis
CLIENT_325	Nom du porteur requis
CLIENT_326	E-mail requis
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_516	Apple Pay doit être initié à la suite d'une interaction utilisateur
CLIENT_518	Paiement bloqué par votre navigateur. Veuillez essayer de nouveau ou autoriser l'ouverture de pop-ups
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 a été supprimé lors de l'appel à KR.addForm()
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 ne doit pas avoir la classe 'kr-embedded'. Vous devez créer la div 'kr-embedded' dans la div .
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: Etape 3 : Créer un formToken.

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.

Autre possibilité

Cette erreur peut aussi se déclencher si certaines Content Security Policy (CSP) bloquent le fonctionnement des pop-up. Pour autoriser les pop-up, utilisez la valeur same-origin-allow-popups dans le paramètre Cross-Origin-Opener-Policy. Ce paramètre se trouve dans la réponse du header du navigateur.

Voir la rubrique CSP : lien.

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_516

Code	CLIENT_516
Définition	Apple Pay doit être initié à la suite d'une interaction utilisateur
Catégorie	Erreurs

Cette erreur s'affiche si vous utilisez la fonction KR.openPaymentMethod().

La fonctionKR.openPaymentMethod() doit être appelée directement après le clic de l'acheteur. Il ne faut pas effectuer d'autres actions (comme des appels vers d'autres fonctions, du traitement de données, ...) entre le clic de l'acheteur et l'appel de la fonctionKR.openPaymentMethod(). Sinon, le navigateur (ou ApplePay) peut bloquer l'affichage de la pop-in (ou du pop-up) du moyen de paiement.

Ce mécanisme protège l'acheteur et empêche l'ouverture automatique de pop-in (ou pop-up) sans son interaction.

Pour intégrer ApplePay, testez en priorité les navigateurs les plus stricts, comme Firefox et Safari.

CLIENT_518

Code	CLIENT_518
Définition	Paiement bloqué par votre navigateur. Veuillez essayer de nouveau ou autoriser l'ouverture de pop-ups
Catégorie Erreurs

Cette erreur s'affiche si vous utilisez la fonction KR.openPaymentMethod().

Ce mécanisme protège l'acheteur et empêche l'ouverture automatique de pop-in (ou pop-up) sans son interaction.

Pour intégrer ApplePay, testez en priorité les navigateurs les plus stricts, comme Firefox et Safari.

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.

Catégories

Tags