Send Server-Side Events

import crypto from 'node:crypto';

async function trackConversion({ scanSessionId, orderId, amount }) {
  const response = await fetch('https://track.scanova.io/server-events', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.SCANOVA_API_KEY,
    },
    body: JSON.stringify({
      site_id: process.env.SCANOVA_SITE_ID,
      event_name: 'purchase',
      event_id: crypto.randomUUID(),   // generate once and persist for retries
      scan_session_id: scanSessionId,
      conversion_value: { amount, currency: 'USD' },
      properties: { order_id: orderId },
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`Tracking failed: ${response.status} — ${JSON.stringify(error)}`);
  }
}

import os
import uuid
import requests

def track_conversion(scan_session_id: str, order_id: str, amount: float):
    response = requests.post(
        "https://track.scanova.io/server-events",
        headers={
            "Content-Type": "application/json",
            "X-API-Key": os.environ["SCANOVA_API_KEY"],
        },
        json={
            "site_id": os.environ["SCANOVA_SITE_ID"],
            "event_name": "purchase",
            "event_id": str(uuid.uuid4()),  # generate once, persist for retries
            "scan_session_id": scan_session_id,
            "conversion_value": {"amount": amount, "currency": "USD"},
            "properties": {"order_id": order_id},
        },
        timeout=10,
    )
    response.raise_for_status()

<?php
function trackConversion(string $scanSessionId, string $orderId, float $amount): void {
    $payload = json_encode([
        'site_id'          => getenv('SCANOVA_SITE_ID'),
        'event_name'       => 'purchase',
        'event_id'         => sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
                                mt_rand(0, 0xffff), mt_rand(0, 0xffff),
                                mt_rand(0, 0xffff), mt_rand(0, 0x0fff) | 0x4000,
                                mt_rand(0, 0x3fff) | 0x8000,
                                mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff)),
        'scan_session_id'  => $scanSessionId,
        'conversion_value' => ['amount' => $amount, 'currency' => 'USD'],
        'properties'       => ['order_id' => $orderId],
    ]);

    $ch = curl_init('https://track.scanova.io/server-events');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $payload,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'X-API-Key: ' . getenv('SCANOVA_API_KEY'),
        ],
    ]);

    $response = curl_exec($ch);
    $status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($status !== 200) {
        throw new RuntimeException("Tracking failed: {$status} — {$response}");
    }
}