If this is the first time you access the store, you will need to deploy the storefront. Otherwise, you can skip this step.

1. In your Salesforce Commerce Cloud store, within the Administration section, go to Site Development > Site Import & Export in the left side menu.
2. In the Import menu, select the option Storefront Reference Architecture Demo Sites.

3. In the table, select the option Storefront Reference Architecture base and click the Deploy button.

4. Next, go to Administration > Site Development > Code Deployment in the left side menu.
5. In Code Version Management, select the active code version and download it.

1. In your store, within the Administration section, go to Site Development > Code Deployment in the left side menu.
2. Click on the most recent active version of your store.

3. In Version Summary, click Download.

4. Finally, unzip the .zip file you downloaded.

With this, you have downloaded the latest version of your store. You can now proceed to download the Mercado Pago cartridge.

1. Access the Salesforce Partner Marketplace and search for "Mercado Pago".
2. Click on Mercado Pago Cartridge for B2C Commerce. Once inside the cartridge site, click Get It Now.

3. You will see a redirect notice to the official Mercado Pago repository on GitHub, where you must indicate that you accept the terms and conditions and click Visit Provider.
4. Inside the repository, follow the instructions in the README section to download the latest version of the int_mercadopago cartridge.
5. Finally, unzip the .zip file you downloaded.

With this, the Mercado Pago cartridge has been downloaded and you can proceed with integrating it into your store.

In this step, you will connect your store with the Mercado Pago cartridge. To do this, you must first store the Mercado Pago cartridge on the store site.

1. Open the Mercado Pago cartridge folder obtained in step 2 and navigate to the cartridges folder.
2. Open the folder you downloaded with the latest version of your store and copy all its contents.
3. Paste your store folders inside the cartridges folder. This way, the int_mercadopago folder must be at the same level as your store folders.

Next, integrate the Mercado Pago cartridge with your store so that it maintains its functionality alongside other installed cartridges. To do this, follow these steps:

1. Open a Terminal or CMD and access the int_mercadopago folder.
2. Execute the following commands:

bash
Copiar
npm install
npm run build

With this, the cartridge has been integrated into the store site and you can proceed with configuring the connection between the local development environment and Salesforce.

At the beginning of the integration, the project must be prepared and connected to the Salesforce Commerce Cloud test environment using a WebDAV-compatible tool (protocol for file management via HTTP), such as Prophet Debugger or similar.

Follow the steps below:

1. If you don't have one yet, create an Access Key following the instructions below. If you already have one, skip this step.
   1. Go to My Profile and, in the Credentials column, click Manage Access Keys.
   2. In the Scope column, select WebDAV File Access and UX Studio to obtain development permissions.
   3. Click on Generate access key.

2. In the project root, create a file named "dw.json" and add the following content, filling in each field with your store information:

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

3. In the project root, create a folder named ".vscode" and inside it, create a file named "launch.json" with the following content:

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

Done, you now have the local development environment connected with Salesforce and can proceed with configuring the cartridge.

To activate the int_mercadopago cartridge and use it as a payment processor, follow these steps.

1. Go to the Salesforce Commerce Cloud configuration panel, in Administration > Sites > Manage Sites.
2. Select your site and click on the Settings tab.
3. In the Cartridges option, add int_mercadopago to the list before app_storefront_base, separating the values by colons. The result should be as shown in the following image.

4. Click Apply to save the changes.

After completing this configuration, Mercado Pago will appear as an available payment method in your store. Follow the next step to add the payment methods.

In this step you will be able to upload the "metadata" file to your store in Salesforce Commerce Cloud and, in this way, add the payment methods that Mercado Pago offers.

1. Open the cartridge folder you obtained in step 2, go to the metadata folder and compress it into a .zip file.

2. Go to the Salesforce Commerce Cloud configuration panel, in Administration > Site Development > Site Import & Export.
3. In the Import menu, click Select File, choose the metadata.zip file and, then, click Upload. When prompted, confirm the action by clicking Ok.
4. The upload confirmation can be verified in the Status menu, located at the end of the page. Use the Refresh button to reload, if necessary.

When you see the metadata.zip file within the Status menu, the configuration will be ready. You can now continue with configuring Mercado Pago credentials.

You must link your Mercado Pago account through credentials. During the integration stage, you must use the test account credentialsAccess keys that identify your test user, used in development stages or to test the integration. that you obtained in Create application. Follow the steps below.

1. Go to the Salesforce Commerce Cloud configuration panel, in Administration > Merchant Tools > Site Preferences > Custom Preferences.
2. In the Custom Site Preference Groups screen you will see the Mercado Pago configuration list. Click on the MercadoPagoCredentials ID.
3. In the Instance Type field, select Sandbox.
4. Inside the Mercado Pago Credentials screen, complete the fields as appropriate:

5. Click Save to confirm the configuration.

Done! You have now linked your Mercado Pago account with your store in Salesforce Commerce Cloud. You can proceed with verifying the installation.

To verify that the Mercado Pago cartridge is correctly installed, follow these steps.

1. Go to the Salesforce Commerce Cloud configuration panel, in Administration > Merchant Tools > Ordering > Payment Processors.
2. Verify that the Mercado Pago payment processors are within the table, in the Processor ID column.

Done, you have now installed and configured the Mercado Pago cartridge. Next, proceed with Payment Methods Configuration.