PayPal Sandbox a producción: client ID y suscripciones

Lleva tu integración de PayPal a producción con seguridad: cambia de Sandbox a live, actualiza tu client ID, valida el flujo de pago real y configura suscripciones desde el panel. Aquí encuentras los pasos esenciales, buenas prácticas y detalles para evitar errores y costos inesperados.

¿Cómo pasar de Sandbox a producción en PayPal sin errores?

Una vez que inicias sesión en tu cuenta real, ve al portal de desarrolladores y luego a dashboard. Por defecto verás Sandbox; cambia a live para trabajar en producción. Crea una app nueva, obtén su client ID y reemplázalo en tu código.

• Inicia sesión en tu cuenta de producción.
• En developers > dashboard, cambia a ambiente live.
• Crea la aplicación y copia el client ID de producción.
• Mantén dos ambientes: pruebas en Sandbox y producción en live.

¿Dónde crear la aplicación y obtener el client ID?

• Haz clic en desarrolladores y entra a dashboard.
• Cambia a live y crea la app con el nombre de tu proyecto.
• Copia el client ID generado para producción.

¿Cómo actualizar header.js y product.ejs?

En tu proyecto, ve a views/shared/header.js y sustituye el client ID de Sandbox por el de producción.

// views/shared/header.js
// Antes (Sandbox)
const PAYPAL_CLIENT_ID = 'SANDBOX_CLIENT_ID';

// Después (producción)
const PAYPAL_CLIENT_ID = 'PRODUCTION_CLIENT_ID';

Para hacer una compra de prueba mínima, en views/product.ejs, donde creas la orden, asigna un valor pequeño al monto.

// views/product.ejs (crear orden)
// Antes: amount toma el precio del producto (ej. 100)
// Prueba: forzar a 1 para validar el flujo real
amount: { value: '1' }

Al ejecutar y abrir el proyecto en el navegador, estarás en producción. La recomendación es probar en Sandbox localmente y hacer deploy solo cuando uses credenciales de producción.

¿Qué validar del cobro en producción con PayPal?

Al pagar, inicia sesión con una cuenta válida en producción. PayPal mostrará los instrumentos de pago disponibles y hará conversión de moneda automática si aplica. Tras confirmar, tu app redirige a la página de success y en el panel de administración verás la transacción en movimientos recientes.

• Verifica el monto mostrado antes de pagar.
• Confirma la redirección a la página success con el detalle de compra.
• Revisa el panel: transacción registrada y notificaciones como “imprimir etiqueta de envío”.
• Considera el saldo: puede ser bajo o cero si la comisión supera el monto cobrado.

Sobre costos, recuerda que la comisión puede ser significativa en montos muy bajos. El ejemplo mostró que un cobro de 1 peso quedó absorbido por la tarifa. Recomendación práctica: evita precios demasiado bajos y calcula siempre el impacto de la comisión (por ejemplo, 2.9 % + 0.60), para no quedarte corto al recibir tu dinero.

¿Cómo crear una suscripción en el panel y usar el plan ID?

Desde herramientas, entra a suscripciones. Primero crea un producto, luego un plan. Puedes usar un precio fijo mensual y activar el plan para generar el código del botón o copiar el plan ID para integrarlo en tu proyecto.

• Herramientas > suscripciones > crear producto.
• Define nombre, descripción, tipo de producto e industria.
• Crea un plan de precio fijo mensual (ej. 100 pesos al mes).
• Impuestos: opcional, se puede configurar el porcentaje sobre el total.
• Periodicidad: una vez al mes, sin mes de prueba si no lo requieres.
• Activa el plan y copia el plan ID.

Integra el plan ID en tu página de suscripción para que los cobros se hagan en producción.

// Ejemplo de integración de suscripción
paypal.Buttons({
  createSubscription: function (data, actions) {
    return actions.subscription.create({ plan_id: 'PLAN_ID_PRODUCCION' });
  }
}).render('#paypal-button-container');

Conceptos clave que aplicarás en el flujo: ambiente live, client ID de producción, movimientos recientes, conversión automática de moneda, comisión sobre el cobro, creación de producto y plan, activación del plan y uso del plan ID en tu implementación.

¿Te encontraste con un escenario distinto al configurar pagos o suscripciones? Cuéntalo en los comentarios y comparte cómo lo resolviste.