API reference

// Server-side only. The ingest secret belongs in an environment variable on your server.
// Never put it in browser code, a mobile app, a public repository or a front-end build.
async function reportPurchase({ orderId, amount, currency, email, visitorId, sessionId }) {
  const response = await fetch('https://thebizness.ai/api/conversions', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${process.env.THEBIZNESS_INGEST_SECRET}`,
    },
    body: JSON.stringify({
      websiteId: process.env.THEBIZNESS_WEBSITE_ID,
      name: 'Purchase',
      conversionUrl: 'https://yourdomain.com/checkout/success',
      amount, // in currency units, e.g. 99.99 (not cents)
      currency, // ISO code, e.g. 'USD'
      orderId, // a repeated orderId is recorded once, so retries are safe
      visitorId, // from the buyer's thebizness_visitor_id cookie
      sessionId, // from the buyer's thebizness_session_id cookie
      metadata: { email }, // the customer on the revenue record: send it from your server, never from the browser
    }),
  });

  // 429 and 5xx mean "not stored, try again". Anything else is final.
  if (response.status === 429 || response.status >= 500) {
    throw new Error(`theBizness.ai is unavailable (${response.status}), retry later`);
  }
  const result = await response.json();
  if (result.accepted === false) {
    console.warn('theBizness.ai did not record the sale:', result.reason);
  }
  return result;
}

import os
import requests

# Server-side only: keep the ingest secret in an environment variable.
response = requests.post(
    "https://thebizness.ai/api/conversions",
    headers={"Authorization": f"Bearer {os.environ['THEBIZNESS_INGEST_SECRET']}"},
    json={
        "websiteId": os.environ["THEBIZNESS_WEBSITE_ID"],
        "name": "Purchase",
        "conversionUrl": "https://yourdomain.com/checkout/success",
        "amount": 99.99,  # in currency units, e.g. 99.99 (not cents)
        "currency": "USD",
        "orderId": "order_123456",  # a repeated orderId is recorded once, so retries are safe
        "metadata": {"email": "[email protected]"},
    },
    timeout=10,
)

# 429 and 5xx mean "not stored, try again". Anything else is final.
if response.status_code == 429 or response.status_code >= 500:
    raise RuntimeError(f"theBizness.ai is unavailable ({response.status_code}), retry later")
result = response.json()
if result.get("accepted") is False:
    print("theBizness.ai did not record the sale:", result["reason"])

curl https://thebizness.ai/api/conversions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $THEBIZNESS_INGEST_SECRET" \
  -d '{
    "websiteId": "your-website-id",
    "name": "Purchase",
    "conversionUrl": "https://yourdomain.com/checkout/success",
    "amount": 99.99,
    "currency": "USD",
    "orderId": "order_123456",
    "metadata": { "email": "[email protected]" }
  }'