12 de junio de 2026

¿Cómo creo un link de pago con MercadoPago desde Node.js o curl?

Un link de pago en MercadoPago se crea como una preferencia vía POST a https://api.mercadopago.com/checkout/preferences. La respuesta incluye init_point (producción) y sandbox_init_point (pruebas). Solo necesitás tu Access Token.

Estructura mínima de la request

POST https://api.mercadopago.com/checkout/preferences
Authorization: Bearer {ACCESS_TOKEN}

{
  "items": [{
    "title": "Producto X",
    "quantity": 1,
    "currency_id": "ARS",
    "unit_price": 5000.00
  }],
  "back_urls": {
    "success": "https://tu-sitio.com/pago/ok",
    "failure": "https://tu-sitio.com/pago/error"
  },
  "auto_return": "approved",
  "notification_url": "https://tu-sitio.com/webhooks/mp",
  "external_reference": "orden-12345"
}

Campos críticos que se olvidan

external_reference: tu ID de orden interno para conciliación posterior.
notification_url: para recibir el estado sin que el usuario tenga que volver.
expires + expiration_date_to: para hacer el link con vencimiento.
statement_descriptor: texto que aparece en el resumen de tarjeta del comprador.

La respuesta incluye init_point (URL de producción) y sandbox_init_point (URL de prueba).