{"id":7409,"date":"2024-04-22T22:10:55","date_gmt":"2024-04-22T22:10:55","guid":{"rendered":"https:\/\/documents.openpay.mx\/?p=7409"},"modified":"2024-11-19T22:47:00","modified_gmt":"2024-11-19T22:47:00","slug":"vtex","status":"publish","type":"post","link":"https:\/\/documents-mx-dev.opdevhm.com\/en\/docs\/vtex.html","title":{"rendered":"Vtex"},"content":{"rendered":"
Para poder configurar el plugin de Openpay en Vtex se debe seguir los siguientes pasos:<\/p>\n
1. Ir al sitio web de Openpay<\/a> y crear cuenta.<\/p>\n Note:<\/strong><\/span> Para hacer pruebas, crear la cuenta en ambiente Sandbox<\/a>. Para operaci\u00f3n real, pide tu pase a Producci\u00f3n <\/em><\/span><\/p>\n 2. Entrar al Dashboard con los datos de acceso creados<\/p>\n 3. En barra superior, ir al icono de engrane y hacer click en la opci\u00f3n API Credentials<\/strong><\/p>\n 4. Obtener ID (identificador del comercio), Llave privada y Llave p\u00fablica (esta informaci\u00f3n se usar\u00e1 m\u00e1s adelante).<\/p>\n Note: <\/strong><\/span>Las Credenciales de API son diferentes en cada ambiente. Debe guardar estos datos por separado y no confundirlos para que los ambientes de Sandbox y Producci\u00f3n funcionen correctamente.<\/span> <\/em><\/p>\n Para que su tienda VTEX funcione correctamente con Openpay, se requieren datos adicionales que se obtienen a trav\u00e9s de Google Tag Manager (recomendamos que se cree una cuenta exclusiva para la integraci\u00f3n de VTEX con Openpay para evitar posibles conflictos con otros contenedores)<\/p>\n 2. Ir a la URL http:\/\/www.google.com\/tagmanager\/<\/a> . Si no tiene una cuenta, hacer click en Crear cuenta<\/strong>, si ya tiene una cuenta, ir al paso 5<\/p>\n 3. Capture los datos solicitados y haga click en el bot\u00f3n Guardar<\/strong> al finalizar<\/p>\n 4. Aceptar T\u00e9rminos de uso para continuar<\/p>\n 5. Hacer login en http:\/\/www.google.com\/tagmanager\/<\/a> para la tienda que vamos a configurar<\/p>\n 6. Se mostrar\u00e1 el dashboard principal. Ir al men\u00fa y hacer click en Administrador<\/strong><\/p>\n 7. En las opciones de contenedor, del lado derecho de la pantalla aparecer\u00e1 su identificador de GTM que tiene un formato como \u00e9ste: GTM-A1B2CDE<\/em>. Debe guardar el ID ya que se utilizar\u00e1 m\u00e1s adelante.<\/p>\n 8. Hacer click en Importar contenedor<\/strong><\/p>\n 9. Haga click en Elija el archivo del contenedor<\/strong>, seleccione el archivo contenedor que descarg\u00f3 en el paso 1 y presione Abrir o Aceptar<\/p>\n 10. En la opci\u00f3n Elegir espacio de trabajo presione el bot\u00f3n Nuevo<\/strong><\/p>\n 11. Elija un nombre para su Espacio de trabajo (Si no est\u00e1 seleccionada, elija la opci\u00f3n Combinar \/ Cambiar el nombre de etiquetas, activadores y variables en conflicto)<\/p>\n 12. Presione el bot\u00f3n Confirmar<\/strong><\/p>\n 13. Guarde los cambios y haga click en el bot\u00f3n superior derecho Enviar<\/strong>. Esto inicia el proceso de publicaci\u00f3n de su contenedor con los cambios que realiz\u00f3 en las variables.<\/p>\n 14. En la pantalla \u201cConfiguraci\u00f3n de env\u00edo\u201d validar que se muestre seleccionada la opci\u00f3n \u201cPublicar y crear versi\u00f3n\u201d y que en la parte inferior se muestre \u201cEntorno de publicaci\u00f3n Live\u201d. Hacer click en el bot\u00f3n Publicar<\/strong>.<\/p>\n Si se public\u00f3 correctamente, su GTM est\u00e1 listo para ser consumido por el sistema VTEX, al cual le agregaremos el ID que obtuvimos en el paso 7<\/p>\n 15. Ingresar a VTEX y en el panel de la izquierda ir a Store Settings<\/strong> (Configuraci\u00f3n de tienda) -> storefront<\/strong> -> Checkout<\/strong> y dar click en el bot\u00f3n con icono de engranaje.<\/p>\n 16. Hacer click en la opci\u00f3n Checkout<\/strong>, introduzca su GTM ID y presione Guardar<\/strong>. Con esto VTEX insertar\u00e1 el c\u00f3digo de GTM en su tienda en l\u00ednea.<\/p>\n En el panel de la izquierda ir a Store Settings (Configuraci\u00f3n de tienda) -> Storefront -> Checkout.<\/p>\n En el encabezado de color azul de la pagina seleccionar la opci\u00f3n Code.<\/p>\n En el archivo con el nombre checkout5-custom.js<\/strong> colocar el siguiente c\u00f3digo, a trav\u00e9s del cual se realizar\u00e1 la ejecuci\u00f3n del c\u00f3digo que generar\u00e1 el device session id requerido para realizar transacciones con tarjeta de cr\u00e9dito o d\u00e9bito.<\/p>\n Nota: El n\u00famero en el nombre de este archivo podr\u00eda cambiar dependiendo de la Dentro del c\u00f3digo mencionado anteriormente existen 4 variables relativas al funcionamiento del script. las cuales est\u00e1n asociadas al correcto funcionamiento del mismo, en las \u00faltimas cuatro l\u00edneas del c\u00f3digo reducido, estas variables son las siguientes:<\/p>\n Una vez modificados estos datos debe proceder a guardar la configuraci\u00f3n pulsando el bot\u00f3n Save. 2. Completar la configuraci\u00f3n de la conexi\u00f3n, contemplando los siguientes puntos:<\/p>\n 5. Hacer click en el bot\u00f3n Save<\/strong><\/p>\n 6. Configurar en Vtex los m\u00e9todos de pago a emplear en el e-commerce<\/p>\n 7. Configurar en Openpay los webhook<\/p>\n 2. Verificar que el resultado para cada escenario es el esperado. En caso de no obtener el resultado esperado se deber\u00e1 validar nuevamente la configuraci\u00f3n y en caso de tener un resultado exitoso, se deber\u00e1 solicitar a Openpay una cuenta de producci\u00f3n.<\/p>\n Note:<\/strong><\/span> En el caso del m\u00e9todo de Pago en Tiendas, se debe validar que en la pantalla \u201cConfirmaci\u00f3n de pago\u201d se muestre correctamente el bot\u00f3n \u201cReferencia\u201d como se ve en la siguiente imagen <\/em><\/p>\n En Openpay contamos con 3 formas de pago:<\/p>\n Para configurar cualquiera de los m\u00e9todos de pago mencionados debemos de:<\/p>\n 2. Acceder al path Payment> Settings > Payment Conditions <\/strong>y hacer click en el bot\u00f3n Agregar<\/strong><\/p>\n 3. Se mostrar\u00e1 una pantalla con diversas opciones donde hay que buscar y seleccionar el m\u00e9todo de pago a configurar.<\/p>\n Nota: S\u00f3lo para los m\u00e9todos de pago Pago en tiendas y Transferencias interbancarias seguir las siguientes indicaciones:<\/strong><\/span><\/em><\/span><\/p>\n 4. En la pantalla de configuraci\u00f3n del m\u00e9todo de pago seleccionado, hacer clic en Process with provider<\/strong>, seleccionar el provider<\/strong> configurado anteriormente, marcarlo como activo y para finalizar dar clic al boton de Save<\/strong> para guardar la configuraci\u00f3n.<\/p>\n 5. En la barra superior capturar la leyenda que corresponda al m\u00e9todo de pago que se est\u00e1 configurando.Note:<\/strong> S\u00f3lo para los m\u00e9todos de pago Pago en tiendas<\/strong> and Wire transfers<\/strong> seguir las siguientes indicaciones:<\/em><\/p>\n Note:<\/strong><\/span> Debido a configuraciones del conector, la leyenda a colocar en cada m\u00e9todo de pago deber\u00e1 de ser tal cual se indica en este paso<\/strong><\/span><\/em><\/p>\n 1.- Dentro de su dashboard ya sea Sandbox \u00f3 Producci\u00f3n, en la barra superior hacer click en el icono de engrane y seleccionar \u201cConfiguraciones\u201d.<\/p>\n 2.- Hacer click en el bot\u00f3n Agregar<\/strong><\/p>\n 3.- Se abrir\u00e1 el formulario como se muestra en la imagen:<\/p>\n – El formulario deber\u00e1 de ser llenado de la siguiente manera.<\/strong><\/p>\n 3d Secure<\/strong>: Para los comercios que cuenten con 3D Secure activo, seleccionar Cargos > Completados, Fallidos y Cancelados.<\/span><\/em><\/p>\n<\/li>\n CONFIGURACI\u00d3N DE PLUGIN OPENPAY EN SITIO WEB CON VTEX Para poder configurar el plugin de Openpay en Vtex se debe seguir los siguientes pasos: 1.- CREAR CUENTA EN OPENPAY 1. Ir al sitio web de Openpay y crear cuenta. Nota: Para hacer pruebas, crear la cuenta en ambiente Sandbox. Para operaci\u00f3n real, pide tu pase… Read More »Vtex<\/span><\/a><\/p>","protected":false},"author":5,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"off","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","footnotes":""},"categories":[133],"tags":[153],"class_list":["post-7409","post","type-post","status-publish","format-standard","hentry","category-docs","tag-plugins"],"yoast_head":"\n
<\/p>\n<\/p>\n
2.- Configurar Google Tag Manager (GTM)
<\/strong><\/h3>\n\n
\n
\n
\n
<\/div>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n3.- CONFIGURAR SCRIPT PARA DEVICE SESSION ID
<\/strong><\/h3>\n
<\/p>\n
<\/p>\n
configuraci\u00f3n de la plataforma, aseg\u00farese de seleccionar el correcto. El nombre del archivo debe coincidir, a excepci\u00f3n del n\u00famero que como se mencion\u00f3 anteriormente puede ser distinto al especificado en funci\u00f3n de la configuraci\u00f3n de su comercio.<\/p>\n\ns = document.createElement('script');\ns.src = \"https:\/\/js.openpay.mx\/openpay-vtex.min.js\";\ns.type = 'text\/javascript';\ns.defer = true;\ndocument.getElementsByTagName('head').item(0).appendChild(s);\ncountry ='MX';\nsandboxMode = true;\nid = 'mxxxxxxxxxxxxxxxxxxx';\npk = 'pk_xxxxxxxxxxxxxxxxx';\n<\/code><\/pre>\n
<\/p>\n\n
<\/strong><\/p>\n
<\/p>\n4.- CONFIGURAR PAYMENT PROVIDER EN VTEX<\/strong><\/h3>\n
\n
\n
<\/figure>\n\n
\n
\n
\n\n
<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n5.- VALIDACI\u00d3N DE CONFIGURACI\u00d3N CORRECTA<\/strong><\/h3>\n
\n
<\/p>\nCONFIGURAR M\u00c9TODOS DE PAGO EN VTEX<\/h2>\n
\n
\n
Aqu\u00ed se consideran todos los pagos por Tarjeta de Cr\u00e9dito, D\u00e9bito y Servicio, siempre y cuando est\u00e9n operados por Visa, MasterCard, American Express, Carnet. Tambi\u00e9n se incluye los pagos con Puntos Bancomer, Santander y Scotiabank (POINTS).<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n
\n
Son las transferencias interbancarias, como pueden ser SPEI o simplemente dar los datos de la cuenta CLABE para mostrar datos de transferencia del comercio.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n
\n
Se muestra el n\u00famero de referencia para realizar el pago en cualquiera de los establecimientos de la Red Paynet. Los establecimientos se pueden consultar en paynet.com.mx<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n
<\/p>\n\n
\n
\n
<\/li>\n
<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
<\/p>\n\n
CONFIGURACI\u00d3N DE WEBHOOKS<\/h2>\n
<\/p>\n
<\/p>\n
<\/p>\n\n
\n
\n
<\/p>\n\n
\n
<\/p>\n\n
\n
<\/p>\n\n
\n
<\/p>\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>","protected":false},"excerpt":{"rendered":"