Documentação
Tudo para integrar o IndicaSaaS: conectar seu billing, rastrear vendas por indicação e embarcar o widget. Multi-gateway — a plataforma registra e calcula as comissões; o repasse ao afiliado é feito pelo próprio SaaS.
Pagar.meAPI v5. Cobranças e assinaturas.
StripeStripe Connect (OAuth). Recorrência nativa.
Mercado PagoOAuth. Pix, boleto e cartão.
AsaasAPI-key. Pix, boleto e cartão.
AbacatePayAPI-key. Pix e cartão.
Widget & SDK"Indicar e ganhar" no seu painel + afs.js.
Início rápido (dono do SaaS)
- Crie seu SaaS no painel (vira seu "anunciante") e aceite o contrato.
- Conecte um gateway (Pagar.me, Stripe, Mercado Pago, Asaas ou AbacatePay) na aba Instalação — basta um.
- Crie um programa (comissão, recorrência, janela de cookie) e publique no catálogo.
- Instale o tracking: capture a referência antes do login e preserve-a até o checkout. Guia com exemplos
- Valide a primeira venda atribuída. Confira pagamento, conversão e comissão em ambiente de teste antes de operar. Cliques e webhooks recebidos não concluem essa prova.
Como funciona, em uma frase
O afiliado compartilha um link rastreável; no clique gravamos o click_id e mandamos o cliente pro seu site com ?ref; você anexa esse ref no checkout do seu gateway; o webhook assinado da venda chega ao IndicaSaaS e nós casamos o ref → registramos a conversão e calculamos a comissão. O pagamento ao afiliado é feito direto por você.
Superfícies & autenticação
O login é próprio do IndicaSaaS e independente da Central. O motor de comissões, os saldos e os repasses trabalham somente em BRL; pagamentos em outra moeda não geram comissão.
| Base | Auth | Uso |
|---|---|---|
/api/public/* | nenhuma | catálogo público |
/api/v1/* | cookie de sessão | marketplace (anunciante + afiliado) |
/sdk/v1/* | Bearer sk_… | widget — chamar do backend do seu SaaS |
/webhooks/* | assinatura do gateway | eventos de venda (não chamar à mão) |
Dúvidas frequentes
Como autentico na API?
O marketplace (/api/v1) usa o cookie de sessão do Better Auth. O SDK do widget (/sdk/v1) usa Bearer sk_live_… no backend do seu SaaS. O catálogo (/api/public) é aberto.
Como recebo eventos de venda?
Conecte um gateway no painel. Stripe/Mercado Pago via OAuth (webhook único multi-tenant); Pagar.me/Asaas/AbacatePay via API-key (webhook com token por merchant). A autenticação é sempre verificada.
Como funciona a atribuição?
Referência de indicação no link → metadata no gateway → webhook assinado. Primeiro ou último clique, com prazo por programa e validação no servidor.
O que é o refund-hold?
Comissões ficam retidas por um período (120 dias cartão / 7 dias Pix por padrão) antes de liberar, cobrindo reembolsos e chargebacks (clawback).
Os webhooks são idempotentes?
Sim — deduplicados por (conexão, event_id) e conversões por (conexão, charge_id), sempre escopados por tenant.