{"section":"tutorials","requestedLocale":"es","requestedSlug":"configurar-gateway-cybersource","locale":"es","slug":"configurar-gateway-cybersource","path":"docs/es/tutorials/pagos/configuración-de-pagos/configurar-gateway-cybersource.md","branch":"main","content":"Cybersource es una empresa que ofrece varias soluciones para ayudar a gestionar los pagos en su tienda. Entre ellos se encuentran un [gateway](/es/docs/tutorials/que-es-un-gateway-de-pagos) y un [antifraude](/es/docs/tutorials/que-es-antifraude), ambos con integraciones disponibles en VTEX.\n\nSi desea obtener más información sobre cómo integrar Cybersource antifraude en su tienda, vaya a [Configurar antifraude CyberSource](/es/docs/tutorials/configurar-antifraude-cybersource).\n\nPara utilizar el gateway Cybersource IO en su tienda, se requieren las siguientes acciones:\n\n1. [Instalar aplicaciones Cybersource IO (VTEX IO CLI)](#instalacion-de-aplicaciones-cybersource)\n2. [Crear claves de autenticación en Cybersource (entorno Cybersource)](#crear-claves-de-autenticacion-en-cybersource)\n3. [Realizar la configuración de la aplicación Cybersource (Admin VTEX)](#configuracion-de-la-aplicacion-cybersource-io)\n4. [Configurar el Cybersource gateway (Admin VTEX)](#configuracion-del-gateway-cybersource)\n5. [Configurar condiciones de pago (Admin VTEX)](#configurar-condicion-de-pago)\n6. [Configurar o Device Fingerprint (opcional)](#configurar-cybersource-io-device-fingerprint-opcional)\n7. [Configurar campos de comerciante (opcional)](#configurar-campos-de-comerciante-opcional)\n\n## Instalación de aplicaciones Cybersource\n\nLas siguientes aplicaciones Cybersource deben estar instaladas en su cuenta de tienda:\n\n- __vtex.cybersource-ui__\n- __vtex.cybersource__\n- __vtex.cybersource-payer-auth__\n\n> ⚠️ 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**.\n\nConozca más sobre la instalación de aplicaciones en una cuenta VTEX en [Installing an app](https://developers.vtex.com/docs/guides/vtex-io-documentation-installing-an-app). \n\n## Crear claves de autenticación en Cybersource \n\nDespués de instalar las aplicaciones, debe crear claves de autenticación en el entorno Cybersource.\n\n> ⚠️ 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.\n\nSiga los pasos a continuación:\n\n1. Accede al [panel Cybersource EBC](https://businesscenter.cybersource.com/ebc2/) (Enterprise Business Center) con tus datos.\n2. En el panel de navegación lateral, seleccione __Payment Configuration > Key Management__.\n3. Haga clic en __Generate Key__.\n4. En __REST APIs__, seleccione la opción __REST - Shared Secret__.\n5. Haga clic en __Generate Key__.\n6. 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__.\n\n## Configuración de la aplicación Cybersource IO\n\nCon las claves de autenticación disponibles, es hora de configurar la aplicación Cybersource IO en el Admin. \n\n\n\nSiga los pasos a continuación para configurar la aplicación Cybersource IO:\n\n1. 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.\n2. En la pestaña __Admin Settings__, complete o seleccione los campos a continuación:\n
\n\n
\n \t- **Identificación del comerciante**: su ID de comerciante en Cybersource.
\n \t- **Clave de comerciante** y **Clave secreta compartida**: las dos claves obtenidas en el entorno Cybersource.
\n - **Processor**: seleccione la empresa que procesará el pago o haga clic en **Other** si no está en la lista.
\n - **Region**: seleccione una de las regiones o haga clic en **Other** si la región deseada no está en la lista.
\n \t- **Sufijo de referencia (opcional)**: por defecto, los pedidos en el sistema Cybersource se asociarán con el ID del grupo de pedidos de VTEX, pero esta configuración se puede utilizar para agregar un sufijo como \"-01\".
\n \t- **NSU personalizado (opcional)**: anular la NSU predeterminada con un valor personalizado.
\n \t- **Utilice el ID de pedido para la huella digital del dispositivo**: seleccione si desea utilizar el ID del pedido en lugar del ID de la sesión para la toma de huellas digitales del dispositivo.
\n \t- **Habilitar cálculos de impuestos**: seleccione si desea utilizar Cybersource al finalizar la compra como su proveedor de cálculo de impuestos.
\n \t- **Habilitar la publicación de transacciones**: seleccione si desea habilitar la publicación de transacciones completadas para cuestiones de declaración de impuestos.
\n \t- **Canales de venta para excluir de Cybersource (opcional)**: ingrese a cualquier canal de ventas en el que no desee utilizar transacciones de Cybersource.
\n \t- **Código de producto de envío (opcional)**: ingrese un código de producto para fines de cálculo del impuesto de envío.
\n \t- **Regiones de nexo fiscal (opcional)**: ingrese una lista de regiones donde se deben recaudar impuestos.
\n
\n3. Haga clic en __Guardar ajustes__.\n\n## Configuración del gateway Cybersource\n\nPara configurarel gateway Cybersource, siga los pasos a continuación:\n\n1. 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.\n2. En la pantalla de proveedores, haga clic en el botón `Nuevo proveedor`.\n3. Escriba __Cybersource IO__ en la barra de búsqueda y haga clic en el nombre del proveedor.\n4. En __Autorización del proveedor__, No es necesario completar los campos __Clave de aplicación__ y __Token de aplicación__.\n5. 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__.\n6. En __Control de pago__, seleccione si desea activar el gateway en un entorno de prueba haciendo clic __Activar modo de prueba__.\n7. En el campo __Liquidación automática__, selecciona una de las siguientes opciones::\n
\n\n
\n \t- **Utiliza comportamiento recomendado por el procesador de pagos**: la captura no es automática, sino que está programada para realizarse a los 4 días (o si el pedido está facturado, lo que ocurra primero).
\n \t- **Liquidación automática inmediatamente después de la autorización del pago**: la captura es automática y se produce inmediatamente después de la autorización, incluso si la transacción tiene un análisis antifraude.
\n \t\t- **Liquidación automática inmediatamente después del análisis antifraude**: la captura es automática y se realiza inmediatamente después de la autorización y el análisis antifraude (si seleccionas este comportamiento y no tienes análisis antifraude, la captura de pago se realizará de la misma manera que en el comportamiento \"Liquidación automática inmediatamente después de la autorización del pago\").
\n \t\t- **Desactivado**: la captura se realiza solo cuando se factura el pedido. Si se opta por este comportamiento de captura, es importante estar atento al tiempo de facturación, ya que puede exceder el tiempo de captura acordado con el proveedor de pagos y provocar la cancelación de la transacción.
\n
\n8. En __Campos del proveedor__, complete o seleccione los campos a continuación:\n\n
\n \t- **Company Name**: nombre de la compania.
\n - **Company Tax id**: número de identificación de la empresa.
\n - **Capture Setting**: seleccione **Delayed Capture** para seguir el procedimiento estándar de la plataforma VTEX (llamadas separadas para autenticación y captura) o **Immediate Capture**, donde se enviará una única llamada de autenticación y captura a CyberSource cuando se realice el pedido.\n
\n \t- **Payer Authentication**: si desea habilitar esta opción, [3-D Secure Payer Authentication da Cybersource](https://www.cybersource.com/en/solutions/fraud-and-risk-management/payer-authentication-for-3d-secure.html) debe ser usado.
\n \t- **Capture Delay** y **Capture Delay Interval**: determine el período antes de la captura automática.
\n \t- **Using Decision Manager**: seleccione si [CyberSource Decision Manager](https://www.cybersource.com/apac/en/solutions/fraud-and-risk-management/decision-manager.html) estará activo en su cuenta.
\n - **Authorized Payments Flagged by Decision Manager**: Cuando el estado Authorized, Fraud Reject, seleccione las siguientes opciones:
\n - **Treat as Successful Authorizations**: aceptar el pedido.
\n - **Treat as Failed Authorizations**: negar el pedido.
\n - **Treat as Pending Authorizations**: mantener el pedido en espera de una decisión final.
\n
\n9. Los campos __Merchant Id__, __Merchant Key__ y __Shared Secret Key__ debe dejarse en blanco, ya que se utilizarán los valores definidos en el paso 2 de la sección [Configuración de la aplicación Cybersource IO](#configuracion-de-la-aplicacion-cybersource-io).Si los campos se completan con un valor, sobrescribirán la información ingresada en el paso 2.\n10. Haga clic en __Guardar__.\n\n## Configurar condición de pago\n\nPara procesar pagos con tarjeta de crédito a través de Cybersource, siga los pasos a continuación:\n\n1. 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.\n2. En la pestaña __Condiciones de pago__, haga clic en el botón +.\n3. Haga clic en el nombre de la tarjeta de crédito deseada.\n4. Complete el campo __Nombre de la condición__ con un nombre de su elección para identificación.\n5. Active la condición en el campo __Status__.\n6. En __Procesar con proveedor__ selecciona la opción __Cybersource - IO__.\n7. Si desea utilizar un sistema antifraude, seleccione la opción __Usar antifraude__ y elija su proveedor preferido.\n8. Si desea, puede [configurar condiciones especiales de pago](/es/docs/tutorials/condiciones-especiales). \n9. Haga clic en __Guardar__.\n\n> ⚠️ 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**.\n\n## Configurar Cybersource IO Device Fingerprint (opcional)\n\nDevice 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. \n\nMediante 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.\n\n> ℹ️ 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.\n\nPara configurar Device Fingerprint Cybersource IO, siga los pasos a continuación:\n\n1. 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.\n2. Haga clic en el icono del sitio deseado.\n3. En el menú de opciones azul ubicado en la parte superior de la página, haga clic en __Código__.\n4. En __Archivos__, haga clic en __checkout5.custom.js__.\n5. Ingrese el código a continuación en el campo de texto y haga clic en \"Guardar\".\n\n```\nfunction addsDeviceFingerPrint() {\n if (!window.vtex) return;\n if (window.vtex.deviceFingerprint) return;\n $.ajax({\n type: 'get',\n async: true,\n url: rootPath() + '/api/sessions?items=*'\n }).then(function(response) {\n var ORG_ID = \"{{ORG_ID}}\";\n var MERCHANT_ID = \"{{MERCHANT_ID}}\";\n console.log('session', response);\n window.vtex.deviceFingerprint = response.id;\n var sessionId = response.id || \"CYBERSOURCE\";\n var script = document.createElement(\"script\");\n script.type = \"text/javascript\";\n script.src = `https://h.online-metrix.net/fp/tags.js?org_id=$\\{ORG_ID\\}&session_id=$\\{MERCHANT_ID\\}$\\{sessionId\\}`;\n document.head.appendChild(script);\n var noScript = document.createElement(\"noscript\");\n var iframe = document.createElement(\"iframe\");\n iframe.style = \"width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;\";\n iframe.src = `https://h.online-metrix.net/fp/tags?org_id=$\\{ORG_ID\\}&session_id=$\\{MERCHANT_ID\\}$\\{sessionId\\}`;\n noScript.appendChild(iframe);\n document.body.appendChild(noScript);\n })\n}\n```\n## Configurar campos de comerciante (opcional)\n\nAdemás, puede definir campos personalizados que se incluirán en los pedidos enviados desde VTEX a Cybersource. \n\n\n\nVea a continuación cómo crear estos campos:\n\n1. 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.\n2. En la pestaña __Campos definidos por el comerciante__, en __Información definida por el comerciante__, puede insertar campos siguiendo las siguientes reglas:\n\n
\n \t- Cualquier valor fuera de las claves **\\{\\{\\}\\}** se considerará como un valor directo.
\n - Cualquier valor entre **\\{\\{\\}\\}** debe tener el siguiente formato *Palabra de referencia|Palabra de modificación|Valores*.
\n - Todas las **palabras de referencia** se pueden encontrar en el menú desplegable **Mostrar todas las palabras referenciables**:
\n - **Palabras de referencia** se pueden dejar en blanco si la **Palabra de modificación** y **Valuores** están presentes.
\n - La **palabra de referencia** \ndistingue entre mayúsculas y minúsculas.
\n \t- **Palabras de modificación** deben ser **Pad**, **Date**, **Trim**, **Age**, o **Equals**. Vea a continuación las características al registrar cada uno de ellos:
\n - **Pad**: los **Valores** deben tener el formato **desired length:fill character**.
\n - El **filled character** debe ser un valor único. Por ejemplo, *9:x* dará como resultado una longitud deseada de 9 y llenará los espacios con x.
\n - Si el valor del campo excede el **desired length**, el campo se recortará.
\n
\n - **Date**: **Valores** debe tener el formato dd/MM/aaaa o cualquier combinación de los mismos.
\n - **M** por mes debe estar en mayúscula. Este formato se puede pedir como se desee, como por ejemplo **aaaa/MM** o **aaaa** o **dd/aaaa/MM**.
\n - **Trim**: limitará la longitud máxima del valor del campo sin agregar caracteres de relleno.
\n - **Age**: devolverá la diferencia entre la fecha actual y el valor del campo usando el formato Timespan.
\n - **Equals**: devolverá el valor booleano de una comparación de cadena entre el valor del campo y el valor de comparación.
\n
\n \t- Cada nueva línea se considera un nuevo campo definido por el comerciante.
\n\nEjemplos:\n\n| Valor ingresado en Admin em `Campos definidos por el comerciante` | Escenario simulado | Resultado |\n| ---------- | ---------- | ---------- |\n| `969{{Reference|PAD|9:0}}` | Cuando `Reference` es 6023 | 969602300000 |\n| `{{OrderId}}-01` | Donde `OrderId` es 124578 | 124578-01 |\n| `{{MiniCart.Buyer.LastName}},{{MiniCart.Buyer.FirstName}}` | Donde el comprador (`Buyer`) es John Doe | Doe,John |"}