Aller au contenu

Bonnes pratiques

  • Générez les codes au moment de la vente : n'appelez l'API qu'au moment où le client finalise son achat. Ne pré-générez pas de codes.
  • Conservez le partnerReference : c'est votre clé de réconciliation. Utilisez un identifiant unique de votre système (numéro de commande, ID de transaction, etc.).
  • Communiquez l'usageUrl : transmettez au bénéficiaire l'URL d'utilisation fournie par l'API. C'est le moyen le plus simple d'utiliser la carte ou le bon.
  • Gérez les annulations rapidement : si un client demande un remboursement, annulez la carte cadeau via l'API tant qu'elle est encore available.
  • Vérifiez les prix : pour les bons d'activité, assurez-vous que le unitPrice envoyé correspond au prix courant du listingItem (obtenu via GET /listing/{slug}). L'API accepte la création même en cas de différence, mais une alerte est générée côté Funbooker.