Cybersource es una empresa que ofrece varias soluciones para ayudar a gestionar los pagos en su tienda. Entre ellos se encuentran un gateway y un antifraude, ambos con integraciones disponibles en VTEX.
Si desea obtener más información sobre cómo integrar Cybersource antifraude en su tienda, vaya a Configurar antifraude CyberSource.
Para utilizar el gateway Cybersource IO en su tienda, se requieren las siguientes acciones:
- Instalar aplicaciones Cybersource IO (VTEX IO CLI)
- Crear claves de autenticación en Cybersource (entorno Cybersource)
- Realizar la configuración de la aplicación Cybersource (Admin VTEX)
- Configurar el Cybersource gateway (Admin VTEX)
- Configurar condiciones de pago (Admin VTEX)
- Configurar o Device Fingerprint (opcional)
- Configurar campos de comerciante (opcional)
Instalación de aplicaciones Cybersource
Las siguientes aplicaciones Cybersource deben estar instaladas en su cuenta de tienda:
- vtex.cybersource-ui
- vtex.cybersource
- vtex.cybersource-payer-auth
Si tiene la intención de utilizar el sistema antifraude de Cybersource, pero desea realizar transacciones de pagos en un gateway que no sea de Cybersource, deberá instalar la aplicación vtex.cybersource-fraud.
Conozca más sobre la instalación de aplicaciones en una cuenta VTEX en Installing an app.
Crear claves de autenticación en Cybersource
Después de instalar las aplicaciones, debe crear claves de autenticación en el entorno Cybersource.
Las configuraciones realizadas en un ambiente externo a VTEX podrán ser discontinuadas o modificadas sin previo aviso. Consulte su cuenta Cybersource para obtener información actualizada.
Siga los pasos a continuación:
- Accede al panel Cybersource EBC (Enterprise Business Center) con tus datos.
- En el panel de navegación lateral, seleccione Payment Configuration > Key Management.
- Haga clic en Generate Key.
- En REST APIs, seleccione la opción REST - Shared Secret.
- Haga clic en Generate Key.
- Haga clic en Download key o copie la información clave usando la función de copia ubicada frente a los campos Key y Shared Secret.
Configuración de la aplicación Cybersource IO
Con las claves de autenticación disponibles, es hora de configurar la aplicación Cybersource IO en el Admin.
Siga los pasos a continuación para configurar la aplicación Cybersource IO:
- En el Admin VTEX, accede a Apps > Apps Instaladas > Cybersource, o escribe Cybersource en la barra de búsqueda en la parte superior de la página.
- En la pestaña Admin Settings, complete o seleccione los campos a continuación:
Configuración del gateway Cybersource
Para configurarel gateway Cybersource, siga los pasos a continuación:
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Proveedores, o escribe Proveedores en la barra de búsqueda en la parte superior de la página.
- En la pantalla de proveedores, haga clic en el botón
Nuevo proveedor. - Escriba Cybersource IO en la barra de búsqueda y haga clic en el nombre del proveedor.
- En Autorización del proveedor, No es necesario completar los campos Clave de aplicación y Token de aplicación.
- Si desea modificar el nombre de identificación que se mostrará para el gateway Cybersource en la pantalla VTEX Admin, ingrese la información en el campo Nombre en Información general.
- En Control de pago, seleccione si desea activar el gateway en un entorno de prueba haciendo clic Activar modo de prueba.
- En el campo Liquidación automática, selecciona una de las siguientes opciones::
Configurar condición de pago
Para procesar pagos con tarjeta de crédito a través de Cybersource, siga los pasos a continuación:
- En el Admin de VTEX, acceda a Configuración de la Tienda > Pago > Configuración, o escriba Configuración en la barra de búsqueda en la parte superior de la página.
- En la pestaña Condiciones de pago, haga clic en el botón +.
- Haga clic en el nombre de la tarjeta de crédito deseada.
- Complete el campo Nombre de la condición con un nombre de su elección para identificación.
- Active la condición en el campo Status.
- En Procesar con proveedor selecciona la opción Cybersource - IO.
- Si desea utilizar un sistema antifraude, seleccione la opción Usar antifraude y elija su proveedor preferido.
- Si desea, puede configurar condiciones especiales de pago.
- Haga clic en Guardar.
Si anteriormente creó condiciones de pago con tarjeta de crédito para otros gateways (incluido el proveedor Cybersource legado), puede establecer esas condiciones en Inactivas. Las transacciones en curso iniciadas desde ese proveedor seguirán siendo procesadas por ese proveedor, incluso si está inactivo. El nuevo proveedor de Cybersource IO solo procesará las transacciones nuevas. Si necesita volver a su proveedor anterior por algún motivo, simplemente establezca sus condiciones de pago en Activas y las condiciones de pago de Cybersource IO en Inactivas.
Configurar Cybersource IO Device Fingerprint (opcional)
Device Fingerprint es un identificador que actúa en el procesamiento de un pago, con el objetivo de mejorar el análisis del riesgo de fraude en cada transacción.
Mediante la recolección de datos no sensibles, Device Fingerprint identifica y analiza el nivel de seguridad del dispositivo utilizado para realizar la transacción, así como las transacciones que se realizaron previamente con este mismo dispositivo.
Cada tienda debe tener solo un registro de Device fingerprint. Verifique si ya ha registrado el Device Fingerprint en otro conector, antes de continuar con los pasos siguientes.
Para configurar Device Fingerprint Cybersource IO, siga los pasos a continuación:
- En el Admin VTEX, accede a Configuración de la tienda > Storefront > Checkout, o escribe Checkout en la barra de búsqueda en la parte superior de la página.
- Haga clic en el icono del sitio deseado.
- En el menú de opciones azul ubicado en la parte superior de la página, haga clic en Código.
- En Archivos, haga clic en checkout5.custom.js.
- Ingrese el código a continuación en el campo de texto y haga clic en "Guardar".
function addsDeviceFingerPrint() { if (!window.vtex) return; if (window.vtex.deviceFingerprint) return; $.ajax({ type: 'get', async: true, url: rootPath() + '/api/sessions?items=*' }).then(function(response) { var ORG_ID = "{{ORG_ID}}"; var MERCHANT_ID = "{{MERCHANT_ID}}"; console.log('session', response); window.vtex.deviceFingerprint = response.id; var sessionId = response.id || "CYBERSOURCE"; var script = document.createElement("script"); script.type = "text/javascript"; script.src = `https://h.online-metrix.net/fp/tags.js?org_id=$\{ORG_ID\}&session_id=$\{MERCHANT_ID\}$\{sessionId\}`; document.head.appendChild(script); var noScript = document.createElement("noscript"); var iframe = document.createElement("iframe"); iframe.style = "width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;"; iframe.src = `https://h.online-metrix.net/fp/tags?org_id=$\{ORG_ID\}&session_id=$\{MERCHANT_ID\}$\{sessionId\}`; noScript.appendChild(iframe); document.body.appendChild(noScript); })}
Configurar campos de comerciante (opcional)
Además, puede definir campos personalizados que se incluirán en los pedidos enviados desde VTEX a Cybersource.
Vea a continuación cómo crear estos campos:
- En el Admin de VTEX, acceda a Apps > Apps Instaladas > Cybersource, o escriba Cybersource en la barra de búsqueda en la parte superior de la página.
- En la pestaña Campos definidos por el comerciante, en Información definida por el comerciante, puede insertar campos siguiendo las siguientes reglas:
Ejemplos:
Valor ingresado en Admin em Campos definidos por el comerciante | Escenario simulado | Resultado |
|---|---|---|
| `969{{Reference | PAD | 9:0}}` |
{{OrderId}}-01 | Donde OrderId es 124578 | 124578-01 |
{{MiniCart.Buyer.LastName}},{{MiniCart.Buyer.FirstName}} | Donde el comprador (Buyer) es John Doe | Doe,John |