Pagamentos com cartão
Para oferecer pagamentos com cartão e processar a cobrança através do Mercado Pago, você deve configurar cada bandeira de cartão de crédito que deseja oferecer e, em seguida, selecionar o Mercado Pago como provedor de processamento. A seguir, explicamos como realizar essa configuração.
-
No menu lateral, selecione Configurações da loja > Pagamentos > Configurações.
-
Na aba Condições de pagamento, clique no botão com o símbolo + no canto superior direito da tela para adicionar um novo meio de pagamento.

- Procure a categoria Cartão de crédito e selecione a bandeira que deseja configurar.

-
Complete os campos necessários:
- Nome da Condição: escolha um nome que permita identificar este meio de pagamento e clique no símbolo de confirmação localizado à direita para salvá-lo.
- Status: ative o meio de pagamento usando o botão deslizante.
- Processar com provedor: selecione MercadoPagoV2.
-
Selecione a opção À vista.
-
Opcionalmente, você pode adicionar requisitos especiais clicando no botão Adicionar condição especial.
- Data de vencimento: Permite limitar a atividade do meio de pagamento apenas por períodos de datas específicos ou estabelecer uma recorrência.
- Emissor do cartão: permite limitar a atividade do meio de pagamento de acordo com o país e o banco emissor do cartão.
- Política comercial (Canal de vendas): Disponibiliza uma condição de pagamento exclusivamente para uma ou várias políticas comerciais específicas.
- Condição comercial: Cria regras que se aplicam a grupos específicos de SKUs e determina critérios para que um meio de pagamento apareça no checkout da loja.
- Nome da conta: Este campo só deve ser preenchido caso você tenha mais de uma loja registrada na mesma conta VTEX. Nesses casos, você deverá selecionar em qual loja deseja configurar o meio de pagamento.
-
Clique em Salvar para ativar a configuração.

-
No menu lateral, selecione Configurações da loja > Pagamentos > Configurações.
-
Na aba Condições de pagamento, clique no botão com o símbolo + no canto superior direito da tela para adicionar um novo meio de pagamento.

- Procure a categoria Cartão de crédito e selecione a bandeira que deseja configurar.

-
Complete os campos necessários:
- Nome da Condição: escolha um nome que permita identificar este meio de pagamento e clique no símbolo de confirmação localizado à direita para salvá-lo.
- Status: ative o meio de pagamento usando o botão deslizante.
- Processar com provedor: selecione MercadoPagoV2.
-
Selecione a opção Parcelado e complete os campos necessários:
- Total de parcelas: defina o número de parcelas sequenciais (ex.: 1–12) ou individuais (ex.: 1, 3, 6). Você pode oferecer até 12 parcelas.
- Parcela mínima: defina um valor mínimo de compra a partir do qual a opção de pagamento será disponibilizada.
- Política comercial (Canal de vendas): Disponibiliza uma condição de pagamento exclusivamente para uma ou várias políticas comerciais específicas.
- Faturas: este campo só será considerado para parcelas com acréscimos, portanto qualquer opção é válida.
O número de parcelas configurado nesta instância terá prioridade sobre as parcelas máximas indicadas durante a configuração do provedor de pagamentos. Recomendamos indicar a mesma quantidade para evitar inconsistências. -
Clique em Salvar para ativar a configuração.

Você pode configurar parcelas com acréscimos para pagamentos com cartão de crédito e definir a taxa de acréscimos para cada parcela. Para isso, primeiro instale o aplicativo Mercado Pago installments connection e depois configure os pagamentos parcelados com acréscimos para a bandeira que deseja oferecer.
Siga os passos abaixo.
Instalar Mercado Pago installments connection
Para garantir que as condições de parcelamento e acréscimos configuradas na VTEX coincidam com as do Mercado Pago e evitar inconsistências na cobrança, configure o aplicativo Mercado Pago installments connection. Siga os passos:
- No menu lateral, selecione Aplicativos > Hub de extensões > App Store.
- No campo de busca, digite Mercado Pago installments connection e selecione o aplicativo.

- Clique em Instalar. Uma janela pop-up aparecerá com os termos e condições. Se concordar, confirme clicando em Instalar.
- Clique no botão Item #0 para vincular a conta do Mercado Pago do vendedor à loja VTEX. Nesta tela, serão solicitadas as credenciais do Mercado Pago para a autorização do provedor. Preencha os campos:
| Campo | Descrição |
| API key | Este campo faz referência à Public Key da aplicação do Mercado Pago. Como você está em etapa de desenvolvimento, deverá utilizar a Public Key da aplicação do usuário de testeChave pública da aplicação de testes criada com seu usuário de testes. É utilizada no backend para poder testar seu desenvolvimento. Você pode acessá-la fazendo login com seu usuário de testes e acessando Suas integrações > Detalhes da aplicação > Produção > Credenciais de produção.. Mais adiante, poderá trocá-la por uma produtiva. |
| API Token | Este campo faz referência ao Access Token da aplicação do Mercado Pago. Como você está em etapa de desenvolvimento, deverá utilizar o Access Token da aplicação do usuário de testeChave privada da aplicação de testes criada com seu usuário de testes. É utilizada no backend para poder testar seu desenvolvimento. Você pode acessá-la fazendo login com seu usuário de testes e acessando Suas integrações > Detalhes da aplicação > Produção > Credenciais de produção.. Mais adiante, poderá trocá-lo por um produtivo. |
- Na seção Métodos de pagamento, desmarque as bandeiras de cartões de crédito que não correspondem ao país em que a loja VTEX opera.

- Por fim, clique em Salvar para concluir a instalação
Adicionar pagamentos com cartão de crédito em parcelas com acréscimos
-
No menu lateral, selecione Configurações da loja > Pagamentos > Configurações.
-
Na aba Condições de pagamento, clique no botão com o símbolo + no canto superior direito da tela para adicionar um novo meio de pagamento.

- Procure a categoria Cartão de crédito e selecione a bandeira que deseja configurar.

-
Complete os campos necessários:
- Nome da Condição: escolha um nome que permita identificar este meio de pagamento e clique no símbolo de confirmação localizado à direita para salvá-lo.
- Status: ative o meio de pagamento usando o botão deslizante.
- Processar com provedor: selecione MercadoPagoV2.
-
Selecione a opção Parcelado e complete os campos necessários:
- Total de parcelas: defina o número de parcelas sequenciais (ex.: 1–12) ou individuais (ex.: 1, 3, 6). Você pode oferecer até 12 parcelas.
- Parcela mínima: defina um valor mínimo de compra a partir do qual a opção de pagamento será disponibilizada.
- Política comercial (Canal de vendas): Disponibiliza uma condição de pagamento exclusivamente para uma ou várias políticas comerciais específicas.
- Faturas: este campo só será considerado para parcelas com acréscimos, portanto qualquer opção é válida.
O número de parcelas configurado nesta instância terá prioridade sobre as parcelas máximas indicadas durante a configuração do provedor de pagamentos. Recomendamos indicar a mesma quantidade para evitar inconsistências. -
Em seguida, clique no botão Definir taxa de juros. As taxas de acréscimos serão configuradas automaticamente com base nas que você tiver definidas em sua conta do Mercado Pago.
-
Clique em Salvar para ativar a configuração.

-
No menu lateral, selecione Configurações da loja > Pagamentos > Configurações.
-
Na aba Condições de pagamento, clique no botão com o símbolo + no canto superior direito da tela para adicionar um novo meio de pagamento.

- Procure a categoria Cartão de crédito e selecione a bandeira que deseja configurar.

-
Complete os campos necessários:
- Nome da Condição: escolha um nome que permita identificar este meio de pagamento e clique no símbolo de confirmação localizado à direita para salvá-lo.
- Status: ative o meio de pagamento usando o botão deslizante.
- Processar com provedor: selecione MercadoPagoV2.
-
Opcionalmente, você pode adicionar requisitos especiais clicando no botão Adicionar condição especial.
- Data de vencimento: Permite limitar a atividade do meio de pagamento apenas por períodos de datas específicos ou estabelecer uma recorrência.
- Emissor do cartão: permite limitar a atividade do meio de pagamento de acordo com o país e o banco emissor do cartão.
- Política comercial (Canal de vendas): Disponibiliza uma condição de pagamento exclusivamente para uma ou várias políticas comerciais específicas.
- Condição comercial: Cria regras que se aplicam a grupos específicos de SKUs e determina critérios para que um meio de pagamento apareça no checkout da loja.
- Nome da conta: Este campo só deve ser preenchido caso você tenha mais de uma loja registrada na mesma conta VTEX. Nesses casos, você deverá selecionar em qual loja deseja configurar o meio de pagamento.
-
Clique em Salvar para ativar a configuração.
