Gérer le dialogue vers le site marchand

La gestion du dialogue vers le site marchand est réalisée grâce à deux types d’URL :

  • Url de notification instantanée, également appelée IPN (Instant Payment Notification),
  • Url de retour vers le site marchand.

Url de notification instantanée - IPN (Instant Payment Notification)

La plateforme de paiement notifie automatiquement au site marchand le résultat du paiement. Les données sont envoyées en mode POST.

La plateforme est capable de contacter le site marchand quel que soit le protocole utilisé (http ou https).

Les notifications sont envoyées depuis une adresse IP comprise dans la plage 194.50.38.0/24 en mode Test et en mode Production.

Pour traiter ces notifications, le marchand doit créer une page sur son site qui :

  • analyse les données reçues en mode POST,
  • s’assure de l’intégrité des informations reçues en calculant la signature,
  • vérifie qu’il ne s’agit pas d’un doublon de notification (renvoi de la notification depuis le Back Office Expert par exemple),
  • déclenche la mise à jour de sa base de données (état de la commande, stock, etc.),
  • envoie des e-mails à l’acheteur (facture, suivi de commande, etc.).

Le temps de traitement influe directement sur le délai d’affichage de la page de résumé du paiement. Plus le traitement est long, plus l’affichage est retardé.

Pour recevoir les notifications, le marchand doit paramétrer les règles de notifications depuis son Back Office Expert (voir chapitre Paramétrer les notifications).

En cas de problème de communication vers le site marchand, la plateforme de paiement envoie un e-mail à l’administrateur de la boutique, précisant la raison de l’échec (erreur http, etc.) ainsi que la procédure à suivre pour renvoyer la notification depuis le Back Office Expert.

Url de retour vers le site marchand

Le marchand peut paramétrer dans le Back Office Expert les URL de retour "par défaut" depuis le menu Paramétrage > Boutique > onglet Configuration :

Figure 1. Spécification des URL de retour

Il peut configurer une URL de retour à la boutique différente en fonction du mode.

Par défaut, l'acheteur est redirigé vers l'URL de retour, et ce, quel que soit le résultat du paiement.

Si toutefois aucune URL n’est configurée à ce niveau, alors la redirection utilisera l'URL principale de la boutique (paramètre URL défini dans l'encadré Détails de la boutique).

Le marchand a la possibilité de surcharger cette configuration dans son formulaire de paiement (voir chapitre Définir les URL de retour).

Remarque :

Le statut de la règle "URL de notification à la fin du paiement" (IPN) est affiché dans cet écran. Si cette dernière est non paramétrée, veillez à la renseigner (voir chapitre Paramétrer les notifications).