Documentación de integración

Cómo conectar tu tráfico y tu producto a la red. Tiempo estimado: ~30 minutos.

1. Enlace de referido (tracking)

Usa tu refCode (lo ves en el Marketplace tras la aprobación):

https://{trackingDomain}/r?ref={refCode}&s1={sub1}&s2={sub2}&fbclid={fbclid}

El endpoint /r guarda una cookie (60 días) y redirige al landing con click_id.

2. Postback (Keitaro y compatibles)

Configura tu URL de postback en Ajustes → por oferta. Macros disponibles:

{clickid} {subid} {status} {event} {payout} {currency} {sub1}…{sub10} {txid}

Plantilla Keitaro recomendada:

https://tu-keitaro/postback?subid={clickid}&status={status}&payout={payout}&currency={currency}

Mapeo de estados: lead→lead, trial→lead, sale/rebill→sale, refund/chargeback→rejected.

El postback se dispara en cada evento, no solo en la venta. Los cambios de URL/píxel se aplican tras 24h (anti retro-atribución).

3. Píxel propio (FB CAPI)

En Ajustes pones tu FB Pixel ID + CAPI Token (se cifra) + Test Event Code. La red envía Lead / StartTrial / Purchase al Graph API con fbc desde fbclid y dedup por event_id.

4. Para dueños de producto (ej. Susurra)

Añade ~15 líneas a tu webhook de Stripe. En invoice.payment_succeeded:

await fetch(NETWORK_URL + "/api/ingest/conversion", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-Offer-Key": OFFER_KEY },
  body: JSON.stringify({
    click_id: subscription.metadata.click_id,
    user_ref: customer.id,
    event: invoice.billing_reason === "subscription_create" ? "sale" : "rebill",
    external_payment_id: invoice.payment_intent,   // idempotency
    gross_amount: invoice.amount_paid / 100,
    currency: invoice.currency.toUpperCase(),
    is_first_payment: invoice.billing_reason === "subscription_create",
  }),
});

En charge.refunded → /api/ingest/refund; en charge.dispute.created → /api/ingest/chargeback (body: { external_payment_id }).

5. Stats API (pull)

Genera un token en Ajustes y deja que tu tracker tire las conversiones por horario:

GET /api/affiliate/stats-api?token=...&offer=...&from=2026-06-01&format=csv

6. Pagos

Net-7 / semanal. Mínimo configurable (def. $50). Métodos: USDT, Wise, PayPal.

← Home

Integration documentation

How to connect your traffic and your product to the network. Estimated time: ~30 minutes.

1. Referral link (tracking)

Use your refCode (visible in the Marketplace after approval):

https://{trackingDomain}/r?ref={refCode}&s1={sub1}&s2={sub2}&fbclid={fbclid}

The /r endpoint stores a cookie (60 days) and redirects to the landing page with a click_id.

2. Postback (Keitaro and compatible)

Set your postback URL in Settings → per offer. Available macros:

{clickid} {subid} {status} {event} {payout} {currency} {sub1}…{sub10} {txid}

Recommended Keitaro template:

https://tu-keitaro/postback?subid={clickid}&status={status}&payout={payout}&currency={currency}

Status mapping: lead→lead, trial→lead, sale/rebill→sale, refund/chargeback→rejected.

The postback fires on every event, not just on the sale. URL/pixel changes take effect after 24h (anti retro-attribution).

3. Your own pixel (FB CAPI)

In Settings you set your FB Pixel ID + CAPI Token (encrypted) + Test Event Code. The network sends Lead / StartTrial / Purchase to the Graph API with fbc from fbclid and dedup by event_id.

4. For product owners (e.g. Susurra)

Add ~15 lines to your Stripe webhook. On invoice.payment_succeeded:

await fetch(NETWORK_URL + "/api/ingest/conversion", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-Offer-Key": OFFER_KEY },
  body: JSON.stringify({
    click_id: subscription.metadata.click_id,
    user_ref: customer.id,
    event: invoice.billing_reason === "subscription_create" ? "sale" : "rebill",
    external_payment_id: invoice.payment_intent,   // idempotency
    gross_amount: invoice.amount_paid / 100,
    currency: invoice.currency.toUpperCase(),
    is_first_payment: invoice.billing_reason === "subscription_create",
  }),
});

On charge.refunded → /api/ingest/refund; on charge.dispute.created → /api/ingest/chargeback (body: { external_payment_id }).

5. Stats API (pull)

Generate a token in Settings and let your tracker pull conversions on a schedule:

GET /api/affiliate/stats-api?token=...&offer=...&from=2026-06-01&format=csv

6. Payouts

Net-7 / weekly. Configurable minimum (default $50). Methods: USDT, Wise, PayPal.