Skip to content
DocsTracking & attributionServer-side conversions

Server-side conversions (postback)

This is the primary integration path — same model as Binom. When a conversion happens on your backend or affiliate network, call Capve with the click ID from the original visit.

Postback URL (GET)

Configure this URL in your affiliate network or fire it from your server:

https://capve.app/click?cnv_id={click_id}&payout={payout}&cnv_status={status}

Parameters

ParameterRequiredDescription
cnv_idYesClick ID from redirect (click_id param). Alias: click_id
payoutNoRevenue in major currency units (e.g. 99.00). Default 0
cnv_statusNoConversion status label (e.g. lead, sale). Default lead
cnv_status2NoSecondary status (optional)
cnv_currencyNoCurrency code. Default USD
order_idNoIdempotency key. Defaults to click ID (plus event). Reuse on retries.
eventNoConversion event, e.g. registration or ftd. Each event is its own conversion with its own count in reports
disable_postbackNoSet 1 to skip outgoing S2S postback for this conversion

Example

curl "https://capve.app/click?cnv_id=clk_a1b2c3&payout=49.00&cnv_status=sale&order_id=inv_001"

JSON API (POST)

For custom backends, use POST /api/v1/convert with X-Program-Secret. Prefer click_id over affiliate_code.

curl -X POST "https://capve.app/api/v1/convert" \
  -H "Content-Type: application/json" \
  -H "X-Program-Secret: sk_your_program_secret" \
  -d '{
    "order_id": "in_2026_000145",
    "amount": 99.00,
    "click_id": "clk_from_redirect_url"
  }'

Stripe webhook example

// Stripe webhook — checkout.session.completed
export async function onCheckoutCompleted(session) {
  const clickId = session.metadata?.click_id?.trim();
  if (!clickId) return;

  const orderId = session.id;
  const amount = (session.amount_total ?? 0) / 100;

  // Option A: Binom-style GET postback (no secret in URL)
  await fetch(
    `https://capve.app/click?cnv_id=${encodeURIComponent(clickId)}&payout=${amount}&cnv_status=sale&order_id=${orderId}`
  );

  // Option B: POST /api/v1/convert with campaign secret (server env only)
  // await fetch("https://capve.app/api/v1/convert", { ... body: { order_id, amount, click_id: clickId } });
}

S2S postback (outgoing)

In the dashboard, add outgoing postbacks to a campaign, traffic source or affiliate network, as many as you need, each optionally limited to one event. Capve fires them after each new or updated conversion with macros: {click_id}, {payout}, {status}, {event}, {affiliate_code}. See Postback URL.