# Mercado Pago

Mercado Pago cobra Pix, tarjeta y boleto, con el dinero cayendo en tu cuenta de
Mercado Pago. Es la pasarela más usada por las tiendas en Brasil.

Necesitas una cuenta en Mercado Pago (persona o empresa). El paso a paso también
está en la tarjeta de Mercado Pago, en **Configuración > Pagos**, en **Cómo
configurar Mercado Pago, paso a paso**.

![El paso a paso de Mercado Pago abierto en el panel, con la URL del webhook para copiar](shots/payments-mp.webp)

## 1. Crea la aplicación

1. Abre el
   [Panel del Desarrollador de Mercado Pago](https://www.mercadopago.com.br/developers/panel/app)
   y entra con tu cuenta.
2. Haz clic en **Crear aplicación**.
3. Ponle un nombre (por ejemplo, `Rede Pixel`), marca **Pagos en línea** y guarda.

## 2. Copia la Public Key y el Access Token

1. Dentro de la aplicación, abre **Credenciales de producción**, en el menú
   lateral.
2. Copia la **Clave pública** y pégala en el campo **Public Key** del panel.
3. Copia el **Access token** y pégalo en el campo **Access Token** del panel.

> [!WARNING]
> Usa las credenciales de producción. Las de prueba solo simulan: el jugador
> "paga" y nada cae en tu cuenta.

## 3. Configura el webhook

1. En el menú lateral de la aplicación, abre **Webhooks > Configurar
   notificaciones**.
2. En **URL de producción**, pega la URL que muestra el panel (botón **Copiar
   URL**). Tiene este formato:

   ```text URL del webhook
   https://webhooks.hystore.com.br/api/v1/webhooks/mercadopago/<id de tu tienda>
   ```

3. En **Eventos**, marca solo **Pagos**.
4. Haz clic en **Guardar**.
5. Mercado Pago muestra la **Clave secreta** (Signing Secret). Cópiala y pégala en
   el campo **Webhook Secret** del panel.

## 4. Activa y guarda

Activa el interruptor de la tarjeta de Mercado Pago y guarda. Listo: el Pix, la
tarjeta y el boleto aparecen para el jugador al pagar.

> [!TIP]
> Haz una compra de prueba barata (un producto de R$ 1,00, por ejemplo) con Pix.
> Si el pedido pasa solo a **Pagado** en pocos segundos, el webhook está bien.

## Problemas comunes

| Qué pasa | Qué hacer |
| --- | --- |
| El pedido queda en Pendiente después de pagar el Pix | Revisa la URL de producción del webhook y que el evento **Pagos** esté marcado |
| Error al guardar: Public Key o Access Token | Los dos campos son obligatorios y deben ser de producción, de la misma aplicación |
| Los pagos de prueba no aparecen en la cuenta | Las credenciales de prueba solo simulan; cámbialas por las de producción |

Tarifas de Mercado Pago en Finanzas: mira [Tarifas de las pasarelas](/es/payments/fees/).