Integre seu SaaS em 2 endpoints

Visão geral

O Afinny é um marketplace que conecta seu SaaS web com influencers que vendem por você. Você só precisa implementar 2 endpoints no servidor do seu SaaS:

1. Endpoint SSO — recebe usuários do Afinny via WebView/redirect com token JWT, valida o token e cria sessão local
2. Webhook receiver — recebe eventos de assinatura (criada, renovada, cancelada, etc.) e libera/revoga acesso ao seu SaaS

Esforço estimado: 2 a 4 horas de desenvolvimento. Compatível com qualquer stack web (Next.js, Laravel, Django, Rails, Express).

SSO (Single Sign-On)

Quando o usuário clica em "Abrir" no Afinny, ele é redirecionado pro seu SaaS com um token JWT na URL: https://app.seudominio.com/afinny/auth?token=JWT

Seu endpoint SSO precisa validar esse token chamando nossa API:

POST https://afinny.com/api/sso/validate
Headers:
  X-Api-Key: afny_live_xxxxxxxxxxx
  Content-Type: application/json
Body:
  { "token": "<jwt-recebido-no-?token=>" }

Response 200:
  {
    "valid": true,
    "user": {
      "id": "uuid",
      "email": "joao@email.com",
      "name": "João Silva"
    },
    "subscription": {
      "id": "uuid",
      "status": "active",
      "plan": "paid",
      "influencer_free": false,
      "trial_ends_at": null
    }
  }

Após validar, crie uma sessão local pra esse usuário e redirecione pro dashboard do seu SaaS. O token é multi-uso dentro de 1 hora — você não precisa gerar novo a cada request.

Webhooks

O Afinny envia eventos em tempo real pra um endpoint do seu servidor sempre que algo relevante acontece com uma assinatura. Configure seu webhook URL nas configurações do produto.

O Afinny faz 3 tentativas com backoff exponencial se o webhook falhar. Seu endpoint deve responder 200 OK em até 5 segundos.

API Keys

API keys autenticam as chamadas do seu servidor pra /api/sso/validate. Gerencie suas keys em /dashboard/api-keys.

• O valor da key é mostrado uma única vez ao gerar — salve em local seguro
• Trate a API key como senha — nunca exponha no frontend
• Você pode revogar a qualquer momento (não deleta histórico, só invalida)
• Use nomes descritivos pra identificar o ambiente (Produção, Staging, etc.)