Cartes cadeaux et e-cartes
Un client achète une carte cadeau digitale et enregistre un message vidéo personnel pour l’accompagner. Le destinataire ouvre la carte et y découvre le message : un seul conteneur, un seul message, qui reste lié à la carte de l’achat jusqu’à l’ouverture.
Prérequis
Un jeton d’accès fourni par l’équipe Livstick, et un point de votre parcours d’émission de cartes cadeaux où vous pouvez appeler l’API côté serveur. Si vous n’avez pas encore de jeton, demandez un accès développeur.
Créer le conteneur de la carte cadeau
Utilisez le code de la carte cadeau comme crid, afin que le conteneur et la carte restent liés à la même référence. Si vous ne renseignez pas mode, il garde sa valeur par défaut : single, un seul message. Conservez tout de suite la valeur editKey de la réponse : elle n’est fournie qu’à la création.
curl -X POST https://client-api.v5.livstick.com/api/v3/containers \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ "crid": "GIFTCARD-4821", "language": "en_us" }'Faire enregistrer le message par l’acheteur
Intégrez le Recorder à l’étape où l’acheteur finalise l’achat de sa carte cadeau, en lui transmettant les valeurs urid et editKey du conteneur que vous venez de créer.
<livstick-widget-v2
uid="{urid from step 1}"
domain="example.com"
></livstick-widget-v2>
<script>
const widget = document.querySelector("livstick-widget-v2");
widget.editKey = "{editKey from step 1}";
</script>Récupérer l’URL pour votre e-mail de carte cadeau
Contrairement aux scénarios où Livstick envoie l’e-mail de remise, c’est ici votre propre e-mail de carte cadeau qui contient le lien : il n’y a donc pas d’appel à notify. Récupérez l’URL et insérez-la dans l’e-carte ou l’e-mail de carte cadeau que vous envoyez vous-même.
curl https://client-api.v5.livstick.com/api/v3/containers/GIFTCARD-4821/url \
-H "Authorization: Bearer {ACCESS_TOKEN}"Ce qui change par rapport aux autres scénarios
Comme c’est votre propre e-mail qui contient le lien, vous n’appelez jamais notify ni unlock dans ce scénario : ces appels servent quand Livstick assure la remise, ou quand le message doit rester verrouillé jusqu’à ce que vous le libériez. Si vous préférez ne pas intégrer le Recorder dans vos pages du tout, consultez le parcours hébergé, qui ne demande aucune intégration front-end.