Skip to main content

​
Modos de integração

Ao registrar seu produto na Easy Goal, você escolhe como gerenciar autenticação e pagamento.

Integrado

SSO + checkout 100% via Easy Goal. Menor fricção para o produtor — a EG cuida de tudo.

Externo

Você mantém seu próprio checkout (Kiwify, AbacatePay etc.). SSO da EG é opcional. Somente clientes com pagamento confirmado nos dois lados têm acesso.

​
Gateways disponíveis

A Easy Goal integra três gateways de pagamento: No modo integrado, o gateway efetivo pode variar por método de pagamento (PIX, boleto, cartão) através de uma matriz configurável no produto — não é mais uma escolha única por produto.
Vantagem de usar múltiplos gateways: se um gateway apresentar instabilidade, é possível migrar novos produtos (ou apenas um método de pagamento) para outro sem alterar a integração SSO ou a lógica do seu app.

​
Matriz de decisão

​
Como o SSO externo funciona

No modo externo com SSO opcional, a validação segue esta ordem:
  1. Usuário clica “Entrar com Easy Goal” no seu app
  2. SSO autentica e retorna eg_session (JWT com sub + email)
  3. Seu callback chama GET /api/saas/check-access com api_key + user_id + email
  4. Easy Goal verifica a assinatura vinculada à sua api_key:
    • Primeiro login: busca pelo email do comprador (identificado a partir do webhook Kiwify/AbacatePay)
    • Logins seguintes: busca por user_id (vinculado automaticamente no primeiro login)
  5. active: true → acesso liberado; active: false → redirecionar para checkout
O webhook de pagamento (Kiwify ou AbacatePay) deve ser configurado para notificar a Easy Goal além do seu próprio endpoint. O endereço do canal é POST /api/webhooks/kiwify/<api_key> — gerado quando você cria o API App.