Intégration en code manuel

Afficher le widget King-Avis

Pour afficher le widget sur votre site, il suffit d'intégrer le code Javascript suivant juste avant la fermeture de la balise </head> dans le code de votre boutique, en indiquant vos propres paramètres liés à votre compte. Consultez l'exemple ci-dessous :

<script type="text/javascript" src="https://www.king-avis.com/widgets/31-991bf70b65ba2b823dd8b50fd3621a2b8933b47d5.js"></script>

31 = Marchand ID
991bf70b65ba2b823dd8b50fd3621a2b8933b47d5 = Marchand Token
Ces deux valeurs, sont séparées par un trait d'union. Vous pouvez retrouver ces deux informations directement dans votre compte client.

Ajouter une demande d'avis

Pour que le processus d'ajout de demande d'avis automatique fonctionne, il faut que votre plateforme puisse envoyer chaque commande effectuée sur votre boutique, vers le site King-Avis. Pour cela nous préconisons la technique d'intégration avec PHP (avec file_get_contents ou CURL) en exécutant une url vers notre API. Vous devez respecter l'exemple d'intégration ci-dessous en assignant automatiquement les bonnes valeurs à chaque paramètre. Lorsque vous exécuterez ce code, cela enverra automatiquement les informations de la commande, vers la plateforme King-Avis.

<?php
file_get_contents('https://www.king_avis.com/fr/merchantorder/add?id_merchant=31&token=991bf70b65ba2b823dd8b50fd3621a2b8933b47d5&private_key=62af78aebuiod02e4e773b21e9bd4a7c54a2ab68&ref_order=17&email=customer@gmail.com&amount=57.230000&iso_currency=CHF&firstname=Germain&lastname=Tenthorey&iso_lang=fr');
?>


L'url se décompose avec les paramètres suivants :

https://www.king_avis.com/fr/merchantorder/add? : Le lien de base doit être préfixé comme cet exemple. La valeur "/fr/" peut être remplacée par "/de/", "/en/", "/it/".
id_merchant Marchant ID mentionné dans votre back-office King-Avis.
Type : int
token Marchant Token mentionné dans votre back-office King-Avis.
Type : string
private_key Marchand Private Key mentionné dans votre back-office King-Avis.
Type : string
ref_order numéro / référence de la commande
Type : string
email adresse e-mail de l'acheteur
Type : email
amount montant total de la commande
Type : float
iso_currency code ISO de la monnaie (ex. CHF, EUR, USD)
Type : string(3)
firstname prénom de l'acheteur
Type : string
lastname nom de l'acheteur
Type : string
iso_lang code iso de la langue de l'acheteur (ex. fr, de, en, it)
Type : string(2)