Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar

Mercado Pago

Nesta página

Comece com o Mercado Pago#

Esta página fornece um guia completo para integrar o Mercado Pago com DEUNA.

Como funciona

O Mercado Pago permite que você ofereça aos seus clientes a opção de salvar o cartão para facilitar futuras compras.

Mercado Pago tokeniza cartões através de API ou widget. A DEUNA utiliza esta solução para tokenizar e armazenar cartões no cofre.

Valida se o cartão está operacional antes de armazená-lo no Mercado Pago.

Você pode realizar a validação de duas maneiras:

  • Autenticação zero dólar
  • Cobrar com valor mínimo

Autenticação zero dólar

O autenticação de zero dólar a validação consiste na realização de uma cobrança de validação com valor zero.

Esta operação está disponível apenas com Visa e Mastercard para Argentina e Brasil.

Cobrar com valor mínimo

O cobrar com valor mínimo a validação consiste na realização de uma cobrança de validação de valor baixo, que é reembolsada imediatamente.

Esta operação está disponível para franquias e países onde a autenticação Zero dólar não está disponível.

Requisitos#

O requisito para integrar o Mercado Pago é ter uma conta de vendedor no Mercado Pago ou Mercado Libre.

Integrar Mercado Pago

Agora que os requisitos técnicos foram estabelecidos, você pode iniciar a integração.

1. Ative o webhook do Mercado Pago

Para ativar a tokenização com Mercado Pago, devemos primeiro ativar a validação do webhook do Mercado Pago.

O que é o webhook

Um webhook é uma ferramenta que facilita o recebimento de notificações em tempo real sempre que ocorre um evento específico.

Para certificar que o Mercado Pago é a origem dessas notificações, uma validação do requests que chegam ao nosso webhook foi implementado.

2. Valide o webhook

O Mercado Pago sempre nos enviará uma chave secreta no requests eles enviam para o nosso webhook, o que nos permitirá validar a origem do mesmo.

3. Obtenha o URL do webhook

Entre em contato com a equipe DEUNA para solicitar a URL do webhook do Mercado Pago.

4. Configure o webhook:

Configure o webhook do Mercado Pago painel do desenvolvedor. Para fazer isso, você deve fazer o seguinte:

  1. Entre no painel do desenvolvedor e selecione sua integração.


  2. No menu esquerdo, selecione Webhooks.


  3. Clique em Configurar notificações.

  4. Em Modo de produção, insira o URL que fornecemos a você.

  5. Selecione os eventos Payments e Fraud alerts

  6. Clique em salvar configuração.

5. Obtenha a chave secreta

Na seção webhooks, você deve obter sua chave secreta para operar.

  1. Obtenha o chave secreta clicando no botão de senha.

  2. Envie a chave secreta obtida para a equipe DEUNA.

  3. Nós nos encarregaremos de fazer as configurações necessárias.

6. Ative a tokenização no PSP

Assim que a equipe DEUNA confirmar que todas as configurações necessárias foram concluídas com sucesso, devemos ativar a tokenização no PSP.

  1. Digite o ADMIN
  2. Acesse Conexões e procure a configuração do Mercado Pago
  3. Ative o salvar cartões no PSP caixa de seleção
  4. Clique em editar.

7. Verifique a validação

Quando a tokenização com Mercado Pago é realizada corretamente:

  1. A resposta chega do Crie um cartão endpoint.
  2. O vault.provider atributo tem o valor Mercadopago.
JSON
"vault": {
	"provider": "Mercadopago",
	"id": "id of the vault provider"
}
  1. O verified_by O atributo contém os possíveis métodos de validação.
JSON
"data": {
  "verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}

Observação:#

  • O external_reference campo deve atender aos seguintes requisitos:
    • Comprimento máximo: 64 caracteres
    • Caracteres permitidos: caracteres alfanuméricos (letras e números), hífens (-) e sublinhados (_)
    • Restrição: Caracteres especiais como o símbolo de hash (#), parênteses, colchetes ou outros símbolos de pontuação não são permitidos.