API Reference

Talivia has two kinds of API surfaces:

• Browser collection APIs used by the tracker.
• Server-side payment APIs for custom revenue ingestion.

Browser collection

The tracker sends page views, custom events, identify calls, and performance events to the collection endpoint. Prefer the browser script over calling this endpoint directly.

POST /api/send

Payload shape:

{
  "type": "event",
  "payload": {
    "website": "YOUR_WEBSITE_ID",
    "url": "/pricing",
    "title": "Pricing"
  }
}

Batch collection is also available for tracker internals:

POST /api/batch

Manual payments

Create an API key in Settings -> Payments and send confirmed payment events from your server.

POST /api/payments/manual
x-talivia-api-key: tlv_...

{
  "websiteId": "YOUR_WEBSITE_ID",
  "transactionId": "order_123",
  "amount": 49,
  "currency": "USD",
  "providerName": "manual",
  "visitorKey": "v_...",
  "sessionKey": "s_..."
}

Authentication

Manual payment API keys can be sent with x-talivia-api-key or a bearer token. The key must include the payments:write scope.

Response

The manual payment endpoint returns payment and attribution identifiers when the payment is recorded.