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.
(Opcional) Delimita el alcance de la base de código con Ask Devin
Si no tienes claro cómo gestiona actualmente tu app los pagos, o qué archivos y patrones debes incluir en tu especificación, usa Ask Devin para investigar primero:Utiliza las respuestas para completar tu especificación; menciona archivos concretos, nombres de tablas y patrones para que Devin implemente algo que se integre de forma natural en tu base de código. También puedes iniciar una sesión de Devin directamente desde Ask Devin, y se conservará todo lo que haya aprendido como contexto.
Agregar claves de prueba de Stripe
Devin necesita claves de Stripe en modo de prueba para crear sesiones de checkout y verificar el controlador del webhook. Usa siempre credenciales de sandbox; nunca le des a Devin claves de Stripe de producción.El enfoque más sencillo es almacenarlas como secretos de organización antes de iniciar la sesión:
- Ve a Settings > Secrets y agrega:
STRIPE_SECRET_KEY— tu clave secreta en modo de prueba desde el Stripe DashboardSTRIPE_WEBHOOK_SECRET— el secreto de firma de tu configuración del endpoint de webhook
- Devin accede a estas como variables de entorno, por lo que nunca terminan incluidas directamente en tu código fuente.
Los secretos de organización deben agregarse antes de iniciar la sesión; se inyectan al inicio de la sesión. Alternativamente, puedes proporcionar secretos durante la sesión usando el chat, y Devin también te pedirá de forma proactiva cualquier credencial que necesite cuando detecte variables de entorno faltantes.
Pasa tu especificación de checkout
Pega tu especificación — ya sea desde un PRD, un ticket de Linear o un mensaje detallado de Slack — directamente en Devin. Una buena especificación de checkout cubre los niveles de precios, el flujo de pago y lo que ocurre después de un pago exitoso. Cuanto más estructurada, mejor.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.
Devin builds and verifies in the browser
Devin lee tu especificación, explora la base de código para encontrar patrones coincidentes y luego implementa en todo el stack. Antes de abrir una PR, ejecuta tu app localmente y abre su navegador integrado para verificar que el flujo de checkout funcione de principio a fin.Así es como se ve en el ejemplo de checkout con Stripe:
- Crea la migración — Agrega la tabla
subscriptionscon las columnasuser_id,stripe_subscription_id,plan,statusycurrent_period_end - Construye la página de precios — Crea las tres tarjetas de niveles de precios en
/pricing, cada una con un botón “Subscribe” que envía una solicitud a la API de checkout - Implementa la creación de la sesión de checkout — Construye
POST /api/checkout/sessions, que crea una sesión de Stripe Checkout con el ID de precio correcto, el correo electrónico del cliente y las URL de redirección - Agrega el controlador del webhook — Implementa
POST /api/webhooks/stripecon verificación de firma, manejo del eventocheckout.session.completedy actualizaciones en la base de datos - Construye la página de éxito — Crea
/checkout/success, que obtiene la sesión de Stripe, muestra el nombre del plan, el importe cobrado y un enlace “Go to Dashboard” - Escribe pruebas — Pruebas para la verificación de la firma del webhook (válida, inválida, ausente), la creación de la sesión de checkout y la lógica de actualización del plan en la base de datos
- Abre el navegador — Inicia el servidor de desarrollo, navega a
/pricing, hace clic en “Subscribe” en el nivel Pro, verifica que la redirección de Stripe Checkout funcione y comprueba que la página de éxito se renderice correctamente después de un pago de prueba - Abre una PR — Entrega todos los cambios con un resumen de lo que se implementó y cómo se verificó
Iterate from the PR
Once the PR is open, send follow-up prompts in the same session to extend or adjust the checkout flow.
Review the PR with Devin Review
Una vez que Devin abra la PR, usa Devin Review para revisar los cambios. Devin Review tiene todo el contexto de tu base de código y puede detectar bug, problemas de seguridad e inconsistencias de estilo en todo el diff. Puedes hacer preguntas de seguimiento en el chat de revisión — por ejemplo, “¿El controlador del webhook valida el tipo de evento antes de procesarlo?” — y Devin responderá basándose en el código real.
