Crear y Configurar una Cuenta de Stripe en Modo Prueba

Concepto clave

Crear una cuenta de Stripe en modo prueba es el primer paso esencial para implementar pagos recurrentes de forma segura. Piensa en esto como un laboratorio de desarrollo donde puedes experimentar con todas las funcionalidades de Stripe sin mover dinero real. Es similar a cuando un banco te da una tarjeta de crédito de entrenamiento para practicar transacciones antes de usar la real.

El modo prueba te permite simular pagos exitosos, fallidos, reembolsos y webhooks sin riesgo financiero. Stripe proporciona datos de prueba como números de tarjeta específicos (ej: 4242 4242 4242 4242 para pagos exitosos) y claves API separadas para pruebas y producción. Esta separación es crucial porque evita que datos reales se mezclen con pruebas, protegiendo tanto tu negocio como a los clientes.

Cómo funciona en la práctica

El proceso tiene tres etapas principales: registro, configuración básica y verificación de funcionalidad. Primero, vas al sitio de Stripe y te registras con un email válido. Luego, accedes al Dashboard donde encontrarás dos conjuntos de claves API: las públicas y secretas para pruebas (prefijadas con pk_test_ y sk_test_) y las de producción.

Paso a paso: 1) Completa el formulario de registro en stripe.com. 2) Verifica tu email. 3) Accede al Dashboard y navega a Developers > API keys. 4) Copia tus claves de prueba. 5) Configura tu entorno de desarrollo con estas claves. 6) Prueba una transacción simple usando los datos de tarjeta de prueba que Stripe proporciona.

Código en acción

Configuración inicial en Node.js con las claves de prueba:

// Antes: código sin configuración adecuada
// const stripe = require('stripe'); // Esto fallaría

// Después: configuración correcta con modo prueba
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

// Verificar que la configuración funciona
async function testConnection() {
    try {
        const balance = await stripe.balance.retrieve();
        console.log('Conexión exitosa. Modo:', balance.livemode ? 'Producción' : 'Prueba');
    } catch (error) {
        console.error('Error de conexión:', error.message);
    }
}

testConnection();

Crear un cliente de prueba para suscripciones:

// Crear un cliente en modo prueba
async function createTestCustomer() {
    const customer = await stripe.customers.create({
        email: 'cliente_prueba@ejemplo.com',
        description: 'Cliente para testing de suscripciones',
        metadata: {
            entorno: 'prueba',
            proyecto: 'curso_stripe'
        }
    });
    
    console.log('Cliente creado en modo prueba:', customer.id);
    return customer;
}

// Ejecutar la función
createTestCustomer().catch(console.error);

Errores comunes

• Mezclar claves de prueba y producción: Usar sk_test_ en producción o viceversa. Solución: Usar variables de entorno separadas para cada entorno.
• No verificar el modo de las transacciones: Asumir que todas las operaciones son de prueba. Solución: Siempre revisar el campo livemode en las respuestas de la API.
• Olvidar configurar webhooks para pruebas: Los webhooks de prueba requieren configuración específica. Solución: Usar el endpoint de pruebas del CLI de Stripe o configurar URLs separadas.
• No usar datos de prueba válidos: Intentar usar números de tarjeta reales en modo prueba. Solución: Usar siempre los números de prueba que Stripe documenta oficialmente.
• Ignorar las limitaciones del modo prueba: Algunas funcionalidades avanzadas pueden comportarse diferente. Solución: Leer la documentación específica para pruebas de cada endpoint.

Checklist de dominio

1. Cuenta de Stripe creada y verificada con email real
2. Claves API de prueba (pk_test_ y sk_test_) copiadas y seguras
3. Primera transacción de prueba ejecutada exitosamente
4. Dashboard de Stripe explorado: secciones de Payments, Customers y Developers
5. Webhook de prueba configurado y recibiendo eventos
6. Datos de prueba documentados y accesibles para el equipo
7. Plan de migración a producción definido (cuándo y cómo cambiar a claves reales)

Configura un entorno de pruebas completo para suscripciones

En este ejercicio, crearás un entorno de desarrollo completo para probar suscripciones recurrentes con Stripe.

1. Crea una cuenta en Stripe si no la tienes (usa un email real que puedas verificar)
2. Accede al Dashboard y navega a Developers > API keys
3. Copia tus claves de prueba (pública y secreta) y guárdalas en un archivo .env
4. Instala el CLI de Stripe y ejecuta stripe login para configurar webhooks locales
5. Crea un producto de prueba y un precio recurrente mensual usando la API
6. Simula una suscripción completa: cliente, método de pago, suscripción activa
7. Configura un webhook local que reciba eventos de suscripción
8. Prueba diferentes escenarios: pago exitoso, pago fallido, cancelación

Entrega: Código fuente con la configuración y capturas del Dashboard mostrando las transacciones de prueba.

Pistas

• Usa stripe products create y stripe prices create para definir tu oferta
• Para webhooks locales, stripe listen --forward-to localhost:3000/webhook es tu amigo
• Los eventos de prueba se generan automáticamente cuando usas datos de prueba

Evalua tu comprension

Completa el quiz interactivo de arriba para ganar XP.

Práctica acompañada: Una interfaz web de principio a fin

Estado, formularios y una API pequeña. Usa este cuaderno como práctica complementaria de la ruta; el material original de la lección continúa siendo tu referencia.

Práctica: cuatro pruebas de comportamiento

Prueba un título normal, solo espacios, 121 caracteres y una falla de red simulada. Registra la respuesta y el estado de la interfaz. Repite usando solo teclado: debes llegar al campo, enviarlo y encontrar el error sin usar el ratón.

Después agrega una segunda tarea y cambia el orden de la lista. Comprueba que cada botón sigue actuando sobre el elemento correcto. Si trabajas con microservicios, dibuja qué servicio posee el dato y qué ocurre si la dependencia no responde. No necesitas una infraestructura distribuida para aprender a definir tiempos de espera y errores comprensibles.

Comprueba tu entrega

Entrega el código, el contrato de API y evidencia de las cuatro pruebas. Indica si los datos se guardan o desaparecen al recargar. Una demostración en memoria debe decirlo para que nadie confunda un prototipo con almacenamiento persistente.

• Abrir el cuaderno ilustrado de 7 páginas
• Descargar PDF, ejercicios y plantillas de esta ruta
• MDN: aprendizaje de desarrollo web · recurso externo
• CS50 Web: HTML y CSS · inglés · video complementario externo