¿Para quién es esto?
Cualquier comerciante que ya tenga una cuenta de producción activa de CyberSource con Hosted Checkout y desee migrar a Unified Checkout puede hacerlo sin problemas. No se necesita una nueva cuenta de CyberSource: esto solo habilita un nuevo servicio en el ID de comerciante (MID) de producción existente y transfiere la configuración de OpenApply a dicho ID.
⚠️ En OpenApply , el modo CyberSource ( Hosted Checkout vs. Unified Checkout ) es una configuración única por escuela , no por usuario ni por sesión. En el momento en que se activa, todos los padres de esa escuela comienzan a usar el Pago unificado. Dado que no hay una implementación gradual ni una vista previa solo para el personal, planifique en consecuencia.
Lista de verificación
- Envíe una solicitud de configuración de MID para habilitar el pago unificado, la autenticación del pagador (3DS) y el administrador de decisiones en el MID de producción.
- Genera una nueva clave API REST una vez que el servicio esté aprobado.
- Durante un período de bajo tráfico: realice una copia de seguridad de las credenciales de Hosted Checkout y, a continuación, cambie OpenApply a Unified Checkout con la nueva clave y la casilla de verificación Decision Manager.
- Configura el webhook de Unified Checkout
- Valida con una transacción real y luego mantén la transición o revierte.
Paso 1: Activar el servicio (Habilitación del servicio)
En Business Center, abra Soporte → Centro de soporte :
Esto abre el Centro de soporte de Visa Acceptance Solutions. Vaya a Casos de soporte → Solicitud de configuración MID :
Envíe el formulario, marcando únicamente la opción de habilitación del servicio , y solicite:
- Proceso de pago unificado (API REST)
- Autenticación del pagador (3DS)
- Gestor de decisiones (si se requiere detección de fraude)
En la sección Entorno , marque Solo producción . Deje marcada la opción Privado .
Para cualquier pregunta específica sobre CyberSource, póngase en contacto directamente con el soporte técnico de CyberSource.
CyberSource procesa esto internamente (según su documentación pública, normalmente en un plazo de 3 días hábiles). Ningún otro paso de este manual puede continuar hasta que se apruebe, ya que tanto la clave REST creada en el paso 2 como la casilla de verificación del Administrador de decisiones en el paso 3 dependen de que estos servicios estén habilitados previamente en la cuenta del comerciante.
Paso 2: Genera y guarda la nueva clave de API REST.
⚠️ La clave de Pago Unificado no es la misma que la de Pago Alojado , aunque ambas pertenezcan al mismo comerciante/perfil. El Pago Alojado utiliza una clave de acceso de aceptación segura y una clave secreta; el Pago Unificado utiliza una clave API REST independiente (ID de clave + secreto compartido). Ambas se encuentran en ubicaciones diferentes en Business Center y no son intercambiables.
Una vez habilitado el servicio, vaya a Centro de negocios → Configuración de pagos → Gestión de claves :
Haz clic en + Generar clave :
Seleccione el tipo de clave REST - Secreto compartido , el tipo recomendado para las API REST que utiliza Unified Checkout:
Ignore las opciones heredadas de SCMP/SOAP Toolkit que aparecen a continuación (CyberSource las ha marcado como obsoletas) y haga clic en Generar clave :
Confirmar la generación:
Copie (o descargue) la clave y el secreto compartido inmediatamente, ya que CyberSource solo muestra el secreto compartido una vez:
Paso 3: Realice una copia de seguridad de Hosted Checkout y, a continuación, cambie OpenApply a Unified Checkout.
⚠️ Este paso redirige inmediatamente a todos los padres de la escuela al Sistema de Pago Unificado: la configuración del Modo se comparte en toda la escuela (consulte la advertencia en la parte superior) y no hay forma de probar el Sistema de Pago Unificado sin cambiar a él. Puede que le convenga realizar este paso hasta el Paso 5 de una sola vez, durante un período de baja actividad.
Antes de realizar cualquier cambio , abra la configuración de pagos de la escuela en el panel de administración OpenApply y guarde la configuración actual de Hosted Checkout (ID de comerciante, ID de perfil, clave de acceso, clave secreta) en un lugar seguro, por si fuera necesario revertir los cambios más adelante:
A continuación, cambie el modo a Pago unificado e introduzca los nuevos valores:
- ID de comerciante : mismo valor que antes; la cuenta del comerciante no cambia.
- Clave de acceso / Clave secreta : el ID de clave y la clave secreta compartida generados en el paso 2 ( no reutilice la clave de acceso/clave secreta de Hosted Checkout; consulte la advertencia en el paso 2).
- Tenga en cuenta que el ID de perfil desaparece en este modo: es un campo exclusivo de Hosted-Checkout, no utilizado por Unified Checkout.
- Entorno : seleccione Entorno en vivo
- Verifique ahora las transacciones de Screen con Decision Manager , si se incluyeron en la solicitud del Paso 1 y se aprobaron (haga esto antes del Paso 4: la suscripción al webhook se crea a partir de lo que indique esta casilla de verificación en el momento de la configuración).
Paso 4: Configurar el webhook
Primero, guarda la configuración de Pago Unificado del paso 3. Solo después de guardarla, ve a la misma pantalla de configuración (consulta la sección de webhook de Pago Unificado en la captura de pantalla anterior) y haz clic en Configurar webhook automáticamente . Esto genera y registra las credenciales de webhook cifradas, realiza una comprobación de estado y crea la suscripción. No se requieren pasos manuales en Business Center.
Paso 5: Validar con una transacción real, luego mantener la transición o revertir.
- Confirme que la nueva clave REST se haya guardado y que Decision Manager / 3DS / la suscripción al webhook estén todos activos para el MID de producción.
- Realice una pequeña transacción real y confirme: la autorización se realiza correctamente y el estado del cargo/factura se actualiza correctamente en OpenApply
- Si todo está correcto, la transición se mantiene sin cambios: no se requiere ninguna otra acción, los padres ahora pagan a través de Unified Checkout. Si algo parece incorrecto, revierta el proceso de inmediato.
Reversión: cambie el modo a Pago alojado y restaure las credenciales de las que hizo una copia de seguridad en el paso 3. Esto revertirá inmediatamente el modo de Pago alojado para todos los padres de la escuela.