Commandes et remboursements WooCommerce, chacun lié à la visite qui a fait la vente.

01Ce que Tally lit

• Chaque commande payée : en cours, terminée ou remboursée, ou annulée après avoir reçu une date de paiement. Le paiement à la livraison compte dès « en cours » ; les commandes en attente de paiement, en attente, échouées et les brouillons ne sont pas des ventes.
• Le total de la commande hors taxes, frais de port et frais inclus, remises déjà déduites, lu exactement dans la devise de la commande et converti en cents US au taux de la Banque centrale européenne du jour.
• Chaque remboursement au moment où il a été fait, avec la taxe restituée : un remboursement par article porte la sienne, un remboursement par montant restitue la quote-part de la commande.
• Les 365 derniers jours à la connexion, puis chaque commande en quelques secondes via deux webhooks ajoutés par Tally, commande créée et commande mise à jour.
• Un rattrapage toutes les 30 minutes, qui lit les commandes modifiées depuis le précédent et réactive un webhook désactivé : un envoi jamais reçu n’est jamais perdu.
• Uniquement ce dont les chiffres ont besoin : montants, dates, statut, remboursements et, sous forme hachée, la clé de commande et l’e-mail de facturation. Noms, adresses, numéros de téléphone et lignes de commande ne sont jamais stockés.

02Comment une vente retrouve sa visite

• Page « Commande reçue »Avec le snippet de Tally sur la boutique, la visite de l’acheteur sur la page « Commande reçue » lie la commande à ce visiteur : la clé de commande présente dans l’adresse de la page n’est conservée que hachée, puis rapprochée de la commande. Confiance élevée, sans rien à ajouter à WooCommerce.
• Identifiant du visiteur sur la commandeL’extension WordPress Tally enregistre l’identifiant du visiteur sur la commande au paiement, page classique ou en blocs : les acheteurs qui n’atteignent jamais cette page sont liés aussi ; sans l’extension, quelques lignes dans functions.php font de même. Confiance élevée, en mode avec cookie ou après consentement.
• E-mailL’e-mail de facturation, haché dès son arrivée, correspond à un appel tally('identify') sur votre site. Confiance moyenne.
• RemboursementsUn remboursement reprend le lien de la commande qu’il rembourse.

03Ce qu’il ne peut pas lire

04Le connecter

1. Sur la page Integrations de votre site, saisissez l’adresse de la boutique et choisissez Approve in WooCommerce, ou utilisez le bouton Connect WooCommerce to Tally de l’extension WordPress Tally. La boutique demande à un administrateur ou à un gestionnaire de boutique d’approuver Tally, et crée la clé elle-même.
2. Ou créez la clé à la main : dans WordPress, ouvrez WooCommerce, Settings, Advanced, REST API, choisissez Add key, réglez Permissions sur Read/Write, puis collez la consumer key et le consumer secret avec l’adresse de la boutique.
3. Read/Write sert uniquement aux deux webhooks de Tally ; la clé ne modifie jamais une commande. Elle est vérifiée auprès de la boutique, puis les 365 derniers jours arrivent, remboursements compris.
4. Installez l’extension WordPress Tally et collez votre Site ID : elle place le snippet sur chaque page, page « Commande reçue » comprise, et enregistre l’identifiant de visiteur de chaque acheteur sur la commande. Ou collez le snippet dans l’en-tête de votre thème.
5. Sans l’extension, ajoutez les lignes functions.php ci-dessous pour les acheteurs qu’une passerelle de paiement ne renvoie jamais vers la page « Commande reçue » ; la page Coverage les donne aussi.

Ce dont la clé d’API REST a besoin

Tally demande une clé d’API REST 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 WooCommerce.

Sans l’extension : l’identifiant du visiteur enregistré sur la commande (functions.php)

// Your theme's functions.php, or a code snippets plugin: saves the visitor's id on the
// order at checkout, for buyers who never reach the order-received page.
function tally_save_visitor_id( $order ) {
    $id = isset( $_COOKIE['_tally_vid'] ) ? $_COOKIE['_tally_vid'] : '';
    if ( preg_match( '/^[A-Za-z0-9_-]{8,64}$/', $id ) ) {
        $order->update_meta_data( 'tally_visitor_id', $id );
    }
}
add_action( 'woocommerce_checkout_create_order', 'tally_save_visitor_id' );
add_action( 'woocommerce_store_api_checkout_update_order_meta', 'tally_save_visitor_id' );

05Questions fréquentes

• Existe-t-il une extension WordPress ?

  Oui, l’extension WordPress Tally. Collez votre Site ID : elle ajoute le snippet à chaque page, exclut les administrateurs connectés, enregistre l’identifiant de visiteur de l’acheteur sur chaque commande WooCommerce au paiement, et son bouton Connect WooCommerce to Tally ouvre l’écran d’approbation de WooCommerce. Elle remplace les lignes functions.php.

• Puis-je me connecter sans copier de clés ?

  Oui. Saisissez l’adresse de la boutique sur la page Integrations et approuvez Tally sur l’écran même de WooCommerce : la boutique crée une clé Read/Write et la transmet, vous n’avez rien à copier. Révoquez-la à tout moment sous WooCommerce, Settings, Advanced, REST API.

• Et si l’envoi d’un webhook échoue ?

  WooCommerce ne réessaie pas un envoi, et désactive un webhook après une série d’échecs. Toutes les 30 minutes, Tally lit les commandes modifiées depuis son dernier passage et réactive un webhook désactivé : la commande arrive quand même.

• Cela fonctionne-t-il avec la page de paiement en blocs ?

  Oui. La page « Commande reçue » est la même après les deux types de paiement, et les lignes functions.php enregistrent l’identifiant du visiteur sur la page classique comme sur celle en blocs ; les deux ont été testées sur WooCommerce 11.2.

• Mon hébergeur supprime l’en-tête Authorization. La boutique se connectera-t-elle ?

  Oui. Quand une boutique répond comme si aucune clé n’avait été envoyée, Tally envoie plutôt la clé en paramètres de requête via HTTPS, comme le documente WooCommerce, et un site aux permaliens simples est joint via « ?rest_route= ».