Etape 5 : Analyser le résultat du paiement

Objectif

• Analyser le résultat du paiement :

  • depuis l'IPN (Instant Payment Notification), lors d'un appel de serveur à serveur.

  • depuis le retour à la boutique.

I. Structure de la réponse

Paramètre	Description
kr-hash-key	Type de clé pour signer le kr-answer. Les valeurs possibles sont : password pour l'IPN / sha256_hmac pour le retour à la boutique.
kr-hash-algorithm	Algorithme utilisé pour calculer le hash. Sa valeur est sha256_hmac.
kr-answer	Objet contenant le résultat du paiement, encodé en JSON.
kr-answer-type	Type de l'objet JSON contenu dans kr-answer.
kr-hash	Hash de l'objet JSON stocké dans kr-answer. Il permet de vérifier l'authenticité de la réponse.

• Allez dans l'onglet Clés d'API REST, depuis le menu Paramétrage > Boutique pour récupérer vos clés.

II. Analyser l'IPN (Instant Payment Notification)

Il est impératif de récupérer et d'analyser les données de paiement de l'IPN.

• Récupérer le JSON de l'IPN (Paramètrage de l'IPN)
• Vérifier l'authenticité de la notification avec la valeur du kr-hash (2 ème clé du tableau des clés API REST )
• Vérifier le statut du paiement. Voir : Cycle de vie d'une transaction.

Plus d'infos: Analyse de l'IPN (URL de notification).

III. Analyser la réponse lors du retour à la boutique

Implémentez dans le HEAD le paramètre d'initialisation kr-post-url-success pour recevoir le résutat du paiement en cas de paiement réussi (Etape 4 : Afficher le formulaire de paiement).

Si l'acheteur paie avec un moyen de paiement différent de la carte (ou wallet) ou si l'acheteur réalise un paiement complémentaire, une fenêtre avec le ticket de paiement s'affiche. Pour masquer cette fenêtre, voir : lien.

• Récupérer le JSON posté sur le navigateur
• Vérifier l'authenticité de la notification avec la valeur du kr-hash (4 ème clé du tableau des clés API REST )
• Vérifier le statut du paiement. Voir : Cycle de vie d'une transaction.

Plus d'infos: Analyse du résultat du paiement via le retour à la boutique.

VI. Exemple simplifié PHP

Dans le dossier sample, les fichiers d'exemple sont :

1. ipn.php.
2. paid.php.

Pour avoir des informations complémentaires, cliquez sur: Fichiers d'exemple : ipn.php et paid.php