Interpréter la réponse
Une fois que le payeur a terminé son interaction avec la Hosted Payment Page, vous devez le rediriger vers votre site Web, déterminer le résultat du paiement et lui remettre un reçu.
Étape 1 : Rediriger le payeur vers votre site Web
Une fois que le payeur a terminé son interaction avec la Hosted Payment Page, il est renvoyé vers votre site Web. Pour ce faire, vous devez fournir l'URL vers laquelle ils sont redirigés de l'une des manières suivantes :
- Fournissez le champ interaction.returnUrl dans l'opération Initiate Checkout.
- Définissez le rappel complet pour la Hosted Payment Page. Pour plus d'informations, voir Mise en œuvre des rappels.
Étape 2 : Déterminer le résultat du paiement
La passerelle envoie le résultat du paiement dans un champ resultIndicator de deux manières, selon la manière dont le payeur a été redirigé vers votre site :
- Ajouté à l'URL (interaction.returnUrl) utilisée pour renvoyer le payeur vers votre site Web.
- Fourni en tant que paramètre d'entrée à la fonction fournie dans le rappel complet ou ajouté à l'URL fournie dans le rappel complet.
Vous pouvez déterminer le succès du paiement en comparant le paramètre resultIndicator au paramètre successIndicator renvoyé dans la réponse INITIATE CHECKOUT. Une correspondance indique que le paiement a réussi.
Étape 3 : Afficher un reçu de paiement
Si l'opération a réussi, affichez un reçu de paiement au payeur sur votre site Web et mettez à jour votre système avec les détails du paiement. Vous pouvez récupérer les détails du paiement de différentes manières :
- Avec une requête API : utilisez l'opération Retrieve Order (Extraire la commande).
- Depuis Merchant Administration : les détails du paiement sont enregistrés dans Merchant Administration, sur la page Détails de la commande et de la transaction. Vous pouvez rechercher le paiement et effectuer des opérations ultérieures.
- À l'aide de Reporting : si la fonctionnalité Reporting est activée pour votre profil de commerçant, vous pouvez télécharger les données de paiement dans un rapport formaté depuis la passerelle.
- À partir de notifications par e-mail ou Webhook : si vous vous abonnez aux notifications dans Merchant Administration, vous recevez une notification par e-mail ou Webhook pour chaque paiement réussi.
Prenez le temps d'examiner les champs de réponse de transaction pour chaque opération pertinente dans la référence de l'API. Tous les champs fournissent des informations précieuses, vous pouvez en stocker certaines localement pour des raisons de comptabilité, de rapprochement et de traçabilité. Plus votre intégration est complexe, plus il peut être utile d'étudier des codes de réponse spécifiques pour identifier tous les aspects de l'état de la transaction.