Webhooks Integrados: Mercado Pago com SprintHub

Essa integração com o Mercado Pago tem como objetivo trazer os dados de cadastro do Comprador, para dentro do SprintHub. Neste exemplo, iremos trazer somente o nome do cartão de crédito e o e-mail.

Pré-Requisito: Ter estudado e testado os tutoriais de Webhooks integrados: https://docs.sprinthub.com/topicos/analisar/webhooks-integrados

Fluxograma da integração.

Para melhor entendimento deste passo a passo, assista ao vídeo acima.

Passo 1:

Se cadastre e acesse a área de Developers do Mercado Pago:

https://www.mercadopago.com.br/developers/panel/app

Na tela de Apps, crie um novo app “Criar aplicação”.

Passo 2:

No SprintHub, em Campos Customizados, crie os campos que deseja trazer do Mercado Pago. No exemplo deste tutorial, além do Client ID e Merchand Order, estou trazendo somente o campo Order ID.

https://SUA_INSTANCIA.sprinthub.app/sh/fields/panel/lead

Mantenha o Client ID como Identificador único.

Passo 3:

Vá para Webhooks de Integração e crie um novo webhook Passivo.

https://SUA_INSTANCIA.sprinthub.app/sh/advwebhooks/panel?

Faça o mapeamento automático, mas depois crie um novo campo chamado ID pois o que vem na produção em vendas reais é diferente do que vem no envio de teste durante o mapeamento.

Ações Extras: Crie uma ação extra de “Enviar webhook de integração”. Essa etapa somente depois que você criar os webhooks ativos 02 e 03 conforme o video e conforme telas abaixo.

Configure o token conforme abaixo. Assista ao video para saber onde pegar o token.

Criação Automática de Leads: Atualize e crie automaticamente o Lead mapeando esses campos.

Passo 04:

Crie um Webhook Ativo chamado 02 - MP - Buscar Order ID

Mapeie conforme acima. É o que iremos buscar neste endpoint:

URL de destino:

https://api.mercadopago.com/merchant_orders/{contactfield=mp_merchant_order}

Na configuração do Array, estou buscando somente id e status, mas você poderá buscar outros dados dentro do objeto payment.

Validação de retorno: No exemplo, quero trazer somente o que tiver status approved.

Ações Extras: Estou adicionando o ID do pagamento no campo MP - Order ID.

Estou chamando o webhook 03, onde irei passar o ID do Payment para trazer os dados do comprador.

Passo 05:

Crie um novo webhook ativo, chamado 03 - MP - Busca Dados Pagamento com Order ID

URL de destino: https://api.mercadopago.com/v1/payments/{contactfield=id_da_compra}

Ações Extras: Essa chamada irá atualizar os campos do Contato, Nome e Email.