Introduction

L’intégration de l’API Estaly repose sur 3 endpoints principaux, indispensables pour proposer des offres d’assurance tout au long du parcours d’achat de vos clients :

Affichage des offres d’assurance sur la page produit et le panier → List Offers
Synchronisation des données de commande avec Estaly → Create Plans pour signaler un paiement et Cancel Order en cas d’annulation

En complément, d’autres endpoints permettent d’optimiser davantage l’expérience client et d’améliorer les taux d’attachement des assurances :

Analyse avancée des commandes avec l’IA → Create Order permet d’envoyer l’ensemble des commandes, même sans assurance, pour optimiser les recommandations et affiner les taux d’attachement. Ces données ne contiennent pas d'informations personnelles et sont exclusivement utilisées à des fins d’analyse et ne sont jamais partagées.
Proposition d’une assurance en post-achat → Create Leads (bulk) pour offrir une souscription après l’achat via un lien de paiement.

Guide d'intégration

1. Créer les produits d'assurance sur votre Back Office

Utilisez l'endpoint List Offers pour récupérer tous les produits d'assurance disponibles pour votre Store. Vous pouvez aussi préciser la catégorie estaly pour récupérer les offres d'assurance disponible pour une catégorie en particulier.
Créer les produits d'assurance correspondant à chaque offre sur votre Back Office en utilisant les informations price et title.
Transmettez ensuite l'identifiant unique reference_id de chacun de ces produits (identifiants sur votre Back Office) à Estaly.

2. Intégrer l'offre d'assurance sur la page de vos produits et sur le panier

Utilisez l'endpoint List Offers pour récupérer les offres d'assurance disponibles pour un produit à partir de son prix et d'une catégorie d'assurance estaly.
Vous pouvez également récupérer les offres d’assurance disponibles pour un produit spécifique, à condition d’avoir synchronisé l’intégralité de votre catalogue. Cf. section #6.

3. Synchronisez vos données de commande avec Estaly

Utilisez l'endpoint Create Plans pour informer Estaly du paiement d'une assurance.
Utilisez l'endpoint Cancel Order pour informer Estaly d'une annulation de commande.
Utilisez l'endpoint Create Order pour informer Estaly d'une commande (optionnel). Permet de récupérer les articles de chaque commande afin d’optimiser les taux d’attachement.

4. Intégrez l'offre d'assurance en post-achat

Utilisez l'endpoint Create Leads (bulk) pour permettre à vos clients de souscrire à une assurance en post-achat.

📘
Synchronisez votre catalogue produit avec Estaly (optionnel)
Il est recommandé de récupérer les offres en fonction d’une catégorie d’assurance (ex: "smartphone") et du prix du produit, mais une synchronisation continue du catalogue reste envisageable pour les catalogues produit plus complexe.
En envoyant directement vos produits à Estaly, chaque offre d’assurance pourra être associée automatiquement via la référence produit, plutôt qu’en fonction du prix et de la catégorie d’assurance.

Utilisez l'endpoint Create Products pour envoyer l'intégralité de vos données de produits à Estaly.

Mettez en place une requête POST automatique vers le même endpoint Create Products chaque fois qu'un nouveau produit est ajouté à catalogue.

Mettez en place une requête PUT automatique vers l'endpoint Update Product à chaque fois que des mises à jour sont apportées aux produits de catalogue.