VTEX - Plugins e plataformas - Mercado Pago Developers
Developers
Referência API
Suporte
Entrar

    Inicio

    Começando

    Pagamentos online

    Checkout Pro

    Checkout API

    Link de pagamento

    Assinaturas

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    Pagamentos presenciais

    Código QR

    Mercado Pago Point

    Plugins e plataformas

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    Tiendanube

    VTEX

    SDKs

    Notificações

    Webhooks

    IPN

    Gerenciamento de conta

    Requisitos para ir à produção

    Obter pagamentos

    Relatórios

    Devoluções e cancelamentos

    Gestão de estornos

    Melhora a aprovação

    Recursos

    Localização

    Changelog

    Status

NESTA PÁGINA

Sugerir alterações
Ajude-nos a melhorar a documentação
Você viu informações equivocadas, gostaria que explicássemos algo a mais ou que melhorássemos nossos manuais? Deixe suas sugestões no GitHub.

VTEX

O que é VTEX?

VTEX é uma plataforma e-commerce para sua loja virtual, que permite processar pagamentos através do Mercado Pago.

Você poderá oferecer aos seus clientes a possibilidade de pagar com cartão de crédito e boleto bancário no próprio checkout da sua loja ou redirecionado para o site do Mercado Pago.

Etapas para configurar

Os passos para começar a operar com Mercado Pago, são os seguintes:

  1. Crie uma conta de vendedor no Mercado Pago caso ainda não tenha uma.
  2. Cadastre uma afiliação de gateway de pagamento com o "Mercado Pago".
  3. Configure as condições de pagamento Mercado Pago.
  4. Configure device fingerprint.

Criando afiliação de gateway Mercado Pago

Para criar uma afiliação de gateway de pagamento com o Mercado Pago, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse Configurações do módulo de pagamentos.
  2. Na aba Afiliações de Gateways, clique no botão "+".
  3. Clique no conector MercadoPagoV1.
  4. Preencha os campos correspondentes e clique em "Salvar".
CamposDados necessários
Nome da afiliaçãoDefina o nome que identificará a sua Afiliação.
OAuth loginNão é utilizado. Deixe-o como está.
PublicKeyRefere-se às suas credenciais do Mercado Pago. Complete com sua Public Key.
AccessTokenRefere-se às suas credenciais do Mercado Pago. Complete com seu Access Token.
RefreshTokenDeixar em branco.
ExpiredTokenInDeixar em branco.
Merchant Account IdDeixar em branco.
Processing ModeEscolha aggregator, modo de processamento a partir de MercadoPagoV1.
CountryNameSelecione o país da sua loja.
SoftDescriptorIndique o nome que vai aparecer para identificar a transação realizada na sua loja.
DescriptionEscreva uma breve descrição do seu negócio (o preenchimento é opcional).
CategoryIdEscolha a categoria dos produtos que você vende na sua loja.
Financial InstitutionDeixar em branco. Preenchimento apenas se sua loja operar do "Chile".
External InstallmentsSim. Utilização das condições de parcelamento diretamente de sua conta Mercado Pago.
AntifraudInforme se deseja usar um antifraude.
Time ZoneIndique a região que define seu horário local.
OrderExpirationHoursDefina por quantas horas o sistema deve checar o status do pedido antes de sua expiração. Quando essa opção não é preenchida, é adotado o padrão de 192 horas.
MaxInstallmentsEscolha a quantidade máxima de parcelas enviadas ao Mercado Pago.
Categoria PrincipalEscolha a categoria que mais se encaixa com sua loja.
Captura de segurança antecipadaVocê pode desativar a função ou escolher em quanto tempo quer realizar a captura (depois da aprovação da transação e da análise do antifraude).

Setting affiliation in VTEX

E pronto! Sua afiliação com o Mercado Pago já está ativa!

Configurar condições de pagamento

Após ter criado sua afiliação com o Mercado Pago, você tem a opção de oferecer em sua loja pagamentos com cartão de crédito, boleto bancário e também pagamentos via Checkout Pro.

Condição de pagamento cartão de crédito

Para criar uma condição de pagamento cartão de crédito utilizando sua afiliação com o Mercado Pago, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
  2. Na aba "Condições de pagamento", clique no botão "+".
  3. Na seção "Cartão de Crédito", escolha qual bandeira irá adicionar ao meio de pagamento.
  4. Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
  5. Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
  6. Em opções de parcelamento, escolha parcelamento "Automático", onde utiliza as condições de parcelamento diretamente de sua conta Mercado Pago.
  7. Clique em "Salvar".

 

Setting payments in VTEX

Condição de pagamento boleto bancário

Para criar uma condição de pagamento boleto bancário utilizando sua afiliação com o Mercado Pago, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
  2. Na aba "Condições de pagamento", clique no botão "+".
  3. Na seção "Boleto", escolha "Boleto Bancário" para adicionar ao meio de pagamento.
  4. Informe o "nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
  5. Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
  6. Clique em "Salvar".

 

Setting payments in VTEX

Condição de pagamento Checkout Pro

O Checkout Pro é a integração que te permite cobrar através do nosso formulário web de forma simples, rápida e segura.

Configuração do meio de pagamento Mercado Pago

O comprador será redirecionado ao site do Mercado Pago e uma vez finalizado o processo, voltará para sua loja.

Para criar essa condição de pagamento, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
  2. Na aba "Condições de pagamento", clique no botão "+".
  3. Na seção "Outro", selecione a condição de pagamento "Mercado Pago".
  4. Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
  5. Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
  6. Clique em "Salvar".

 

Setting payments in VTEX

Configuração do meio de pagamento Mercado Pago PRO

O comprador finalizará o pagamento no Mercado Pago via formulário web modal diretamente em sua loja.

Para criar essa condição de pagamento, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
  2. Na aba "Condições de pagamento", clique no botão "+".
  3. Na seção "Outro", selecione a condição de pagamento "MercadoPagoPro ".
  4. Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
  5. Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
  6. Clique em "Salvar".

 

Setting payments in VTEX

Configuração do meio de pagamento Mercado Pago Wallet

O comprador finaliza o pagamento com a carteira do Mercado Pago exclusivamente de usuários cadastrados e uma vez concluído o processo, voltará para sua loja.

Para criar essa condição de pagamento, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
  2. Na aba "Condições de pagamento", clique no botão "+".
  3. Na seção "Outro", selecione a condição de pagamento "MercadoPagoWallet".
  4. Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
  5. Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
  6. Clique em "Salvar".

 

Setting payments in VTEX

Importante
Caso as condições de pagamento MercadoPagoPro e MercadoPagoWallet não estiverem disponíveis para adicioná-las, certifique em sua loja de aplicativos da VTEX que o App Mercado Pago Payment APP esteja instalado ou solicite a instalação pela equipe VTEX sob demanda através de ticket no Support VTEX.
Nota
As mudanças nas Condições de pagamento podem levar até 10 minutos para serem aplicadas.

Configurando o parcelamento em sua conta Mercado Pago

  1. Acesse sua conta Mercado Pago e clique em "Seu negócio"
  2. Clique na opção "Configurações", navegue até o campo "Oferecer parcelas sem acréscimo" e clique em "Ativar".
  3. Escolha "Quantas parcelas você quer oferecer?" e clique em "Ativar" para confirmar as alterações.

 

Setting affiliation in VTEX

E pronto! Você está oferecendo parcelamento sem acréscimo, assumindo as tarifas de parcelamento que você configurou.

Obtenha aprovação mais rápida enviando o device fingerprint

O Mercado Pago possui suas próprias ferramentas de prevenção de fraudes. Sempre que possível, recomendamos que envie informações sobre o comportamento do cliente para detectar movimentos incomuns e evitar transações fraudulentas. Não se preocupe, cuidamos dos dados de seus clientes e não os compartilhamos com ninguém.

Para configurar o device fingerprint, siga os passos abaixo:

  1. No painel de administração de sua loja, acesse Checkout do módulo "Configurações da Loja".
  2. Clique no ícone "editar", referente a configuração de seu site.
  3. Acessar a aba "Código" e clique em "checkout5-custom.js" no módulo arquivos.
  4. Copiar e colar o seguinte código e clique em "Salvar".

 

javascript

var script = document.createElement("script");
script.src = "https://www.mercadopago.com/v2/security.js";
script.setAttribute("output","vtex.deviceFingerprint");
script.setAttribute("view","checkout");
document.body.appendChild(script);

Setting deviceid in VTEX

Entendendo sobre os principais logs da VTEX

Os logs permitem revisar a informação que retorna Mercado Pago e VTEX expõe para poder ter um maior entendimento de o que ocorreu com uma transação. Também em caso de modificação ou ativação de novos meios de pagamento, nos dão a possibilidade de poder validar se tudo está funcionando segundo o previsto. Por último, provém um maior entendimento às equipes comerciais para que possam dar um melhor suporte aos vendedores e converter se em uma primeira instância de suporte.

Acesse a transação da VTEX, então busque pelo LOG que contenha o status response e clique em ver mais.

Os dados mais significativos são os seguintes:

CampoDadoDescrição
ID10302316Número da transação de Mercado Pago.
Payment_method_idvisaMeio de pagamento.
Payment_type_idcredit_cardMeio de pagamento.
StatusauthorizedEstado do pagamento.
Status_detailpending_captureDetalhe do estado do pagamento.
External_reference503451Identificador da VTEX enviado a Mercado Pago.
First_six_digits450995Bin do cartão de crédito.
Processing_modeagregadorModo de processamento do pagamento.

Quando confrontado com uma rejeição, é muito importante rever o status_detail que especifica o motivo do mesmo.

Para mais informações acesse o link Resultados da criação de uma cobrança.

Erros comuns

Os erros mais comuns são os seguintes:

MensagemSignificado
unauthorized_use_of_live_credentialsIsso significa que as credenciais da conta do Mercado Pago não estão ativadas. Você deve ir para a página de credenciais e ativá-las
invalid installmentsEstá sendo feita uma tentativa de processar o pagamento com uma taxa que não está ativada. Você deve acessar a configuração do método de pagamento e definir as taxas como "Automático".
invalid_usersVocê está tentando pagar com o mesmo usuário que está cobrando. Repetir o pagamento com um e-mail de pagador diferente.
Cannot infer Payment MethodVocê está tentando pagar com um cartão que não seja o tipo de cartão selecionado (por exemplo, um número de cartão de crédito foi inserido na opção de cartão de débito).
Importante
Antes de iniciar sua operação em produção, você deve ativar suas credenciais. Caso já tenha realizado este passo o link não será apresentado.
Para mais informação, visite o site oficial da VTEX e o site de status da Vtex.
Essas informações foram úteis?

Mercado Pago ofrece servicios de pago y no está autorizado por el Banco Central a operar como entidad financiera. Los fondos acreditados en cuentas de pago no constituyen depósitos en una entidad financiera ni están garantizados conforme legislación aplicable a depósitos en entidades financieras. Copyright © 2021 MercadoLibre S.R.L.

Termos e condiçõesComo cuidamos da sua privacidade
Partners Mercado Pago

Al navegar en este sitio aceptás las cookies que utilizamos para mejorar tu experiencia. Más información.