Si es la primera vez que accedes a la tienda, deberás hacer un deploy del storefront. De lo contrario, puedes omitir este paso.

1. En la tienda Salesforce Commerce Cloud, dentro de la sección Administración dirígete a Desarrollo del sitio > Importar y exportar de sitio en el menú lateral izquierdo.
2. En el menú Importar, selecciona la opción Sitios de demostración de la Arquitectura de Referencia de Storefront.

3. En la tabla, selecciona la opción Storefront Reference Architecture base y haz clic en el botón Implementar.

4. Luego, dirígete a Administración > Desarrollo del sitio > Implementación de código en el menú lateral izquierdo.
5. En Gestión de versiónes de código, selecciona la versión de código que se encuentre activa y descárgala.

1. En la tienda, dentro de la sección Administración dirígete a Desarrollo del sitio > Implementación de código en el menú lateral izquierdo.
2. Haz clic en la versión activa más reciente de la tienda.

3. En Resumen de la versión, haz clic en Descargar.

4. Por último, descomprime el archivo .zip que descargaste.

Con esto, habrás descargado la última versión de la tienda. Ahora puedes avanzar a la descarga del cartucho de Mercado Pago.

1. Accede a Salesforce Partner Marketplace y busca "Mercado Pago".
2. Haz clic en Mercado Pago Cartridge for B2C Commerce. Un vez dentro del sitio del cartucho, haz clic en Get It Now.

3. Verás un aviso de redirección hacia el repositorio oficial de Mercado Pago en GitHub, en donde deberás indicar que aceptas los términos y condiciones y hacer clic en Visit Provider.
4. Dentro del repositorio, sigue las instrucciones de la sección README para descargar la última versión del cartucho int_mercadopago.
5. Por último, descomprime el archivo .zip que descargaste.

Con esto, el cartucho de Mercado Pago ya ha sido descargado y puedes avanzar con la integración en la tienda.

En esta etapa, conectarás la tienda con el cartucho de Mercado Pago. Para lograrlo, primero deberás almacenar el cartucho de Mercado Pago en el sitio de la tienda.

1. Abre la carpeta del cartucho de Mercado Pago obtenido en el paso 2 y navega hasta la carpeta cartridges.
2. Abre la carpeta que descargaste con la última versión de la tienda y copia todo su contenido.
3. Pega las carpetas de la tienda dento de la carpeta cartridges. De esta forma, la carpeta int_mercadopago debe quedar al mismo nivel que las carpetas de la tienda.

A continuación, integra el cartucho de Mercado Pago con la tienda para que mantenga su funcionalidad junto con otros cartuchos instalados. Para ello, sigue estos pasos:

1. Abre una Terminal o CMD y accede a la carpeta int_mercadopago.
2. Ejecuta los siguientes comandos:

bash
Copiar
npm install
npm run build

Con esto, el cartucho ya fue integrado en el sitio de la tienda y es posible avanzar con la configuración de la conexión del entorno de desarrollo local con Salesforce.

Al inicio de la integración, el proyecto debe ser preparado y conectado al entorno de prueba de Salesforce Commerce Cloud usando una herramienta compatible con WebDAV (protocolo para gestión de archivos vía HTTP), como el Prophet Debugger o similar.

Sigue los pasos a continuación:

1. En caso de que aún no lo tengas, crea una Llave de acceso siguiendo las indicaciones a continuación. Si ya la tienes, omite este paso.
   1. Ve a Mi perfil y, en la columna Credenciales, haz clic en Administrar Llaves de Acceso.
   2. En la columna Scope, selecciona WebDAV File Access and UX Studio para obtener permisos de desarrollo.
   3. Haz clic en Generar llave de acceso.

2. En la raíz del proyecto, crea un archivo con el nombre ”dw.json” y agrega el siguiente contenido, completando cada dato con los de la tienda:

json
Copiar
{
  "hostname": "host del sandbox",
  "username": "email",
  "password": "password WebDAV",
  "code-version": "directorio"
}

3. En la raíz del proyecto, crea una carpeta llamada “.vscode” y dentro de ella, crea un archivo llamado “launch.json” con el siguiente contenido:

json
Copiar
{
    "version": "0.1.0",
    "configurations": [
        {
            "type": "prophet",
            "request": "launch",
            "name": "Attach to Sandbox"
        }
    ]
}

Listo, ya tienes conectado el entorno de desarrollo local con Salesforce y puedes seguir con la configuración del cartucho.

Para activar el cartucho int_mercadopago y utilizarlo como procesador de pagos, sigue estos pasos.

1. Ve al panel de configuración de Salesforce Commerce Cloud haciendo clic en Administración > Sitios > Administrar sitios.
2. Selecciona tu sitio y haz clic en la pestaña Configuración.
3. En la opción Cartuchos, agrega int_mercadopago a la lista antes de app_storefront_base, separando los valores por dos puntos. El resultado debe quedar conforme a la imagen a continuación.

4. Haz clic en Aplicar para guardar los cambios.

Al finalizar con esta configuración, Mercado Pago aparecerá como medio de pago disponible en la tienda. Sigue el próximo paso para agregar los medios de pago.

En este paso podrás subir el archivo "metadata" a la tienda en Salesforce Commerce Cloud y, de esta forma, agregar los medios de pago que ofrece Mercado Pago.

1. Abre la carpeta del cartucho que obtuviste en el paso 2, ve hasta la carpeta metadata y comprímela en un archivo .zip.

2. Ve al panel de configuración de Salesforce Commerce Cloud, en Administración > Desarrollo del sitio > Importación y exportación del sitio
3. En el menú Importar, haz clic en Seleccionar archivo, elige el archivo metadata.zip y, a continuación, haz clic en Subir. Cuando se solicite, confirma la acción haciendo clic en Ok.
4. La confirmación del envío puede verificarse en el menú Estado, ubicado al final de la página. Usa el botón Actualizar para recargar, si es necesario.

Cuando veas el archivo metadata.zip dentro del menú Estado, la configuración habrá quedado lista. Ya puedes continuar con la configuración de las credenciales de Mercado Pago.

Deberás vincular tu cuenta de Mercado Pago a través de las credenciales. Durante la etapa de integración, deberás utilizar las credenciales de cuentas de pruebaClaves de acceso que identifican a tu usuario de prueba, utilizadas en etapas de desarrollo o para probar la integración. que obtuviste en Crear aplicación. Sigue los pasos a continuación.

1. Ve al panel de configuración de Salesforce Commerce Cloud haciendo clic en Administración > Herramientas del comerciante > Preferencias del sitio > Preferencias personalizadas.
2. En la pantalla Grupos de Preferencias de Sitio Personalizados verás el listado de configuración de Mercado Pago. Haz clic en el ID MercadoPagoCredentials.
3. En el campo Tipo de Instancia, selecciona Sandbox.
4. Dentro de la pantalla Mercado Pago Credentials, completa los campos según corresponda:

4. Haz clic en Guardar para confirmar la configuración.

¡Listo! Ya vinculaste tu cuenta de Mercado Pago con tu tienda en Salesforce Commerce Cloud. Puedes avanzar con la verificación de la intalación.

Para comprobar que el cartucho de Mercado Pago se encuentra correctamente instalado, sigue estos pasos.

1. Ve al panel de configuración de Salesforce Commerce Cloud, haciendo clic en Administración > Herramientas del comerciante > Pedidos > Procesadores de pago.
2. Comprueba que los procesadores de pago de Mercado Pago se encuentren dentro de la tabla, dentro de la columna ID de Procesador.

Listo, ya instalaste y configuraste el cartucho de Mercado Pago. A continuación, avanza con la Configuración de los medios de pago.