Présentation détaillée du cashin
En tant qu'intégrateur d'une marketplace, vous aurez essentiellement à traiter des opérations dites de cashin, c'est-à-dire afférentes à la phase d'encaissement.
Pour mieux vous accompagner, voici la cinématique du déroulement d'un paiement sur la marketplace, depuis la création de la commande jusqu'à la remise des fonds.
| Etapes | Acteurs | Actions |
|---|---|---|
| 1 | Acheteur | Valide son panier sur le site de la Marketplace. |
| 2 | Marketplace | Créé un objet order via l'API REST (vue orders_create) contenant des articles. |
| 3 | Marketplace | Exécute l'order via l'API REST (vue orders_execute_payzen ou orders_execute_embedded). Cette requête prépare la page de paiement ou le token du formulaire embarqué et renvoie les informations nécessaires à leur appel. |
| 4 | Lyra Collet | 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 vendeur. Sinon, redirige l'acheteur vers l'URL renvoyée à l'étape 3. |
| 6 | Acheteur | Saisit ses informations bancaires (+ authentification 3D Secure sur les pages de paiement). |
| 7 | Lyra Collect | Valide et enregistre la transaction. |
| 8 | Lyra Collect | Met à jour le statut des items et de l'order. Si le paiement a abouti, les objets transactions de l'order sont créées à ce moment-là. |
| 9 | Lyra Collect | Envoie une notification à la Marketplace (et éventuellement au formulaire embarqué) indiquant que le statut de l'order a changé. |
| 10 | Marketplace | Appelle Lyra Collect pour connaitre le statut de l'order (orders_read) et met à jour son système. |
| 11 | Lyra Collect | Redirige l'acheteur vers la Marketplace (URL de retour donnée par la Marketplace = site vendeur). |
| 12 | Lyra Collect | Alimente le compte de paiement de la Marketplace et des vendeurs et synchronise l'état des objets. Les objets transfers sont générés à ce moment-là. |
| 13 | Lyra Collect | Notifie la Marketplace du changement de statut de l'order. |
| 14 | Marketplace | Appelle la plateforme de paiement pour connaitre le statut de l'order (orders_read) et met à jour son système. |