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:
- Crie uma conta de vendedor no Mercado Pago caso ainda não tenha uma.
- Cadastre uma afiliação de gateway de pagamento com o "Mercado Pago".
- Configure as condições de pagamento Mercado Pago.
- 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:
- No painel de administração de sua loja, acesse Configurações do módulo de pagamentos.
- Na aba Afiliações de Gateways, clique no botão "+".
- Clique no conector MercadoPagoV1.
- Preencha os campos correspondentes e clique em "Salvar".
Campos | Dados necessários |
---|---|
Nome da afiliação | Defina o nome que identificará a sua Afiliação. |
OAuth login | Não é utilizado. Deixe-o como está. |
PublicKey | Refere-se às suas credenciais do Mercado Pago. Complete com sua Public Key. |
AccessToken | Refere-se às suas credenciais do Mercado Pago. Complete com seu Access Token. |
RefreshToken | Deixar em branco. |
ExpiredTokenIn | Deixar em branco. |
Merchant Account Id | Deixar em branco. |
Processing Mode | Escolha aggregator, modo de processamento a partir de MercadoPagoV1. |
CountryName | Selecione o país da sua loja. |
SoftDescriptor | Indique o nome que vai aparecer para identificar a transação realizada na sua loja. |
Description | Escreva uma breve descrição do seu negócio (o preenchimento é opcional). |
CategoryId | Escolha a categoria dos produtos que você vende na sua loja. |
Financial Institution | Deixar em branco. Preenchimento apenas se sua loja operar do "Chile". |
External Installments | Sim. Utilização das condições de parcelamento diretamente de sua conta Mercado Pago. |
Antifraud | Informe se deseja usar um antifraude. |
Time Zone | Indique a região que define seu horário local. |
OrderExpirationHours | Defina 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. |
MaxInstallments | Escolha a quantidade máxima de parcelas enviadas ao Mercado Pago. |
Categoria Principal | Escolha a categoria que mais se encaixa com sua loja. |
Captura de segurança antecipada | Você 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). |
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:
- No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
- Na aba "Condições de pagamento", clique no botão "+".
- Na seção "Cartão de Crédito", escolha qual bandeira irá adicionar ao meio de pagamento.
- Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
- Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
- Em opções de parcelamento, escolha parcelamento "Automático", onde utiliza as condições de parcelamento diretamente de sua conta Mercado Pago.
- Clique em "Salvar".
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:
- No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
- Na aba "Condições de pagamento", clique no botão "+".
- Na seção "Boleto", escolha "Boleto Bancário" para adicionar ao meio de pagamento.
- Informe o "nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
- Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
- Clique em "Salvar".
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:
- No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
- Na aba "Condições de pagamento", clique no botão "+".
- Na seção "Outro", selecione a condição de pagamento "Mercado Pago".
- Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
- Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
- Clique em "Salvar".
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:
- No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
- Na aba "Condições de pagamento", clique no botão "+".
- Na seção "Outro", selecione a condição de pagamento "MercadoPagoPro ".
- Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
- Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
- Clique em "Salvar".
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:
- No painel de administração de sua loja, acesse "Configurações" do módulo de pagamentos.
- Na aba "Condições de pagamento", clique no botão "+".
- Na seção "Outro", selecione a condição de pagamento "MercadoPagoWallet".
- Informe o "Nome da regra" para facilitar a identificação e ative a condição de pagamento no campo "Status".
- Informe sua afiliação com o Mercado Pago, no campo "Processar com a afiliação".
- Clique em "Salvar".
Configurando o parcelamento em sua conta Mercado Pago
- Acesse sua conta Mercado Pago e clique em "Seu negócio"
- Clique na opção "Configurações", navegue até o campo "Oferecer parcelas sem acréscimo" e clique em "Ativar".
- Escolha "Quantas parcelas você quer oferecer?" e clique em "Ativar" para confirmar as alterações.
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:
- No painel de administração de sua loja, acesse Checkout do módulo "Configurações da Loja".
- Clique no ícone "editar", referente a configuração de seu site.
- Acessar a aba "Código" e clique em "checkout5-custom.js" no módulo arquivos.
- 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);
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:
Campo | Dado | Descrição |
---|---|---|
ID | 10302316 | Número da transação de Mercado Pago. |
Payment_method_id | visa | Meio de pagamento. |
Payment_type_id | credit_card | Meio de pagamento. |
Status | authorized | Estado do pagamento. |
Status_detail | pending_capture | Detalhe do estado do pagamento. |
External_reference | 503451 | Identificador da VTEX enviado a Mercado Pago. |
First_six_digits | 450995 | Bin do cartão de crédito. |
Processing_mode | agregador | Modo 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:
Mensagem | Significado |
---|---|
unauthorized_use_of_live_credentials | Isso 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 installments | Está 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_users | Você está tentando pagar com o mesmo usuário que está cobrando. Repetir o pagamento com um e-mail de pagador diferente. |
Cannot infer Payment Method | Você 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). |