Aller au contenu
Livstick Développeurs

Trois points d’accroche dans un parcours d’achat

Où que se trouvent vos commandes — panier sur mesure, boutique headless, outil interne de gestion des commandes —, les trois mêmes moments reviennent. Chacun correspond à un appel simple et bien défini.

  • Confirmation de commande — créez le conteneur avec le numéro de commande comme crid, et proposez l’enregistrement à l’acheteur ou au destinataire.
  • Préparation ou expédition — générez le QR code ou la carte si le parcours est physique, sinon enregistrez le suivi du transporteur.
  • Livraison ou déballage — déclenchez la remise du message enregistré.

Utiliser votre numéro de commande comme crid

Le choix décisif de cette intégration se fait une seule fois, au premier appel : faites du numéro de commande le crid.

Points d’accroche et appels

Les trois mêmes moments, associés chacun à l’opération correspondante de l’API Client v3.

Points d’accroche du checkout
Moment Appel Effet
Confirmation de commande POST /containers Crée le conteneur avec le numéro de commande comme crid ; renvoie editKey une seule fois, pour proposer l’enregistrement.
Préparation ou expédition (physique) GET /containers/{crid}/qrcode ou GET /containers/{crid}/card Génère le QR code (PNG) ou la carte imprimable (PDF) à joindre à l’envoi.
Préparation ou expédition (non physique) PATCH /containers/{crid} Enregistre shipmentCarrier et shipmentCode sur le conteneur.
Livraison ou déballage POST /containers/{crid}/notify Déclenche la remise au destinataire.

Ce que vous devez prévoir de votre côté

Deux décisions relèvent de votre intégration, pas de Livstick.

  • Récupérez et stockez editKey dès la création du conteneur — il n’est renvoyé qu’à ce moment-là, et aucun endpoint ne permet de le récupérer ensuite. Sans lui, vous ne pourrez plus accorder d’accès en écriture à ce conteneur depuis un navigateur.
  • Décidez où l’acheteur ou le destinataire enregistre : à la confirmation de commande, depuis un lien que vous envoyez, ou plus tard au déballage via un QR code ou une carte. Ce choix détermine les points d’accroche que vous implémentez réellement.

Choisir votre variante

La forme exacte de ces points d’accroche — ce qui déclenche l’enregistrement, ce que voit le destinataire, le moment de la remise — dépend du parcours que vous construisez. Ces scénarios détaillent les variantes :