Se é a primeira vez que você acessa a loja, deverá fazer um deploy do storefront. Caso contrário, você pode omitir este passo.

1. Na sua loja Salesforce Commerce Cloud, dentro da seção Administração, acesse Desenvolvimento do site > Importação e exportação de sites no menu lateral esquerdo.
2. No menu Importar, selecione a opção Sites de demonstração da Storefront Reference Architecture (SFRA).

3. Na tabela, selecione a opção Storefront Reference Architecture base e clique no botão Implementar.

4. Em seguida, acesse Administração > Desenvolvimento do site > Implantação de código no menu lateral esquerdo.
5. Em Gerenciar versões do código, selecione a versão de código que estiver ativa e faça o download.

1. Na sua loja, dentro da seção Administração, acesse Desenvolvimento do site > Implantação de código no menu lateral esquerdo.
2. Clique na versão ativa mais recente da sua loja.

3. Em Resumo da versão, clique em Download.

4. Por último, descompacte o arquivo .zip que você baixou.

Com isso, a última versão da loja terá sido baixada. Agora é possível avançar para o download do cartucho do Mercado Pago.

1. Acesse o Salesforce Partner Marketplace e busque "Mercado Pago".
2. Clique em Mercado Pago Cartridge for B2C Commerce. Uma vez dentro do site do cartucho, clique em Get It Now.

3. Você verá um aviso de redirecionamento para o repositório oficial do Mercado Pago no GitHub, onde deverá indicar que aceita os termos e condições e clicar em Visit Provider.
4. Dentro do repositório, siga as instruções da seção README para baixar a última versão do cartucho int_mercadopago.
5. Por último, descompacte o arquivo .zip que você baixou.

Com isso, o cartucho do Mercado Pago já foi baixado e é possível avançar com a integração da loja.

Nesta etapa, a loja será conectada ao cartucho do Mercado Pago. Para isso, primeiro você deverá armazenar o cartucho do Mercado Pago no site da loja.

1. Abra a pasta do cartucho do Mercado Pago obtido na etapa 2 e navegue até a pasta cartridges.
2. Abra a pasta que você baixou com a última versão da sua loja e copie todo o seu conteúdo.
3. Cole as pastas da sua loja dentro da pasta cartridges. Dessa forma, a pasta int_mercadopago deve ficar no mesmo nível que as pastas da sua loja.

Em seguida, integre o cartucho do Mercado Pago com a loja para que mantenha sua funcionalidade junto com outros cartuchos instalados. Para isso, siga estes passos:

1. Abra um Terminal ou CMD e acesse a pasta int_mercadopago.
2. Execute os seguintes comandos:

bash
Copiar
npm install
npm run build

Com isso, o cartucho já foi integrado no site da loja e é possível avançar com a configuração da conexão do ambiente de desenvolvimento local com a Salesforce.

No início da integração, o projeto deve ser preparado e conectado ao ambiente de teste do Salesforce Commerce Cloud usando uma ferramenta compatível com WebDav (protocolo para gerenciamento de arquivos via HTTP), como o Prophet Debugger ou similar.

Siga os passos a seguir:

1. Caso ainda não tenha, crie uma Chave de acesso seguindo as indicações abaixo. Se já tiver, pule este passo.
   1. Acesse Meu perfil e, na coluna Credenciais, clique em Gerenciar Chaves de Acesso.
   2. Na coluna Escopo, selecione Acesso ao arquivo WebDAV e UX Studio para obter permissões de desenvolvimento.
   3. Clique em Gerar chave de acesso.

2. Na raiz do projeto, crie um arquivo com o nome "dw.json" e adicione o seguinte conteúdo, preenchendo cada dado com os da loja:

json
Copiar
{
  "hostname": "host do sandbox",
  "username": "email",
  "password": "password WebDAV",
  "code-version": "diretório"
}

3. Na raiz do projeto, crie uma pasta chamada ".vscode" e dentro dela, crie um arquivo chamado "launch.json" com o seguinte conteúdo:

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

Pronto, você já tem o ambiente de desenvolvimento local conectado com a Salesforce e pode seguir com a configuração do cartucho.

Para ativar o cartucho int_mercadopago e utilizá-lo como processador de pagamentos, siga os passos abaixo.

1. Acesse o painel de configuração do Salesforce Commerce Cloud, em Administração > Sites > Gerenciar sites.
2. Selecione o seu site e clique na aba Configurações.
3. Na opção Cartuchos, adicione int_mercadopago à lista antes de app_storefront_base, separando os valores por dois pontos. O resultado deve ficar conforme a imagem a seguir.

4. Clique em Aplicar para salvar as alterações.

Ao finalizar esta configuração, o Mercado Pago aparecerá como meio de pagamento disponível na sua loja. Siga a próxima etapa para adicionaros meios de pagamento.

Nesta etapa você poderá fazer o upload do arquivo "metadata" para a sua loja e, dessa forma, adicionar os meios de pagamento que o Mercado Pago oferece.

1. Abra a pasta do cartucho que você obteve na etapa 2, vá até a pasta metadata e comprima-a em um arquivo .zip.

2. Acesse o painel de configuração do Salesforce Commerce Cloud, em Administração > Desenvolvimento do site > Importação e exportação do site.
3. No menu Importar, clique em Selecionar arquivo, escolha o arquivo metadata.zip e, em seguida, clique em Fazer upload. Quando solicitado, confirme a ação clicando em Ok.
4. A confirmação do envio pode ser verificada no menu Status, localizado ao final da página. Use o botão Atualizar para recarregar, se necessário.

Quando você visualizar o arquivo metadata.zip dentro do menu Status, a configuração estará pronta. Você já pode continuar com a configuração das credenciais do Mercado Pago.

Você deverá vincular sua conta do Mercado Pago através das credenciais. Durante a etapa de integração, você deverá utilizar as credenciais de contas de testeChaves de acesso que identificam o seu usuário de teste, utilizadas em etapas de desenvolvimento ou para testar a integração. que você obteve em Criar aplicação. Siga os passos a seguir.

1. Acesse o painel de configuração do Salesforce Commerce Cloud, em Administração > Ferramentas do comerciante > Preferências do site > Preferências personalizadas.
2. Na tela Grupos de preferências personalizadas de site você verá a lista de configuração do Mercado Pago. Clique no ID MercadoPagoCredentials.
3. No campo Tipo de Instância, selecione Sandbox.
4. Dentro da tela Mercado Pago Credentials, preencha os campos conforme apropriado:

5. Clique em Salvar para confirmar a configuração.

Pronto! Você já vinculou sua conta do Mercado Pago com sua loja no Salesforce Commerce Cloud. Você pode avançar com a verificação da instalação.

Para verificar se o cartucho do Mercado Pago está corretamente instalado, siga estes passos.

1. Acesse o painel de configuração do Salesforce Commerce Cloud, em Administração > Ferramentas do comerciante > Pedidos > Processadores de pagamento.
2. Verifique se os processadores de pagamento do Mercado Pago estão dentro da tabela, na coluna ID do Processador.

Pronto, você já instalou e configurou o cartucho do Mercado Pago. A seguir, avance com a Configuração dos meios de pagamento.