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
| Parameter | Required | Description |
|---|---|---|
| cnv_id | Yes | Click ID from redirect (click_id param). Alias: click_id |
| payout | No | Revenue in major currency units (e.g. 99.00). Default 0 |
| cnv_status | No | Conversion status label (e.g. lead, sale). Default lead |
| cnv_status2 | No | Secondary status (optional) |
| cnv_currency | No | Currency code. Default USD |
| order_id | No | Idempotency key. Defaults to click ID (plus event). Reuse on retries. |
| event | No | Conversion event, e.g. registration or ftd. Each event is its own conversion with its own count in reports |
| disable_postback | No | Set 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.