Report conversions

POST https://cli.gs/api/v1/track/conversion
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

curl -X POST https://cli.gs/api/v1/track/conversion \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ref": "01J9Z4K6V0QX8M2N3P5R7S9T1WABCD",
    "orderId": "100234",
    "amount": "149.99",
    "currency": "EUR",
    "customerType": "NEW"
  }'

// Node 18+. Call this from your order-paid handler.
async function reportConversion(order) {
  const res = await fetch("https://cli.gs/api/v1/track/conversion", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.CLIGS_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      ref: order.cligsRef,              // saved with the order at checkout
      orderId: String(order.id),
      amount: order.netSubtotal.toFixed(2),
      currency: "EUR",
      customerType: order.isFirstOrder ? "NEW" : "RETURNING",
      occurredAt: order.createdAt.toISOString(),
    }),
    signal: AbortSignal.timeout(5000),
  });

  if (res.ok) return res.json();                           // 200 or 201
  if (res.status >= 500 || res.status === 429) throw new Error("retry later");
  const err = await res.json().catch(() => ({}));
  console.error("cli.gs refused the conversion", res.status, err.error); // do not retry unchanged
}

<?php
function cligs_report_conversion(array $data): array {
    $ch = curl_init('https://cli.gs/api/v1/track/conversion');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 5,
        CURLOPT_HTTPHEADER     => [
            'Authorization: Bearer ' . getenv('CLIGS_API_KEY'),
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS     => json_encode($data),
    ]);
    $body   = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    curl_close($ch);
    return ['status' => $status, 'body' => json_decode((string) $body, true)];
}

$result = cligs_report_conversion([
    'ref'      => $order['cligs_ref'],
    'orderId'  => (string) $order['id'],
    'amount'   => number_format($order['net_subtotal'], 2, '.', ''),
    'currency' => 'EUR',
]);

<?php
// 1. At checkout: copy the ref code from the cookie onto the order.
function cligs_save_ref_on_order($order) {
    $ref = $_COOKIE['cligs_ref'] ?? '';
    if ($ref !== '' && preg_match('/^[0-9A-Za-z]{10,64}$/', $ref)) {
        $order->update_meta_data('_cligs_ref', $ref);
    }
}
add_action('woocommerce_checkout_create_order', 'cligs_save_ref_on_order'); // classic checkout
add_action('woocommerce_store_api_checkout_update_order_from_request', function ($order) { // block checkout
    cligs_save_ref_on_order($order);
    $order->save();
});

// 2. When the order is paid: report it. Runs server-side, also for background payment callbacks.
add_action('woocommerce_order_status_processing', function ($order_id) {
    $order = wc_get_order($order_id);
    $ref   = $order ? $order->get_meta('_cligs_ref') : '';
    if (!$ref || $order->get_meta('_cligs_reported')) {
        return;
    }

    // Net subtotal after discount, excluding tax and shipping.
    $amount = (float) $order->get_subtotal() - (float) $order->get_discount_total();

    $response = wp_remote_post('https://cli.gs/api/v1/track/conversion', [
        'headers' => [
            'Authorization' => 'Bearer ' . CLIGS_API_KEY, // define in wp-config.php
            'Content-Type'  => 'application/json',
        ],
        'body'    => wp_json_encode([
            'ref'        => $ref,
            'orderId'    => (string) $order->get_id(),
            'amount'     => number_format(max(0, $amount), 2, '.', ''),
            'currency'   => $order->get_currency(),
            'occurredAt' => $order->get_date_created()->format(DATE_ATOM),
        ]),
        'timeout' => 5,
    ]);

    $code = wp_remote_retrieve_response_code($response);
    if ($code === 200 || $code === 201) {
        $order->update_meta_data('_cligs_reported', 1);
        $order->save();
    }
});

{
  "ok": true,
  "conversionId": "cmg3x1q2w0001abcd9876efgh",
  "status": "PENDING",
  "commission": 12,
  "duplicate": false,
  "confirmed": false,
  "test": false
}