Widget & SDK

Embarque o programa de afiliados dentro do painel do seu próprio SaaS (o "indicar e ganhar") com poucas linhas, e leia o ?ref para anexar no checkout.

1. Carregue o afs.js

No HTML do seu painel. Ele persiste o ?ref da URL e expõe helpers globais (AFS.getRef(), AFS.renderReferralWidget()).

<script src="https://indicasaas.com/sdk/v1/afs.js"></script>
<div id="afs"></div>

2. Gere as chaves do SDK

No painel → Instalação → Chaves do SDK. A pk_ é pública; a sk_ é exibida uma vez — guarde e use só no backend.

3. Crie/recupere o afiliado (backend)

Do backend do seu SaaS, autenticando com a sk_ (nunca no front):

POST https://indicasaas.com/sdk/v1/affiliate
Authorization: Bearer sk_live_…
Content-Type: application/json

{ "email": "cliente@exemplo.com" }

→ { "affiliate": { "link": "…", "couponCode": "…", "status": "active" } }

4. Renderize o widget (front)

AFS.renderReferralWidget('#afs', {
  link: affiliate.link,
  coupon: affiliate.couponCode,
});

5. Anexe o ref no checkout

Quando o seu cliente (que veio por um link de afiliado) for pagar, leia o ref e mande pro seu backend para anexar no gateway:

const ref = AFS.getRef();        // click_id persistido do ?ref
// → enviar 'ref' ao seu backend e usar como na página do seu gateway

Stats do afiliado

GET https://indicasaas.com/sdk/v1/affiliate/stats?email=cliente@exemplo.com
Authorization: Bearer sk_live_…

→ { "stats": { "clicks", "conversions", "releasedCents", "heldCents", "paidCents" } }