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 :
- ipn.php.
- paid.php.
Pour avoir des informations complémentaires, cliquez sur: Fichiers d'exemple : ipn.php et paid.php