# Mercado Pago

O Mercado Pago recebe Pix, cartão e boleto, com o dinheiro caindo na sua conta do
Mercado Pago. É o gateway mais usado pelas lojas no Brasil.

Você precisa de uma conta no Mercado Pago (pessoa física ou jurídica). O passo a
passo também está no cartão do Mercado Pago, em **Configurações > Pagamentos**, no
botão **Como configurar o Mercado Pago, passo a passo**.

![O passo a passo do Mercado Pago aberto no painel, com a URL do webhook para copiar](shots/payments-mp.webp)

## 1. Crie a aplicação

1. Abra o
   [Painel do Desenvolvedor do Mercado Pago](https://www.mercadopago.com.br/developers/panel/app)
   e entre com a sua conta.
2. Clique em **Criar aplicação**.
3. Dê um nome (por exemplo, `Rede Pixel`), marque **Pagamentos online** e salve.

## 2. Copie a Public Key e o Access Token

1. Dentro da aplicação, abra **Credenciais de produção**, no menu lateral.
2. Copie a **Chave pública** e cole no campo **Public Key** do painel.
3. Copie o **Access token** e cole no campo **Access Token** do painel.

> [!WARNING]
> Use as credenciais de produção. As de teste só simulam: o jogador "paga" e nada
> cai na sua conta.

## 3. Configure o webhook

1. No menu lateral da aplicação, abra **Webhooks > Configurar notificações**.
2. Em **URL de produção**, cole a URL que o painel mostra (botão **Copiar URL**).
   Ela tem este formato:

   ```text URL do webhook
   https://webhooks.hystore.com.br/api/v1/webhooks/mercadopago/<id da sua loja>
   ```

3. Em **Eventos**, marque só **Pagamentos**.
4. Clique em **Salvar**.
5. O Mercado Pago mostra a **Chave secreta** (Signing Secret). Copie e cole no
   campo **Webhook Secret** do painel.

## 4. Ligue e salve

Ligue a chave do cartão do Mercado Pago e salve. Pronto: o Pix, o cartão e o
boleto aparecem para o jogador na hora de pagar.

> [!TIP]
> Faça uma compra de teste barata (um produto de R$ 1,00, por exemplo) com Pix. Se
> o pedido passar sozinho para **Pago** em poucos segundos, o webhook está certo.

## Problemas comuns

| O que acontece | O que fazer |
| --- | --- |
| O pedido fica em Pendente depois do Pix pago | Confira a URL de produção do webhook e se o evento **Pagamentos** está marcado |
| Erro ao salvar: Public Key ou Access Token | Os dois campos são obrigatórios e precisam ser de produção, da mesma aplicação |
| Pagamentos de teste não aparecem na conta | Credenciais de teste só simulam; troque pelas de produção |

Taxas do Mercado Pago no Financeiro: veja [Taxas dos gateways](/pt/payments/fees/).