Suivi côté serveur pour CCV Shop
Connectez vos clés API CCV Shop et cliquez sur Create webhook. CCV signale alors chaque commande payée à ROASaurus, qui l’envoie à vos plateformes publicitaires depuis le serveur.
| CCV Shop en un coup d’œil | |
|---|---|
| Les commandes arrivent par | Webhook (commande payée) plus interrogation toutes les 5 minutes |
| Configuration du webhook | Automatique, avec le bouton Create webhook |
| Accès | Clé publique et clé secrète depuis API gegevens |
| Signature des requêtes | HMAC-SHA512 sur chaque appel API |
| Extrait de la page de remerciement | Page de succès de commande, avec Vertoshop.getOrder().getId() |
Comment CCV Shop se connecte
- Ajoutez le script ROASaurus à toutes les pages : Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, ou un bloc de code d’application dans l’en-tête.
- Ajoutez l’extrait de la page de remerciement à la page de succès de commande.
- Mijn webshop › Instellingen › Algemeen › API gegevens : copiez la clé publique et la clé secrète. Si vous ne voyez pas API gegevens, installez d’abord l’application API.
- Saisissez les deux clés dans ROASaurus, enregistrez, puis cliquez sur Create webhook.
Ce que fait Create webhook
ROASaurus enregistre un webhook CCV pour l’événement order paid. CCV signale alors chaque commande payée immédiatement. Quand CCV renvoie un secret de webhook, ROASaurus vérifie la signature HMAC-SHA512 de chaque livraison ; chaque livraison doit aussi porter le jeton propre à votre boutique. ROASaurus récupère ensuite la commande complète et ses lignes de commande depuis l’API.
Chaque appel API de ROASaurus est signé comme l’exige CCV : un hash HMAC-SHA512 de votre clé publique, de la méthode, de l’adresse, du corps et d’un horodatage.
La vérification toutes les 5 minutes
ROASaurus demande aussi à CCV les commandes payées toutes les 5 minutes. CCV ne filtre que sur la date de création : une commande marquée comme payée plusieurs jours après sa création est donc captée par le webhook, pas par la vérification.
Ce que ROASaurus lit dans chaque commande
Le numéro de commande complet, le total, la devise, l’e-mail du client, le numéro de mobile ou de téléphone, le nom, la ville, le code postal et le pays de facturation, l’identifiant client et chaque ligne de commande avec son numéro de produit, sa quantité et son prix.
Limites
- Les commandes CCV n’incluent pas l’adresse IP de l’acheteur : le repli par IP n’est donc pas disponible. Ajoutez l’extrait de la page de remerciement.
- Gardez le webhook actif : les paiements tardifs en dépendent.
- Le connecteur est construit d’après la documentation officielle de l’API de la plateforme. Cliquez sur Test connection après avoir enregistré vos identifiants, puis passez une commande de test et vérifiez l’Event log.
À lire aussi
Vos questions, nos réponses
Où trouver mes clés API CCV Shop ?
Dans Mijn webshop › Instellingen › Algemeen › API gegevens. Si ce menu est absent, installez d’abord l’application API de CCV.
Que fait l’extrait de la page de succès de commande ?
Il lit l’identifiant de commande avec Vertoshop.getOrder().getId() et déclenche avec lui l’achat ROASaurus, ce qui relie la commande au visiteur et à son clic publicitaire.
Les commandes payées plus tard sont-elles quand même envoyées ?
Oui, via le webhook de commande payée. La vérification toutes les 5 minutes ne regarde que les commandes créées récemment : gardez donc le webhook actif.
Chaque vente, rattachée à la publicité qui l’a générée
Suivi côté serveur, bénéfice et valeur vie client dans une seule application. Essai gratuit de 14 jours, sans carte bancaire.
Démarrez votre essai gratuit →