Presentación
La pasarela de pagos Cybersource es un método de pago autorizado que puede utilizarse con las funciones de comercio electrónico de su plataforma.
Este artículo explica cómo configurar un perfil de cuenta para su plataforma en Cybersource y cómo configurar la integración de Cybersource en la plataforma.
Requisitos previos
La integración de Cybersource está disponible en la plataforma con el paquete de comercio electrónico. Póngase en contacto con su representante de Docebo para más información sobre cómo obtenerlo.
Para realizar las configuraciones descritas en este artículo, necesitará disponer previamente de una cuenta de Cybersource:
- Puede utilizar una cuenta de prueba, a crear en el centro de desarrolladores de Cybersource (se abre en una nueva pestaña), para acceder al portal de pruebas de Cybersource y configurar una integración en un entorno sandbox.
- A continuación, tendrá que contactar con Cybersource (se abre en una nueva pestaña) para configurar su cuenta de comerciante. Esto le servirá para acceder al portal de producción de Cybersource, donde configurará la integración "en vivo" para aceptar pagos reales.
Asimismo, si tiene previsto utilizar la función de cálculo automático de impuestos de Cybersource, tendrá que contactar con Cybersource para que active el cálculo de impuestos para su cuenta.
Requisitos y limitaciones
- Es posible que algunas divisas admitidas por Docebo no sean admitidas por Cybersource, por lo que debe comprobar si ambos sistemas admiten la suya antes de continuar. Consulte la lista completa de divisas admitidas por Docebo.
A tener en cuenta: En este momento, en modo sandbox, la pasarela de pago Cybersource acepta solo dólares estadounidenses. Cuando esté en modo activo, se aceptarán todas las divisas admitidas.
- Al trabajar con Extended enterprise, configure los ajustes de Cybersource en el dominio raíz. Si hay dominios que requieran una configuración diferente, aplique esta configuración a nivel local, en la pestaña Comercio electrónico de la aplicación Extended enterprise.
- Cybersource requiere el nombre y los apellidos del comprador para completar la transacción. Estos campos se toman del perfil del usuario en la plataforma, no se introducen en el paso de la información de facturación. Por lo tanto, para poder utilizar Cybersource, los usuarios deben tener los campos de nombre y apellidos rellenados en su perfil.
- Al utilizar el cálculo automático de impuestos de Cybersource, tenga en cuenta que el carrito de la compra de la plataforma mostrará el total sin impuestos añadidos. No obstante, cuando el usuario sea redirigido a Cybersource para completar el pago, también verá los impuestos añadidos y el nuevo total.
Configuración de un perfil en Cybersource
Este capítulo abarca las configuraciones que deben realizarse en Cybersource. Deberá completar estos ajustes antes de poder configurar su integración con Cybersource en la plataforma.
Creación de un perfil de aceptación segura
El primer paso es crear un perfil de aceptación segura para su plataforma en Cybersource.
A tener en cuenta: Debe crear dos perfiles de aceptación segura separados para sus entornos en vivo y sandbox.
- El perfil sandbox, que se utiliza con fines de prueba, se crea en el portal https://ebc2test.cybersource.com/ebc2 (se abre en una nueva pestaña)
- El perfil de producción, utilizado para transacciones reales, se crea en el portal https://businesscenter.cybersource.com/ebc2/ (global) o https://businesscenter.in.cybersource.com/ebc2/ (India) (se abren en una nueva pestaña)
Puede acceder al portal de pruebas (sandbox) con una cuenta de prueba de Cybersource. Sin embargo, para acceder al portal de producción, debe tener una cuenta de comerciante de Cybersource. Para obtener más información, consulte los requisitos previos.
Para crear un perfil de aceptación segura, inicie sesión en Cybersource (en el portal sandbox o de producción) y, en el menú de la izquierda, vaya a Configuración de pagos > Configuración de aceptación segura. Esto abrirá la página Configuración de aceptación segura, con una lista de todos los perfiles ya existentes.
Nota: Para ver o editar la configuración de un perfil existente, puede hacer clic en el botón de puntos suspensivos junto a su nombre en la lista y seleccionar la acción correspondiente.
Para crear un nuevo perfil, haga clic en el botón Nuevo perfil y, en el panel Crear perfil que se abrirá, introduzca los detalles necesarios para el perfil que esté creando:
- En el área Métodos de integración, seleccione Pago alojado.
- En Servicios de valor añadido, asegúrese de que las opciones Tokenización de pagos y Gestor de decisiones estén desactivadas.
Cuando haya terminado, haga clic en Enviar.
Su nuevo perfil se creará y abrirá automáticamente en la página de configuración.
Generación de una clave de seguridad para el perfil de aceptación segura
Ahora necesita generar una clave de seguridad para su perfil. En la página de configuración de su perfil, seleccione la pestaña Seguridad y, en el área Claves activas, haga clic en Crear clave. En el panel que se abrirá, defina un nombre para su clave y, a continuación, establezca la Versión de firma en 1 y el Método de firma en HMAC_SHA256. Cuando esté listo, haga clic en Crear, y en la ventana que se abrirá, haga clic en Confirmar.
Al final del proceso de creación, Cybersource le mostrará la clave secreta y la clave de acceso necesarias para configurar la integración entre Docebo y Cybersource. Las claves tienen un periodo de validez de dos años.
También puede volver a acceder a estos valores en cualquier momento haciendo clic en Ver clave junto al nombre de la clave.
Consejo: Tendrá que introducir esta clave secreta y la clave de acceso, junto con su ID de perfil de Cybersource (visible en la parte superior de la página del perfil), al configurar Cybersource en la plataforma.
Configuración de pagos
Ahora, vaya a la pestaña Configuración de pagos. Aquí deberá establecer los distintos tipos de tarjetas que desee aceptar y, para cada una, las divisas admitidas y el método de verificación de la tarjeta.
Respuesta al cliente
Vaya ahora a la pestaña Respuesta al cliente, establezca las opciones Página de respuesta de la transacción y Página de respuesta de cancelación personalizada como Alojadas por usted y configúrelas como sigue:
Página de respuesta de la transacción: [URL completa de su plataforma]/ecommerce/v1/cybersource/validate
Página de respuesta de cancelación personalizada: [URL completa de su plataforma]/ecommerce/v1/cybersource/decline
Donde la [URL completa de su plataforma] puede ser:
- una URL docebosaas, por ejemplo https://myplatform.docebosaas.com
- un dominio personalizado o secundario, por ejemplo https://learn.mycompany.net
- un cliente de la empresa extendida de tipo carpeta, por ejemplo https://myplatform.docebosaas.com/[folder_name]
A continuación se proporcionan algunos ejemplos.
URL de la plataforma Docebosaas
- Página de respuesta de la transacción = https://[platform_name].docebosaas.com/ecommerce/v1/cybersource/validate
- Página de respuesta de cancelación personalizada = https://[platform_name].docebosaas.com/ecommerce/v1/cybersource/decline
Dominio personalizado (o dominio secundario)
- Página de respuesta de la transacción = https://[custom_domain]/ecommerce/v1/cybersource/validate
- Página de respuesta de cancelación personalizada = https://[custom_domain]/ecommerce/v1/cybersource/decline
Cliente de la empresa extendida de tipo carpeta
- Página de respuesta de la transacción = https://[platform_name].docebosaas.com/[folder_name]/ecommerce/v1/cybersource/validate
- Página de respuesta de cancelación personalizada = https://[platform_name].docebosaas.com/[folder_name]/ecommerce/v1/cybersource/decline
Notificaciones para comercios
Para mejorar la fiabilidad de su integración, se recomienda encarecidamente configurar el ajuste Notificaciones para comercios en la pestaña Notificaciones.
Introduzca la siguiente URL en el campo Notificaciones para comercios: https://[platform_name].docebosaas.com/ecommerce/v1/cybersource/notify
Habilitando este ajuste, se asegura que se devuelvan a la plataforma de forma consecuente las actualizaciones de estado de los pedidos y los resultados de las transacciones. Ayuda a impedir que las transacciones se queden en un estado Pendiente debido a retrasos en la red, tiempos expirados u otros problemas en las comunicaciones.
Configuración de Cybersource para el cálculo automático de impuestos
Complete estos pasos si desea utilizar la función que calcula automáticamente los impuestos en el momento de pagar.
→ Recuerde que, para utilizar esta funcionalidad, debe solicitar a Cybersource que habilite la función de impuestos para su cuenta. Consulte los Requisitos previos.
Vaya a la pestaña Formulario de pago de su perfil y, en Información de compra:
- Seleccione la casilla de verificación Mostrar el importe total de impuestos en cada paso del proceso de pago.
A continuación, para el cálculo automático de impuestos, necesitará generar una clave API REST. Tenga en cuenta que esto no se hace desde la página de su perfil de aceptación segura, sino desde la página general de gestión de claves.
Importante: No puede utilizar la misma clave API REST para los entornos sandbox y de producción.
- En el menú de la izquierda, vaya a Configuración de pagos > Gestión de claves, y en la página Gestión de claves haga clic en Generar clave.
- En la página Crear clave que se abrirá, en Tipos de claves, seleccione REST - Secreto compartido.
- A continuación, desplácese hasta la parte inferior de la página y haga clic en Generar clave.
Una vez generada la clave, podrá acceder a la Clave y al Secreto compartido. Estos son los valores que debe introducir en la plataforma para las credenciales de la API REST al establecer la configuración fiscal.
Consejo: Descargue o copie el secreto compartido de forma segura en este punto, ya que no podrá recuperarlo más tarde.
Nota: Puede ver sus claves generadas desde la página principal Gestión de claves. Cambie los filtros a "Todas las fechas" para ver las claves. Sin embargo, no puede recuperar el secreto compartido de las claves generadas anteriormente, ya que solo se muestra en el momento de la generación de la clave.
Activación del perfil de aceptación segura
Antes de poder utilizar el perfil para transacciones de prueba o reales, deberá tener el estado = Activo. Puede comprobarlo en la lista de perfiles o directamente desde la página del perfil.
- Para activar el perfil, haga clic en el botón Promover perfil.
Configuración de Cybersource en la plataforma
→ Antes de empezar a configurar Cybersource en la plataforma, asegúrese de haber completado los pasos para configurar un perfil en Cybersource.
Para configurar la integración de Cybersource, inicie sesión como Superadministrador en su plataforma. A continuación, vaya al Menú de navegación > Configuración (icono de llave inglesa) > Comercio electrónico > Cybersource. Se abrirá la página de configuración de Cybersource.
- Si ya ha configurado Cybersource, verá aquí una página con todos los ajustes existentes: Detalles de la cuenta de Cybersource, Configuración fiscal, Modo de implementación.
- De lo contrario, haga clic en Configurar Cybersource para iniciar la configuración.
Detalles de la cuenta de Cybersource
Al comenzar a configurar Cybersource, en el panel derecho que se abrirá, se le solicitará en primer lugar que introduzca las credenciales del perfil de aceptación segura (sandbox o producción) que haya creado en Cybersource.
Puede copiar estos valores de la página de configuración de aceptación segura del perfil:
- El ID del perfil es visible en la parte superior de la página.
- La clave secreta y la clave de acceso se pueden ver y copiar desde la pestaña Seguridad, mediante la acción Ver clave.
Cuando esté listo, haga clic en Confirmar. Accederá a la página Configuración de Cybersource. Tenga en cuenta que, a partir de este momento, los detalles de la cuenta que introdujera anteriormente pasarán a ser de solo lectura, y la clave secreta y la clave de acceso se ocultarán por seguridad.
→ Si necesita cambiar los datos de la cuenta, deberá restablecer la configuración de Cybersource y comenzar de nuevo.
Consejo: Recuerde que, si las credenciales introducidas son para un perfil de aceptación segura de sandbox, también debe seleccionar el modo de implementación Sandbox. Si, por el contrario, ha introducido credenciales para un perfil de producción, seleccione el modo de implementación Producción.
Modo de implementación
En esta área, establezca si desea operar en el entorno de pruebas (sandbox) o en el entorno real.
La opción que elija aquí deberá coincidir con los detalles de la cuenta de Cybersource que introdujera anteriormente.
- Si dichas credenciales eran para un perfil de aceptación segura de sandbox, seleccione aquí Modo sandbox de Cybersource.
- Si dichas credenciales eran para un perfil de aceptación segura de producción, seleccione aquí Modo de producción de Cybersource.
Configuración fiscal
Si desea que Cybersource calcule y aplique los impuestos automáticamente en el momento del pago, deberá configurarlo aquí de la siguiente manera:
- En primer lugar, en su perfil de aceptación segura de Cybersource (sandbox o producción), asegúrese de haber completado los pasos para configurar el cálculo de impuestos: Debería haber activado "Mostrar el importe total de impuestos" en la pestaña Formulario de pago y creado una clave API REST. Para más información, consulte el capítulo Configuración para el cálculo automático de impuestos.
- Asegúrese también de que Cybersource haya activado los impuestos para su cuenta (póngase en contacto con Cybersource para ello).
Ahora, en la plataforma, seleccione la casilla de verificación Habilitar cálculo automático de impuestos e introduzca su número de IVA de comerciante.
Cuando habilite el cálculo automático de impuestos, verá que aparece un campo Credenciales de la API REST en el área Modo de implementación.
Configúrelo de la siguiente manera:
- En primer lugar, asegúrese de haber seleccionado el modo de implementación correcto (sandbox o producción) y que coincida con el perfil de aceptación segura que esté utilizando.
- A continuación, haga clic en el botón Configurar la API REST.
- En el panel que se abrirá, introduzca el ID de la organización que utilice para iniciar sesión en el portal de Cybersource (recuerde que este no es el ID del perfil).
- A continuación, introduzca la clave API y el secreto compartido de la clave API REST que creara en Cybersource. Consulte el capítulo Configuración de Cybersource para el cálculo automático de impuestos.
Cuando haya terminado, haga clic en Confirmar.
Restablecimiento de la configuración de Cybersource
Una vez que Cybersource esté configurado en la plataforma, no podrá editar las credenciales del perfil de aceptación segura. Por lo tanto, si necesita editar alguno de estos valores -por ejemplo, para pasar de un perfil sandbox a uno de producción, lo que requiere cambiar los datos de la cuenta-, tendrá que restablecer la configuración de Cybersource y empezar de nuevo.
Para ello, haga clic en el botón Restablecer Cybersource en esta área. En la ventana que se abrirá, seleccione la casilla de verificación para confirmar y haga clic de nuevo en Restablecer Cybersource.
Buenas prácticas
En el carrito de la compra, cuando se ha seleccionado Cybersource como método de pago, la Información de facturación debe rellenarse de la siguiente manera:
- Si se ha establecido como país Canadá o Estados Unidos, el campo Estado/Provincia/Región es obligatorio, y el usuario debe seleccionar un elemento de la lista desplegable.
- Si se seleccionan otros países, el campo Estado/Provincia/Región no es obligatorio. Sin embargo, si los usuarios deciden rellenarlo, deberán insertar un código de dos letras.
- El nombre del usuario que finalice el pago no deberá incluir comillas dobles ( " ").