Tracking API

# Lead (e.g. trial started)
curl -X POST https://revdeo.io/api/v1/track \
  -H "Authorization: Bearer rvk_live_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "lead",
    "external_id": "lead_8421",
    "click_ref": "<saved rv_ref>",
    "rev_link": "<saved rev_link — fallback when rv_ref is missing>"
  }'

# Sale (with revenue for %-bounties + ROI)
curl -X POST https://revdeo.io/api/v1/track \
  -H "Authorization: Bearer rvk_live_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "sale",
    "external_id": "order_8421",
    "click_ref": "<saved rv_ref>",
    "amount_cents": 4990,
    "currency": "EUR"
  }'

// Node 18+ (global fetch). Never from the browser — the key stays server-side.
const TRACK_URL = "https://revdeo.io/api/v1/track";
const API_KEY = process.env.REVDEO_API_KEY; // "rvk_live_YOUR_SECRET"

async function track(event, externalId, clickRef, extra = {}) {
  const res = await fetch(TRACK_URL, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      event,
      external_id: externalId,
      click_ref: clickRef,
      ...extra,
    }),
  });
  if (!res.ok) throw new Error(`Revdeo track failed: ${res.status}`);
  return res.json();
}

// Lead
await track("lead", "lead_8421", savedClickRef);
// Sale
await track("sale", "order_8421", savedClickRef, {
  amount_cents: 4990,
  currency: "EUR",
});

# Python (requests). Run on your server, not in the client.
import os
import requests

TRACK_URL = "https://revdeo.io/api/v1/track"
API_KEY = os.environ["REVDEO_API_KEY"]  # "rvk_live_YOUR_SECRET"

def track(event, external_id, click_ref, **extra):
    res = requests.post(
        TRACK_URL,
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json={
            "event": event,
            "external_id": external_id,
            "click_ref": click_ref,
            **extra,
        },
        timeout=10,
    )
    res.raise_for_status()
    return res.json()

# Lead
track("lead", "lead_8421", saved_click_ref)
# Sale
track("sale", "order_8421", saved_click_ref,
      amount_cents=4990, currency="EUR")

<?php
// PHP (curl). Server-side — the key must never reach the frontend.
$trackUrl = "https://revdeo.io/api/v1/track";
$apiKey = getenv("REVDEO_API_KEY"); // "rvk_live_YOUR_SECRET"

function rv_track(string $trackUrl, string $apiKey, array $payload): array {
    $ch = curl_init($trackUrl);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "Authorization: Bearer {$apiKey}",
            "Content-Type: application/json",
        ],
        CURLOPT_POSTFIELDS => json_encode($payload),
    ]);
    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    curl_close($ch);
    if ($status >= 300) throw new RuntimeException("Revdeo track failed: {$status}");
    return json_decode($body, true);
}

// Lead
rv_track($trackUrl, $apiKey, [
    "event" => "lead",
    "external_id" => "lead_8421",
    "click_ref" => $savedClickRef,
]);
// Sale
rv_track($trackUrl, $apiKey, [
    "event" => "sale",
    "external_id" => "order_8421",
    "click_ref" => $savedClickRef,
    "amount_cents" => 4990,
    "currency" => "EUR",
]);