Docs Primeiros Passos

Primeiros Passos

Configure a stryhub e faça sua primeira integração em menos de 5 minutos. Este guia orienta você na criação da conta, conexão com o Stripe, configuração de produtos e de webhooks.

Pré-requisitos: Você precisa de uma conta Stripe (teste ou produção). Se ainda não tem uma, crie aqui.

Passo 1: Crie Sua Conta

Cadastre-se na stryhub usando seu endereço de e-mail. Após o registro, você será direcionado ao painel administrativo, onde poderá gerenciar tudo.

  1. Acesse a página de registro da stryhub
  2. Insira seu e-mail e crie uma senha
  3. Confirme seu endereço de e-mail
  4. Faça login no painel administrativo

Passo 2: Conecte Sua Conta Stripe

A stryhub utiliza o Stripe Connect para processar pagamentos. Isso significa que os pagamentos dos seus clientes vão diretamente para a sua conta Stripe, com a taxa da plataforma descontada automaticamente.

  1. No painel, acesse Configurações
  2. Clique em Conectar Conta Stripe
  3. Você será redirecionado ao Stripe para autorizar a conexão
  4. Após a conexão, o status da sua conta Stripe aparecerá como "Ativo"
Seguro por padrão: Nunca armazenamos suas chaves secretas do Stripe. Todos os pagamentos são processados diretamente pelo Stripe usando sua infraestrutura segura.

Passo 3: Crie Seu Primeiro Produto

Produtos na stryhub representam o que você está vendendo — uma assinatura SaaS, uma compra única ou qualquer produto digital.

  1. Acesse Produtos no painel
  2. Clique em Novo Produto
  3. Preencha os detalhes do produto:
    • Nome: O nome do produto que seus clientes verão
    • Preço: Defina um preço único ou recorrente
    • Moeda: Escolha sua moeda
    • Intervalo de cobrança: Mensal, anual, etc. (para assinaturas)
  4. Clique em Criar

Após criar o produto, você receberá um link de checkout que pode compartilhar com clientes ou incorporar no seu site.

Passo 4: Configure um Endpoint de Webhook

Webhooks permitem que a stryhub notifique seu sistema em tempo real quando eventos acontecem (pagamentos, assinaturas, etc.).

  1. Acesse Webhooks no painel
  2. Clique em Nova Integração
  3. Insira a URL do seu endpoint (ex.: https://seu-app.com/webhooks/stryhub)
  4. Selecione quais eventos deseja receber
  5. Clique em Criar Integração

Você receberá uma chave de assinatura (signing secret, começa com whsec_). Guarde-a com segurança — você precisará dela para verificar a autenticidade dos webhooks.

Importante: Sua chave de assinatura é exibida apenas uma vez. Copie-a imediatamente e armazene-a com segurança (ex.: em variáveis de ambiente). Você pode regenerá-lo depois, mas a chave antiga deixará de funcionar.

Passo 5: Gere uma API Key

Se o seu SaaS precisa interagir com a stryhub de forma programática (criar checkouts, gerenciar assinaturas, listar produtos), você precisa de uma API Key.

  1. Acesse API Keys no painel
  2. Clique em Nova API Key
  3. Dê um nome descritivo (ex.: "Meu SaaS Produção")
  4. Copie a chave gerada (sk_live_...) — ela é exibida apenas uma vez
  5. Armazene-a com segurança nas variáveis de ambiente da sua aplicação
Segurança: A API Key é exibida apenas no momento da criação. A stryhub armazena apenas o hash SHA-256 — se você perder a chave, precisará gerar uma nova.

Com a API Key, você pode fazer requisições autenticadas à API REST da stryhub:

curl https://app.stryhub.com/api/v1/products \
  -H "Authorization: Bearer sk_live_sua_chave_aqui"

Endpoints disponíveis:

MétodoEndpointDescrição
GET/api/v1/productsListar produtos
GET/api/v1/prices/:productIdListar preços de um produto
POST/api/v1/checkoutCriar sessão de checkout
POST/api/v1/billing-portalCriar sessão do billing portal
GET/api/v1/subscription/:idBuscar detalhes de uma assinatura
POST/api/v1/subscription/:id/cancelCancelar uma assinatura
POST/api/v1/subscription/:id/upgradeFazer upgrade/downgrade de assinatura

Passo 6: Configure no Seu SaaS

Agora cole as credenciais nas configurações da sua aplicação:

  1. API Key (sk_live_...) — para acesso programático à API (opcional, apenas se seu SaaS usa a API REST)
  2. Webhook Signing Secret (whsec_...) — para verificar a autenticidade dos webhooks recebidos

Onde colar exatamente depende do seu SaaS. Normalmente há uma seção "Integração de Pagamentos" ou "Configurações de Billing" no painel admin. A API Key permite que seu SaaS chame endpoints da stryhub, e o Webhook Secret permite verificar que os webhooks recebidos realmente vieram da stryhub.

Passo 7: Teste Sua Integração

Antes de ir para produção, teste se tudo funciona corretamente:

  1. Na página de Webhooks, clique no botão Enviar Teste (ícone de raio) ao lado do seu endpoint
  2. Isso envia um evento ping para o seu endpoint
  3. Verifique os Logs para conferir o status da entrega
  4. Confirme que sua aplicação recebeu o webhook e respondeu com um código de status 2xx

Você também pode criar um checkout de teste:

  1. Use o modo de teste do Stripe com o cartão de teste 4242 4242 4242 4242
  2. Conclua um checkout de um dos seus produtos
  3. Verifique os logs de webhook — você deverá ver os eventos checkout.completed e payment.completed

Próximos Passos

Anterior Visão Geral