Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Não quer configurar isso manualmente? Cole um link para esta página em uma sessão do Devin e peça para ele configurar tudo para você.
1

(Opcional) Defina o escopo da base de código com o Ask Devin

Se você não tiver certeza de como seu app lida com pagamentos hoje — ou de quais arquivos e padrões você deve referenciar na sua spec — use o Ask Devin para investigar primeiro:Use as respostas para preencher sua spec — faça referência a arquivos específicos, nomes de tabelas e padrões, para que o Devin construa algo que se integre naturalmente à sua base de código. Você também pode iniciar uma sessão do Devin diretamente pelo Ask Devin, e ele levará tudo o que aprendeu como contexto.
2

Adicionar chaves de teste da Stripe

Devin precisa de chaves do Stripe em modo de teste para criar sessões de checkout e verificar o manipulador de webhook. Sempre use credenciais de sandbox — nunca forneça chaves do Stripe de produção para o Devin.A abordagem mais simples é armazená-las como segredos da organização antes de iniciar a sessão:
  1. Vá para Settings > Secrets e adicione:
  2. Devin acessa esses valores como variáveis de ambiente, portanto eles nunca ficam gravados diretamente no seu código-fonte.
Os segredos da organização devem ser adicionados antes de iniciar a sessão — eles são injetados no início da sessão. Alternativamente, você pode fornecer segredos durante a sessão usando o chat, e o Devin também solicitará proativamente qualquer credencial de que precisar quando encontrar variáveis de ambiente ausentes.
3

Entregue sua especificação de checkout

Cole sua especificação — de um PRD, um ticket do Linear ou uma mensagem detalhada no Slack — diretamente no Devin. Uma boa especificação de checkout cobre os planos de preços, o fluxo de pagamento e o que acontece após um pagamento bem-sucedido. Quanto mais estruturada, melhor.A good spec for Devin includes three things: what to build (pricing tiers, checkout flow, webhook handler), where it lives (routes, tables, files), and how it fits in (existing patterns to follow). You don’t need to specify every implementation detail — Devin investigates your codebase to fill in the gaps.
4

Devin builds and verifies in the browser

Devin lê sua spec, explora a base de código em busca de padrões correspondentes e depois implementa em toda a stack. Antes de abrir um PR, ele executa seu app localmente e abre seu navegador integrado para verificar se o fluxo de checkout funciona de ponta a ponta.Veja como isso fica no exemplo de checkout da Stripe:
  1. Cria a migration — Adiciona a tabela subscriptions com colunas para user_id, stripe_subscription_id, plan, status e current_period_end
  2. Cria a página de preços — Cria os três cartões de preço em /pricing, cada um com um botão “Subscribe” que envia uma requisição para a API de checkout
  3. Implementa a criação da sessão de checkout — Cria POST /api/checkout/sessions, que gera uma sessão do Stripe Checkout com o ID de preço correto, o e-mail do cliente e as URLs de redirecionamento
  4. Adiciona o manipulador de webhook — Implementa POST /api/webhooks/stripe com verificação de assinatura, tratamento do evento checkout.session.completed e atualizações no banco de dados
  5. Cria a página de sucesso — Cria /checkout/success, que busca a sessão do Stripe, exibe o nome do plano, o valor cobrado e um link “Go to Dashboard”
  6. Escreve testes — Testes para verificação da assinatura do webhook (válida, inválida, ausente), criação da sessão de checkout e lógica de atualização do plano no banco de dados
  7. Abre o navegador — Inicia o servidor de desenvolvimento, navega até /pricing, clica em “Subscribe” no nível Pro, verifica se o redirecionamento do Stripe Checkout funciona e confere se a página de sucesso é renderizada corretamente após um pagamento de teste
  8. Abre um PR — Entrega todas as mudanças com um resumo do que foi implementado e de como tudo foi verificado
A etapa de verificação no navegador captura problemas que testes de unidade não cobrem — um card de preços que não dispara o checkout, uma URL de redirecionamento que retorna 404 ou uma página de sucesso que falha ao carregar os detalhes da sessão. Se você definiu uma skill de testes local, Devin segue essas etapas automaticamente para cada funcionalidade que implementa.
5

Iterate from the PR

Once the PR is open, send follow-up prompts in the same session to extend or adjust the checkout flow.
6

Review the PR with Devin Review

Once Devin opens the PR, use Devin Review to review the changes. Devin Review has full context of your codebase and can catch bugs, security issues, and style inconsistencies across the diff. You can ask follow-up questions in the review chat — for instance, “Does the webhook handler validate the event type before processing?” — and Devin will answer grounded in the actual code.