Server-side tracking for CCV Shop
Connect your CCV Shop API keys and press Create webhook. CCV then reports every paid order to ROASaurus, which sends it to your ad platforms from the server.
| CCV Shop at a glance | |
|---|---|
| Orders arrive by | Webhook (order paid) plus polling every 5 minutes |
| Webhook setup | Automatic, with the Create webhook button |
| Credentials | Public key and secret key from API gegevens |
| Request signing | HMAC-SHA512 on every API call |
| Thank-you snippet | Order success page, using Vertoshop.getOrder().getId() |
How CCV Shop connects
- Add the ROASaurus script to all pages: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, or an app code block in the header.
- Add the thank-you snippet to the order success page.
- Mijn webshop › Instellingen › Algemeen › API gegevens: copy the public key and secret key. If you don't see API gegevens, install the API app first.
- Enter both keys in ROASaurus, save, then press Create webhook.
What Create webhook does
ROASaurus registers a CCV webhook for the event order paid. CCV then reports each paid order straight away. When CCV returns a webhook secret, ROASaurus checks every delivery's HMAC-SHA512 signature; each delivery must also carry the token unique to your store. ROASaurus then fetches the full order and its order rows from the API.
Every API call ROASaurus makes is signed the way CCV requires: an HMAC-SHA512 hash of your public key, the method, the address, the body and a timestamp.
The 5-minute check
ROASaurus also asks CCV for paid orders every 5 minutes. CCV only filters on creation date, so an order that is marked paid days after it was placed is picked up by the webhook, not the check.
What ROASaurus reads from each order
The full order number, total, currency, customer email, mobile or phone number, name, billing city, zip and country, the customer id and each order row with its product number, quantity and price.
Limits
- CCV orders don't include the shopper's IP address, so the IP fallback isn't available. Add the thank-you snippet.
- Keep the webhook active: late payments rely on it.
- The connector is built from the platform's official API documentation. Press Test connection after saving your credentials, then place a test order and check the Event log.
Related
Questions, answered
Where do I find my CCV Shop API keys?
In Mijn webshop › Instellingen › Algemeen › API gegevens. If that menu is missing, install CCV's API app first.
What does the order success snippet do?
It reads the order id with Vertoshop.getOrder().getId() and fires the ROASaurus purchase with it, which links the order to the visitor and their ad click.
Are orders paid later still sent?
Yes, through the order-paid webhook. The 5-minute check only looks at recently created orders, so keep the webhook active.
Every sale, traced to the ad that earned it
Server-side tracking, profit and lifetime value in one app. 14-day free trial, no credit card.
Start your free trial →