Commandes et remboursements Squarespace, chacun lié à la visite de l’acheteur.

01Ce que Tally lit

• Chaque commande payée, datée du jour où elle a été passée, comptée pour son total hors taxes : la livraison reste incluse, les remises sont déjà déduites, et le montant est lu au centime près dans la devise de la boutique.
• Chaque remboursement au jour où il a eu lieu, d’après les transactions de la commande, avec la quote-part de taxe de la commande, car Squarespace n’en enregistre aucune sur un remboursement.
• Les 365 derniers jours dès la connexion, puis chaque nouvelle commande en quelques secondes via un abonnement webhook, quand la boutique est connectée en un clic.
• Un rattrapage qui lit chaque commande modifiée depuis son dernier passage : toutes les 30 minutes pour une connexion en un clic, toutes les 10 pour une clé API, qui ne reçoit aucune notification.
• Uniquement ce dont les chiffres ont besoin : montants, dates, état du paiement et, sous forme hachée, l’e-mail du client et le numéro de commande. Noms, adresses, numéros de téléphone, lignes de commande, réponses aux formulaires et notes ne sont jamais stockés.

02Comment une vente retrouve sa visite

• Page de statut de commandeLes lignes de Tally dans les champs Order Status Page et Order Confirmation Page de Code Injection envoient le numéro de commande quand l’acheteur y arrive après le paiement. Il est haché dès réception et rapproché de la commande. Confiance élevée.
• E-mailSans ces lignes, l’e-mail du client sur la commande, haché dès sa lecture, lie la vente si votre site a appelé tally('identify') avec cette adresse. Confiance moyenne.
• RemboursementsUn remboursement reprend le lien de la commande Squarespace dont il restitue l’argent.

03Ce qu’il ne peut pas lire

04Le connecter

1. Sur la page Integrations de votre site, ouvrez Squarespace et choisissez Connect with Squarespace, puis Continue to Squarespace. Connectez-vous en tant que propriétaire ou administrateur du site, choisissez le site et cliquez sur Allow sur la page de confirmation de Squarespace.
2. La page de confirmation demande à lire les commandes et les transactions, hors ligne, pour que Tally continue de lire entre vos visites. Les 365 derniers jours arrivent, puis un abonnement webhook apporte chaque commande suivante.
3. Ou créez une clé API : dans Squarespace, Settings, Developer Tools, Developer API Keys, avec Orders et Transactions en lecture seule, puis collez-la dans le même panneau.
4. Dans Squarespace, ouvrez Pages, Custom Code, Code Injection. Collez le snippet dans Header, et les lignes de statut de commande ci-dessous dans les deux champs Order Status Page et Order Confirmation Page.
5. Vérifiez depuis une fenêtre privée, sans être connecté : un propriétaire connecté est envoyé vers l’éditeur et ne voit jamais la boutique comme un visiteur.

Ce dont la clé API a besoin

Tally demande une clé API qui ne peut faire que cela, et vérifie chaque autorisation par un vrai appel quand vous la collez, si bien qu’une autorisation manquante est nommée :

Comment la créer : le guide de Squarespace.

Les lignes de statut de commande (les champs Order Status Page et Order Confirmation Page)

{.if firstPageView}
<script>
  window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
  String('{orderId}').split(/[^0-9]+/).filter(Boolean).forEach(function (order) {
    tally('squarespace_order', { order: order });
  });
</script>
{.end}

05Questions fréquentes

• Tally modifie-t-il quoi que ce soit dans ma boutique ?

  Non. Il lit les commandes et leurs transactions, et crée un abonnement webhook pour recevoir les nouvelles commandes ; il ne modifie jamais une commande. Le code dans Code Injection se contente de compter les visites et d’envoyer le numéro de commande depuis la page de statut de commande.

• Pourquoi coller les mêmes lignes dans deux champs de page de commande ?

  Squarespace envoie les acheteurs de produits physiques, téléchargeables et de services vers sa page de statut de commande, et ceux de cartes cadeaux, d’abonnements et d’adhésions vers sa page de confirmation de commande. Avec les lignes dans les deux, chaque type de commande peut être lié à sa visite.

• Faut-il se connecter en un clic ou avec une clé API ?

  En un clic si vous le pouvez. Squarespace réserve les webhooks aux applications : une connexion en un clic voit chaque nouvelle commande en quelques secondes, alors qu’avec une clé, les commandes arrivent toutes les 10 minutes. Les deux importent les 365 derniers jours et lient les commandes de la même façon.

• Les commandes de test sont-elles comptées ?

  Non. Une commande passée pendant que le paiement du site est en mode test n’est pas une vente : elle n’entre pas dans les revenus. La première commande liée que vous verrez sur la page Sales est une vraie commande.

• Comment déconnecter Tally de ma boutique ?

  Dans le panneau Extensions de Squarespace, sous Connected extensions, ou sur la page Integrations de Tally ; les commandes déjà importées restent, avec leurs justificatifs. Déconnecter dans Tally ne le retire pas de la liste de Squarespace : déconnectez-le aussi là-bas.