Skip to main content
POST
/
api
/
subscriptions
/
checkout
curl -X POST "https://api.disparador.com/api/subscriptions/checkout?priceId=price_123&[email protected]&name=João Silva" \
  -H "Content-Type: application/json"
{
  "success": true,
  "message": "Sessão de checkout criada",
  "data": {
    "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_...",
    "session_id": "cs_test_a1b2c3d4..."
  }
}
Este endpoint permite que novos usuários criem uma conta contratando um plano. Após o pagamento, a conta é criada automaticamente e as credenciais são enviadas por email.
Para empresas existentes que desejam mudar de plano, use o endpoint Mudar Plano.

Query Parameters

priceId
string
required
ID do preço do plano na Stripe (ex: price_1234567890)
email
string
required
Email do novo usuário. Deve ser único no sistema
name
string
Nome completo do usuário ou empresa
curl -X POST "https://api.disparador.com/api/subscriptions/checkout?priceId=price_123&[email protected]&name=João Silva" \
  -H "Content-Type: application/json"
{
  "success": true,
  "message": "Sessão de checkout criada",
  "data": {
    "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_...",
    "session_id": "cs_test_a1b2c3d4..."
  }
}

Fluxo de Criação de Conta

  1. Usuário acessa a landing page e escolhe um plano
  2. Aplicação chama este endpoint com o priceId e email
  3. Usuário é redirecionado para o checkout seguro da Stripe
  4. Após pagamento aprovado, a Stripe envia webhook
  5. Sistema cria a conta automaticamente com:
    • Email fornecido
    • Senha temporária gerada
    • Tipo de registro: stripe_subscription
    • Assinatura ativa vinculada
  6. Email é enviado com as credenciais de acesso

Informações Importantes

Empresas criadas via checkout Stripe precisam manter uma assinatura ativa para acessar o sistema. Se a assinatura for cancelada ou o pagamento falhar, o acesso será suspenso.
Empresas registradas com senha admin (tipo admin_password) têm acesso ilimitado e não precisam de assinatura.

Produtos Disponíveis

Os produtos e preços disponíveis podem ser listados através do endpoint Listar Produtos.

Próximos Passos

Após o usuário completar o checkout:
  1. Ele receberá um email com as credenciais
  2. Poderá fazer login usando o endpoint Login
  3. Poderá gerenciar sua assinatura através do Portal de Faturamento
I