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: '[email protected]',
        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

Cuenta de Stripe creada y verificada con email real
Claves API de prueba (pk_test_ y sk_test_) copiadas y seguras
Primera transacción de prueba ejecutada exitosamente
Dashboard de Stripe explorado: secciones de Payments, Customers y Developers
Webhook de prueba configurado y recibiendo eventos
Datos de prueba documentados y accesibles para el equipo
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.

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

Crear y Configurar una Cuenta de Stripe en Modo Prueba