Comprendre le déroulement d'un paiement Marketplace

Ci-dessous la cinématique du déroulement d'un paiement sur la Marketplace :

Etapes Acteurs Actions
1 Acheteur Valide son panier sur le site de la Marketplace.
2 Marketplace

Créé un Order via l’API REST (POST ORDER) contenant des items.

3 Marketplace Fige l'Order via l'API REST (GET ORDER).

Finalise l'Order et prépare la page de paiement ou le token du formulaire embarqué.

4 Plateforme de paiement Créé le contexte de paiement de l'Order.

Si le formulaire embarqué est activé, retourne à la marketplace un token (form-token) à insérer dans le formulaire embarqué. Sinon, retourne à la Marketplace une URL pour rediriger l’acheteur vers la page de paiement.

5 Marketplace

Si le formulaire embarqué est activé, construit le formulaire sur la page du site marchand. Sinon, redirige l’acheteur vers l’URL donnée par la plateforme de paiement récupérée par le GET ORDER.

6 Acheteur

Saisit ses informations bancaires (+ authentification 3D Secure sur les pages de paiement).

7 Plateforme de paiement

Valide et enregistre la transaction.

8 Plateforme de paiement

Met à jour le statut des Items et de l'Order.

9 Plateforme de paiement

Envoie une notification à la Marketplace (et éventuellement au formulaire embarqué) indiquant que le statut de l’Order a changé.

10 Marketplace

Appelle la plateforme de paiement pour connaitre le statut de l’Order et met à jour son système (GET ORDER).

11 Plateforme de paiement

Redirige l’acheteur vers la Marketplace (URL de retour donnée par la Marketplace = site marchand).

12 Plateforme de paiement

Effectue la remise en banque de la transaction par carte bancaire (ou autre).

Créé les virements sur la boutique du Seller.

Envoie le fichier d'ordres de virement à la banque.

13 Plateforme de paiement

Notifie la Marketplace du changement de statut de l’Order et des Items.

14 Marketplace

Appelle la plateforme de paiement pour connaitre le statut de l’Order et met à jour son système (GET ORDER).

15 Marketplace Valide manuellement le fichier d'ordres de virement sur l'interface de sa banque.
16 Banque Exécute les virements demandés.

Le statut des ressources varie tout au long du déroulement d'un paiement.

  • Cycle de vie de la ressource Order

  • Cycle de vie de la ressource Item

  • Cycle de vie de la ressource Tokens
  • Cycle de vie de la ressource Refunds