Skip to main content

Guia de Integração | Mercado Pago

sgptsmx-petroleo.png
1. Introdução

A integração do Mercado Pago ao SGP é uma solução fundamental para empresas que desejam oferecer meios de pagamento modernos e seguros aos seus clientes. Essa conexão permite que transações sejam processadas em tempo real, de forma totalmente automatizada, eliminando a necessidade de conciliações manuais e aumentando a eficiência operacional.

Entre os principais benefícios, destacam-se:

  • Agilidade no recebimento: os pagamentos por cartão são processados instantaneamente, acelerando o fluxo de caixa e melhorando a previsibilidade financeira.

  • Segurança nas transações: gateways utilizam padrões avançados de criptografia e protocolos de segurança, reduzindo riscos de fraudes.

  • Melhoria na experiência do cliente: a possibilidade de pagar por cartão de crédito oferece mais conveniência, ampliando as opções de cobrança e aumentando a satisfação do consumidor.

  • Controle centralizado: todas as transações ficam concentradas no SGP, permitindo relatórios unificados e gestão integrada de recebíveis.

Dessa forma, a integração com gateways de cartão de crédito não só amplia as formas de cobrança disponíveis, como também garante maior segurança, rapidez e confiabilidade no processo de gestão financeira da empresa.

Antes de iniciar o processo, consulte nossa FAQ Boas Práticas para uma Integração Segura para garantir uma implementação mais segura e eficiente.

2. Dados necessários para integrar ao SGP

Nessa etapa é preciso acessar a plataforma do Mercado Pago para criar uma aplicação que vai fornecer as credenciais em produção para a integração com o SGP.

Você vai precisar dos seguintes dados:

  • Token

Durante essa etapa, crie a aplicação no Mercado Pago seguindo as instruções do suporte do banco.

Para essa integração usamos o Wix com CheckOut Pro

3. Cadastro do Gateway PIX

Com os dados em mãos, podemos integrar o Gateway ao SGP para emissão de PIX.

  • No Menu Principal, acesse Financeiro (❶), depois vá em Cadastros (❷) e, em seguida, clique em Gateway de Pagamento (❸).

Modelo_de_imagem_horizontal_com_sombra.png

Esse modelo de integração é apenas para emissão de PIX, a integração do SGP com o Mercado Pago não gera código de barras

Clique no botão Cadastrar e preencha da seguinte forma:

  1. Nome da Integração: Santander API
  2. Descrição
  3. Token: insira o Token em produção
  4. Habilite Pagamentos via PIX
  5. Selecione o Portador que deseja vincular o pix
  6. URL de Notificação: URLDOSGP/ws/mercadopago/IDGATEWAY/notificacao/pix/

Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais

Imagem de Referência (API PIX)

gateway.png

4. Cadastro do Gateway CheckOut

Agora vamos integrar o Gateway ao SGP para cobranças com cartão, o acesso é pelo mesmo menu do Gateway PIX


O Gateway de Checkout pode ser associado a portadores já cadastrados no sistema, habilitando neles a opção de pagamento por cartão.

Clique no botão Cadastrar e preencha da seguinte forma:

  1. Nome da Integração: Santander API
  2. Descrição
  3. Token: insira o Token em produção
  4. Habilite Pagamentos via PIX
  5. Selecione o Portador que deseja vincular o pix
  6. URL de Notificação: URLDOSGP/ws/mercadopago/notificacao/

Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais

Imagem de Referência (API Cartão CheckOut)

cart.png

5. Informações Adicionais
  • No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
    • Para identificá-lo, siga os passos:
      • Crie um gateway deixando o campo “URL de notificação” em branco.
      • Anote o ID gerado.
      • Em seguida, cadastre a URL de notificação utilizando esse ID.
  • Ao efetuar o pagamento de uma cobrança com cartão, o boleto vinculado a essa cobrança, caso já esteja registrado no banco, será automaticamente cancelado.
  • A integração funciona junto do PIX e dividem as mesmas credenciais

  • A seguir, listamos algumas funcionalidades disponíveis para a sua integração:

Funcionalidade Mercado Pago
PIX - Emissão ✔️
PIX - Cancelamento ✔️
PIX - Tipo de Baixa/Retorno Webhook
Cartão de Crédito - Emissão ✔️
Cartão de Crédito - Liquidação Webhook
Parâmetros forcar_atualizacao_pix=1
É cov ou cobv? cob


tsmx-petroleo.png

Back to top