Activation en magasin
En magasin, un client prend une carte physique sur laquelle un code est déjà imprimé. En le scannant ou en le saisissant, il arrive directement dans le parcours d’enregistrement (conteneur single, un message), sans jamais voir de formulaire lui demandant qui il est.
Prérequis
Un groupe de codes configuré pour votre lot de codes pré-imprimés — voir Groupes de codes.
Lister vos groupes de codes
Vérifiez à quel groupe de codes appartient votre lot de codes pré-imprimés. Cet appel nécessite le scope code_groups:read.
curl https://client-api.v5.livstick.com/api/v3/code-groups \
-H "Authorization: Bearer {ACCESS_TOKEN}"Créer le conteneur à l’avance
Créez le conteneur avant l’impression du code, en indiquant dans codeGroup le lot auquel il appartient. crid est la référence que vous suivez déjà pour ce code physique.
curl -X POST https://client-api.v5.livstick.com/api/v3/containers \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ "crid": "CARD-001", "codeGroup": "in-store-batch-2026", "language": "en_us" }'Résoudre le code à l’activation
Quand le code est scanné ou saisi, résolvez-le vers le parcours d’enregistrement avec le même crid. Cet appel est strictement en lecture seule : un crid inconnu renvoie une 404 au lieu de créer un conteneur à la volée.
curl https://client-api.v5.livstick.com/api/v3/containers/{crid}/redirect \
-H "Authorization: Bearer {ACCESS_TOKEN}"Pour aller plus loin
Cette page couvre le mécanisme exposé par l’API : le lot, le code, l’appel de résolution. Le parcours produit en magasin construit par-dessus (les écrans que voient un client ou un vendeur, le support physique, qui fait quoi au comptoir) n’est pas encore arrêté ; il sera documenté dès qu’il le sera.