Traiter le retour vers la Marketplace

Afin de rediriger l'acheteur vers la Marketplace, plusieurs attributs de la ressource ORDER peuvent être renseignés :

  • "url_return" est l'URL de retour par défaut. Vous pouvez n'utiliser que cet attribut si vous ne souhaitez pas différencier les cas de retour. Les attributs qui suivent surchargent sa valeur au cas par cas.
  • "url_success" est l'URL appelée si le paiement est un succès.
  • "url_refused" est l'URL appelée si le paiement est refusé.
  • "url_cancel" est l'URL appelée si le paiement est annulé.
  • "url_error" est l'URL appelée si le paiement est en erreur.

Par défaut, les données du paiement sont envoyées à l’URL de retour sous la forme d’un formulaire HTTP GET (dans la « query string »).

Exemple :

https://mymarketplace.com/return_to_shop?ref=1234&customer=ABCD

Ce comportement peut être surchargé via l'attribut "return_mode" qui peut prendre les valeurs suivantes :

  • 'NONE' : aucun paramètre n'est envoyé à l'URL de retour.
  • 'POST' : les paramètres sont envoyés à l'URL de retour sous la forme d'un formulaire HTTP POST (Si le retour boutique se fait sur un environnement non https alors le navigateur affichera un pop-up de sécurité à l’acheteur.)
  • 'GET' (par défaut) : Les champs de retour sont transmis à l’URL de retour sous la forme d’un formulaire HTTP GET (dans la « query string »).

Remarque : le retour vers la Marketplace doit uniquement vous permettre d'afficher un contexte visuel à l'acheteur. N'utilisez pas les données reçues pour effectuer le traitement en base de données, ni pour contrôler le statut du paiement.