# Integração do Mercado Pago

> Conecte sua conta Mercado Pago para receber Pix, cartão de crédito, débito e boleto na sua loja.

Fonte: https://ajuda.stoqui.com.br/integracao-do-mercado-pago
Atualizado em: 2026-04-29

Conecte sua conta Mercado Pago para aceitar **Pix, cartão de crédito (com parcelamento), cartão de débito e boleto** na sua loja. Os pagamentos confirmados atualizam automaticamente o status do pedido no Stoqui.

Confira como funcionam as [taxas neste outro tutorial](/como-funcionam-as-taxas-no-stoqui).

## Pré-requisitos

- **Conta no Mercado Pago.** Se ainda não tem, [cadastre-se em mercadopago.com.br](https://www.mercadopago.com.br/registration-mp) — é gratuito.

## Passo a Passo

### 1. Conectar a conta

No app Stoqui, vá em **Geral › Meios de pagamento** e selecione **Mercado Pago**.

![Mercado Pago menu](https://ajuda.stoqui.com.br/img/help/img-mercado-pago.jpg)

Clique em **Conectar conta**. Você será redirecionado para o Mercado Pago para fazer login e autorizar a integração.

![Mercado Pago conectar](https://ajuda.stoqui.com.br/img/help/img-mercado-pago-1.jpg)

Após autorizar, você volta automaticamente para o Stoqui com a conta conectada.

![Mercado Pago autorizar](https://ajuda.stoqui.com.br/img/help/img-mercado-pago-2.jpg)

### 2. Definir como padrão no checkout

Após conectar, na seção **Padrão no checkout** você decide quais métodos passam pelo Mercado Pago:

- **Pix** — quando ativado, o Pix do checkout passa pela sua conta Mercado Pago, com confirmação automática do pagamento.
- **Cartão de crédito** — quando ativado, os pagamentos com cartão passam pelo Mercado Pago.

Esses switches são exclusivos com o [Asaas](/integracao-com-asaas) — ativar um aqui desativa o equivalente lá.

### 3. Verificar o diagnóstico

Se algo na sua conta do Mercado Pago precisar de atenção (por exemplo, Pix não habilitado ou parcelamento desatualizado), o Stoqui mostra um cartão de **Diagnóstico** com instruções e atalhos para resolver direto na interface do Mercado Pago.

Quando o parcelamento está fora de sincronia, há um botão **Sincronizar** que puxa as configurações de parcelamento do Mercado Pago para o Stoqui automaticamente.

## Configurações de parcelamento

O parcelamento é gerenciado **inteiramente no Mercado Pago** — você define as parcelas com e sem juros direto no aplicativo deles, e o Stoqui sincroniza automaticamente.

Para ajustar, abra o app do Mercado Pago no celular:

- **Cobranças com 2 cartões** — Menu **Mais › Cobrar › Ferramentas › Configurações › Preferências de pagamento** › habilite a opção de pagamento com dois meios diferentes.
- **Parcelas sem juros** — Menu **Mais › Cobrar › Ferramentas › Taxas e parcelamento › Parcelamento › Oferecer**.

Outras configurações de checkout (parcelamento detalhado, desconto Pix) ficam em [Configurações do checkout](/configuracoes-do-checkout).

## Como o cliente paga

O pagamento acontece direto na sua loja, **sem redirecionar para o site do Mercado Pago**. Na última etapa do checkout, o cliente vê o **QR Code do Pix** e o **formulário de cartão de crédito** dentro da própria página do Stoqui. Boleto e cartão de débito também aparecem como opções. A confirmação é automática.

## Desconectar

Para desconectar, abra o menu de **3 pontinhos** no canto superior direito da tela do Mercado Pago no Stoqui e clique em **Desconectar conta**.

> **Atenção:** ao desconectar, seus clientes deixam de pagar via Mercado Pago até você reconectar. Se a conexão falhar (por expiração, por exemplo), o Stoqui exibe um aviso vermelho — basta desconectar e conectar de novo.
