AyudaIntegracionesMercadoPago (BYO) — cómo funciona y cómo operarlo
    Integraciones

    MercadoPago (BYO) — cómo funciona y cómo operarlo

    Conectá Mercado Pago desde las credenciales hasta un pago confirmado, incluyendo pruebas, webhooks y puesta en producción.

    Qué resuelve

    Mercado Pago permite que el cliente pague desde el checkout de la tienda. Structura necesita poder identificar la cuenta del comercio, iniciar la operación y recibir/consultar su resultado.

    Antes de empezar

    1. Tener una cuenta de Mercado Pago habilitada.
    2. Crear o acceder a una aplicación en Mercado Pago Developers.
    3. Separar credenciales de prueba y producción.
    4. Tener claro qué flujo querés utilizar: checkout, transferencia/QR u otro método expuesto por el panel.

    Credenciales

    Desde Mercado Pago Developers obtené las credenciales del entorno correspondiente. La Public Key se utiliza para componentes públicos cuando corresponda; el Access Token es una credencial sensible y no debe publicarse en el frontend.

    Configurar en Structura

    1. Abrí Pagos.
    2. Activá Mercado Pago.
    3. Pegá las credenciales solicitadas por la pantalla.
    4. Guardá.
    5. Confirmá que el proveedor aparezca conectado.

    Circuito completo

    Cliente inicia checkout → Structura crea/inicia operación → Mercado Pago procesa → Mercado Pago notifica/permite consultar → Structura actualiza pago → pedido continúa.

    El webhook es parte del circuito. No alcanza con que el navegador muestre “aprobado”.

    Prueba correcta

    Usá credenciales y medios de prueba del ambiente correspondiente. Creá un pedido pequeño, completá el pago y verificá dos cosas por separado: estado del pago y estado del pedido.

    Si queda pendiente

    No vuelvas a cobrar. Primero comprobá proveedor, ambiente, identificador de operación y recepción de la confirmación.

    Producción

    Reemplazá credenciales de prueba por las productivas, verificá URLs/configuración de notificación y hacé una operación controlada antes de anunciar el checkout.

    Documentación oficial: Mercado Pago Developers · Referencia API.

    Seguí desde acá

    Otras guías que completan esta tarea.