Widget Carte cadeau

Vendre un bon cadeau en ligne, de la carte au destinataire.

Balise<hivebook-gift>DimensionsCarte de 350 px sur ordinateur · plein écran sur mobile

Le widget Carte cadeau reprend la même mécanique que le widget de réservation, en cinq étapes, mais sans calendrier ni capacité : le client choisit une carte, un montant, se présente, désigne un bénéficiaire et paie. Le bon généré est ensuite consultable dans Manager → Cadeaux.

1. Attributs

Attribut	Statut	Défaut	Rôle
`api_key`	Requis	—	Clé fournie par Hivebook, identifiant votre boutique.
`lang`	Optionnel	`fr`	Langue d’affichage : `fr` ou `en`.
`data-theme`	Optionnel	—	Thème visuel. Voir Thèmes.
`widget_title`	Optionnel	—	Titre affiché en en-tête du widget.
`widget_step1`	Optionnel	—	Libellé de l’étape 1, le choix de la carte.
`product_cat`	Optionnel	—	Restreint la liste à une catégorie de cartes cadeaux.
`product_id`	Optionnel	`-1`	Force une carte précise. `-1` affiche toutes les cartes.
`responsive`	Optionnel	`true`	`false` conserve la mise en page intégrée sur mobile.

Pas de calendrier. Le widget Carte cadeau n’accepte pas calendar_navigation : aucune date n’est choisie à l’achat. Le bénéficiaire choisira sa date plus tard, en utilisant son code dans le widget de réservation.

2. Exemple complet

HTML

<script src="https://cdn.hivebook.fr/widget/v3/loader.js" defer></script>

<hivebook-gift
  lang="fr"
  api_key="VOTRE_CLE_API"
  data-theme="light-cyan"
  widget_title="Cartes cadeaux"
  widget_step1="Choix de la carte cadeau"
  product_cat=""
  product_id="-1"
  responsive="true">
</hivebook-gift>

3. Le parcours client

Étape	Écran	Ce que le client y fait
1	Choix de la carte cadeau	Sélectionne la carte. Étape masquée si `product_id` est renseigné.
2	Montant	Saisit un montant libre dans les bornes autorisées, ou constate que le montant est fixe.
3	Coordonnées de l’acheteur	Prénom, nom, e-mail, téléphone, et éventuellement société et adresse de facturation.
4	Informations du destinataire	Prénom obligatoire ; nom, e-mail, téléphone et message facultatifs.
5	Récapitulatif	Vérifie carte, montant, date d’expiration, destinataire et message, saisit éventuellement un code promo, puis paie.

Pourquoi demander le destinataire ? Le widget l’explique au client : ces informations servent uniquement à le contacter, notamment si son bon cadeau approche de son expiration. Seul le prénom est obligatoire — un acheteur qui souhaite remettre le bon en main propre peut laisser le reste vide.

4. Montants proposés

Les bornes et l’incrément viennent du paramétrage de la Boutique, accessible aussi depuis Manager → Cadeaux → Cartes.

Configuration	Ce que voit le client
Montant libre activé	Un sélecteur borné par le minimum et le maximum, avançant par incréments, avec la mention du montant minimum.
Montant libre désactivé	Le message « Le montant de la carte cadeau est fixe » et le montant imposé.
Aucune carte publiée	Le message « Aucune carte cadeau disponible. Vérifiez votre configuration ».

« Aucune carte cadeau disponible ». Ce message n’est pas une erreur du widget : aucun produit carte cadeau n’est publié, ou la catégorie passée dans product_cat ne contient aucune carte, ou le product_id indiqué ne correspond pas à une carte cadeau.

5. Après l’achat

Le bon cadeau apparaît dans Manager → Cadeaux avec son code, son solde et sa date d’expiration.
L’état passe de Attente paiement à Actif dès l’encaissement confirmé.
Le bon est envoyé au destinataire si son e-mail a été renseigné ; sinon, l’équipe peut l’envoyer ou le remettre depuis la fiche.
Le PDF reste téléchargeable et renvoyable à tout moment depuis la fiche.
Le bénéficiaire saisit le code dans le champ Bon cadeau / Code promo du widget de réservation, ou le présente au comptoir.

Exemple — opération Noël. Publiez une carte cadeau « Noël », montant libre de 30 à 200 € par pas de 10 €. Posez <hivebook-gift product_id="…"> sur une page dédiée, avec le thème du site. Testez un achat au montant minimum, vérifiez l’e-mail reçu par le destinataire, puis consommez partiellement le bon sur une réservation pour contrôler le solde restant.