Gérer les erreurs manuellement
Pour gérer les erreurs manuellement, vous pouvez intercepter le message d'erreur par defaut et le personnaliser.
Plusieurs possibilités existent :
- Avec la fonction KR.onError() Dans l'exemple suivant, le message d'erreur personnalisé sera placé dans la div de classe customerror :
https://github.com/lyra/rest-php-examples/blob/master/www/js_examples/jquery/minimalEmbeddedForm.onError.php#L70-L80
<script type="text/javascript">
$(document).ready(function() {
KR.onError( function(event) {
var code = event.errorCode;
var message = event.errorMessage;
var myMessage = code + ": " + message;
try {
/* if client answer exists, a refused transaction has been created */
/* it's not always the case. For example, if the form is empty, */
/* error is raised before transaction creation */Ensuite, personnalisez l'erreur avec la fonction KR.throwCustomError().
- Avec la fonction KR.setFormConfig
Utilisez l'attribut errorTemplate avec le code erreur à personnaliser.
Exemple pour personnaliser l'erreur ACQ_001:
await KR.setFormConfig({
errorTemplate: {
ACQ_001: "Motif du refus : errorMessage : detailedErrorCode"
}
})Intégrez ce(s) paramètre(s) dans une double accolade.
| Paramètres | Description |
|---|---|
| errorCode | Il permet d'identifier l'erreur courante (au format [PREFIXE]_[CODE]). |
| errorMessage | Explicite l'erreur correspondant au code. |
| paymentMethod | Nom du moyen de paiement (voir : le tableau des moyens de paiement) |
| detailedErrorCode | Code de l'erreur sous-jacente à l'origine de l'exception (ou null). |
| detailedErrorMessage | Message de l'erreur sous-jacente (ou null). |
| formId (*) | Identifiant du formulaire. |
(*)Ce paramètre est utile uniquement s'il y a plusieurs formulaires avec cette intégration embedded-form-glue.