- Directives d'intégration
- Mise en œuvre d'une intégration Hosted Payment Form
- Hosted Payment Form avec modèle JavaScript
- Hosted Payment Form: Référence de l'API
- Gestion des erreurs de la page de paiement
Gestion des erreurs de la page de paiement
Cette page décrit les erreurs possibles que vous pouvez recevoir après avoir soumis la demande HostedForm.createSession( )/HostedForm.updateSession( ). Le champ « statut » contiendra une indication globale du succès ou de l'échec de la demande. Il est fortement recommandé de vérifier ce champ en premier car cela indique si des champs individuels contiennent des erreurs ou si une erreur plus générale s'est produite.
Si le champ de réponse global indique qu'il y a des erreurs de champ, vous devez alors vérifier la présence d'erreurs dans chaque champ de réponse.
Réponse globale au formulaire
La réponse globale du formulaire sera renvoyée dans le champ « statut ».
Il contiendra l'une des valeurs suivantes :
| Valeur | Description | Action en réponse |
|---|---|---|
| ok | Indique que le formulaire est valide — Renvoyé en l'absence d'erreurs de formulaire et signale que les détails de la carte ont été recueillis correctement et sont disponibles pour être utilisés dans une transaction. | Aucune gestion des erreurs requise — passez à l'exécution d'une transaction. |
| fields_in_error | Indique qu'un ou plusieurs champs sont en erreur — renvoyé si un champ du formulaire échoue à la validation. Les champs en erreur contiendront le code d'erreur spécifique. Voir la rubrique Erreurs de champ ci-dessous pour plus de détails. | Analysez les champs individuels pour détecter des erreurs spécifiques. Voir ci-dessous pour plus de détails. |
| system_error | Indique une erreur système — renvoyé en cas d'erreur de la passerelle de paiement ou d'autre défaillance irrécupérable. | Irrécupérable — Contactez ANZ Worldline Payment Solutions pour résoudre le problème. |
| request_timeout | Indique qu'un délai d'attente s'est produit lors de la création de la session. | Réaffichez la page de paiement au payeur pour fournir les détails de la carte et créer une nouvelle session. |
Erreurs de champ
La valeur renvoyée pour un champ erroné aura le format suivant :
{"field_name":"error_code", ...},
par exemple,
{cardNumber:"invalid", cardExpiryYear:"missing"}
Où error_code sera l'une des valeurs suivantes :
| Valeur | Description | Action en réponse |
|---|---|---|
| invalid | Indique une valeur de champ non valide — Renvoyé lorsque la valeur du champ est considérée comme non valide selon les règles de validation de champ de Hosted Payment Form. | Réafficher la page de paiement avec une erreur par rapport au champ erroné pour permettre au payeur de rectifier et de soumettre à nouveau. |
| missing | Indique un champ obligatoire non présent — Renvoyé lorsque la valeur du champ est vide. Applicable uniquement aux champs cardExpiryMonth et cardExpiryYear. |
Réafficher la page de paiement avec une erreur par rapport au champ erroné pour permettre au payeur de rectifier et de soumettre à nouveau. |