Integrazione con codice manuale

Visualizzare il widget di King-Avis

Per visualizzare il widget sul tuo sito basta integrare il seguente codice javascript prima della chiusura del tag </head> nel codice del tuo negozio, indicando i tuoi parametri personali legati al tuo account. Consulta l'esempio qui sotto:

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

31	= Negoziante ID
991bf70b65ba2b823dd8b50fd3621a2b8933b47d5	= Negoziante Token

Questi due valori sono separati da un trattino. Puoi ritrovare queste due informazioni direttamente nel tuo account cliente.

Aggiungere una richiesta di recensione

Affinché il processo di aggiunta di richiesta di recensione automatica funzioni, occorre che la tua piattaforma possa inviare ciascun ordine effettuato sul tuo negozio verso il sito King-Avis. Per questo raccomandiamo la tecnica di integrazione con PHP (con file_get_contents o CURL) eseguendo un url verso la nostra API. È necessario rispettare l'esempio di integrazione di seguito assegnando automaticamente i valori corretti a ciascun parametro. Quando si esegue questo codice, invierà automaticamente le informazioni sull'ordine alla piattaforma King-Avis.

<?php file_get_contents('https://king-avis.com/it/merchantorder/add?id_merchant=31&token=991bf70b65ba2b823dd8b50fd3621a2b8933b47d5&private_key=62af78aebuiod02e4e773b21e9bd4a7c54a2ab68&ref_order=17&email[email protected]&amount=57.230000&iso_currency=CHF&firstname=Germain&lastname=Tenthorey&iso_lang=it'); ?>

Un metodo alternativo è quello di utilizzare il metodo pixel in HTML attraverso un url integrato su un tag IMG:

<img src="https://king-avis.com/it/merchantorder/add?id_merchant=31&token=991bf70b65ba2b823dd8b50fd3621a2b8933b47d5&private_key=62af78aebuiod02e4e773b21e9bd4a7c54a2ab68&ref_order=17&email[email protected]&amount=57.230000&iso_currency=CHF&company=Webbax&firstname=Germain&lastname=Tenthorey&address=CP%20157&postcode=1926&city=Fully&iso_country=CH&phone=0277461981&date_order=2021-01-01%2010:01:32&iso_lang=it" height="0" width="0">

L'URL si scompone con i seguenti parametri:

https://king-avis.com/it/merchantorder/add?	: Il link di base deve essere prefissato come in questo esempio. Il valore "/it/" può essere sostituito con "/de/", "/en/", "/fr/".
id_merchant	Negoziante ID indicato nel tuo back-office King-Avis. Type : int Campo : obbligatorio
token	Negoziante Token citato nel tuo back-office King-Avis. Type : string Campo : obbligatorio
private_key	Negoziante Private Key citato nel tuo back-office King-Avis. Type : string Campo : obbligatorio
ref_order	numero / riferimento dell'ordine Type : string Campo : obbligatorio
email	indirizzo e-mail dell'acquirente Type : email Campo : obbligatorio
amount	ammontare totale dell'ordine Type : float Campo : obbligatorio
iso_currency	codice ISO della valuta (CHF, EUR, USD...) Type : string(3) Campo : obbligatorio
company	nome della società Type : string Campo : facoltativo
firstname	nome dell'acquirente Type : string Campo : obbligatorio
lastname	cognome dell'acquirente Type : string Campo : obbligatorio
address	indirizzo dell'acquirente Type : string Campo : facoltativo
postcode	codice postale dell'acquirente Type : string Campo : facoltativo
city	città dell'acquirente Type : string Campo : facoltativo
iso_country	codice iso del paese dell'acquirente (FR, CH, DE, IT...) Type : string(2) Campo : facoltativo
phone	n. di telefono dell'acquirente Type : string Campo : facoltativo
iso_lang	codice iso della lingua dell'acquirente (es. fr, de, en, it...) Type : string(2) Campo : obbligatorio
date_order	data dell'ordine Type : DateTime (Y-m-d H:i:s) Campo : facoltativo