Gestiona pagos

Mercado Pago es la plataforma abierta de pagos de Mercado Libre. Si deseas integrar una solución de pagos en tu plataforma, puedes ingresar a Mercado Pago Developers.

Contenidos

→Recibir una notificación
→Obtener detalle de un pago
→Múltiples pagos
→Flujo de devolución de dinero en cuenta por ventas canceladas


Recibir una notificación

Para recibir notificaciones de pagos, asegúrate de suscribir tu aplicación al tópico payments. Conoce el resto de topics disponibles y más detalles sobre el tópico payments.


Obtener detalle de un pago

Para obtener información del pago de un comprador realiza el siguiente GET:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadopago.com/v1/payments/$PAYMENT_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadopago.com/v1/payments/3506756222

Respuesta:

{
  "counter_currency": null,
  "acquirer_reconciliation": [
  ],
  "statement_descriptor": "MERCADOPAGO",
  "captured": true,
  "fee_details": [
    {
      "amount": 487.2,
      "fee_payer": "payer",
      "type": "financing_fee"
    }
  ],
  "acquirer": null,
  "date_last_updated": "2018-03-05T10:06:55.000-04:00",
  "date_created": "2018-03-05T10:06:54.000-04:00",
  "id": 3506756222,
  "merchant_account_id": null,
  "issuer_id": "157",
  "date_of_expiration": null,
  "external_reference": "1653027692",
  "order": {
    "id": "1653027692",
    "type": "mercadolibre"
  },
  "transaction_amount": 3500,
  "description": "Maquina Industrial Recta Marca ",
  "card": {
    "id": null,
    "first_six_digits": "371772",
    "expiration_month": 10,
    "cardholder": {
      "identification": {
        "number": null,
        "type": null
      },
      "name": "JOAN C GONZALEZ GUZMAN"
    },
    "date_last_updated": "2018-03-05T10:06:54.000-04:00",
    "date_created": "2018-03-05T10:06:54.000-04:00",
    "expiration_year": 2019,
    "last_four_digits": "1001"
  },
  "transaction_details": {
    "total_paid_amount": 3987.2,
    "acquirer_reference": null,
    "payment_method_reference_id": null,
    "net_received_amount": 3500,
    "financial_institution": null,
    "payable_deferral_period": null,
    "installment_amount": 443.02,
    "external_resource_url": null,
    "overpaid_amount": 0
  },
  "coupon_amount": 0,
  "merchant_number": null,
  "call_for_authorize_id": null,
  "metadata": {
  },
  "currency_id": "MXN",
  "money_release_schema": null,
  "collector_id": 277582551,
  "status": "approved",
  "sponsor_id": null,
  "deduction_schema": null,
  "payment_method_id": "amex",
  "additional_info": {
    "items": [
      {
        "id": "MLM610028711",
        "title": "Maquina Industrial Recta Marca",
        "picture_url": null,
        "description": null,
        "category_id": "MLM184696",
        "quantity": "1",
        "unit_price": "3500"
      }
    ]
  },
  "processing_mode": "aggregator",
  "status_detail": "accredited",
  "binary_mode": false,
  "operation_type": "regular_payment",
  "installments": 9,
  "money_release_date": "2018-03-26T10:06:55.000-04:00",
  "payer": {
    "id": "53745235",
    "first_name": "Joan Carlos",
    "phone": {
      "extension": null,
      "area_code": null,
      "number": "5558800201"
    },
    "email": null,
    "identification": {
      "number": "83092109600",
      "type": "IFE"
    },
    "last_name": "Gonzalez Guzman",
    "entity_type": null,
    "type": "registered"
  },
  "notification_url": null,
  "transaction_amount_refunded": 0,
  "refunds": [
  ],
  "date_approved": "2018-03-05T10:06:55.000-04:00",
  "authorization_code": "211118",
  "payment_type_id": "credit_card",
  "live_mode": true
}

Consulta más detalle sobre cómo buscar un pago y obtener un pago en Mercado Pago Developers.


Múltiples pagos

En algunos casos, cuando se rechaza el pago por llegar al límite de la tarjeta de crédito, permitimos a los usuarios agregar otro pago con una segunda tarjeta de crédito.

Cuando realizas una solicitud GET a la API de órdenes, verás que dentro del conjunto de pagos habrá dos ID con los detalles de cada pago.
Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/893431118

Respuesta:

{
  "buyer": {
      "alternative_phone": {
          "area_code": null,
          "extension": null,
          "number": ""
      },
      "billing_info": {
          "doc_number": "67045427794",
          "doc_type": "CPF"
      },
      "email": "test_user_21963158@testuser.com",
      "first_name": "Test",
      "id": 160903317,
      "last_name": "Test",
      "nickname": "TETE2022123",
  },
  "coupon": {
      "amount": 0,
      "id": null
    },
  "currency_id": "BRL",
  "date_closed": null,
  "date_created": "2014-10-26T22:46:18.000-04:00",
  "feedback": {
      "purchase": null,
      "sale": null
  },
  "id": 893431118,
  "last_updated": "2014-10-26T22:50:10.000-04:00",
    "mediations": [],
  "order_items": [
      {
          "currency_id": "BRL",
          "item": {
              "id": "MLB600034093",
              "title": "Item De Testeo, Por Favor No Ofertar --kc:off",
              "variation_attributes": [],
              "variation_id": null
          },
          "quantity": 1,
          "unit_price": 591
      }
  ],
  "paid_amount": 591,
  "payments": [
      {
          "activation_uri": null,
          "atm_transfer_reference": {
              "company_id": null,
                "transaction_id": null
          },
            "available_actions": [],
          "card_id": null,
          "collector": {
              "id": 169648308
          },
          "coupon_amount": 0,
          "coupon_id": null,
          "currency_id": "BRL",
          "date_created": "2014-10-26T22:48:46.000-04:00",
            "date_last_modified": "2014-10-27T00:51:53.000-04:00",
          "id": 885920310,
          "installments": 1,
          "issuer_id": "25",
          "operation_type": "regular_payment",
          "order_id": 893431118,
          "overpaid_amount": 0,
          "payer_id": 160903317,
            "payment_method_id": "visa",
          "payment_type": "credit_card",
          "reason": "Item De Testeo, Por Favor No Ofertar --kc:off",
          "shipping_cost": 0,
          "site_id": "MLB",
          "status": "approved",
          "status_code": null,
          "status_detail": "accredited",
            "total_paid_amount": 296,
            "transaction_amount": 296
      },
      {
          "activation_uri": null,
            "atm_transfer_reference": {
              "company_id": null,
                "transaction_id": null
          },
            "available_actions": [],
          "card_id": null,
          "collector": {
              "id": 169648308
          },
          "coupon_amount": 0,
          "coupon_id": null,
          "currency_id": "BRL",
          "date_created": "2014-10-26T22:50:10.000-04:00",
            "date_last_modified": "2014-10-26T22:50:21.000-04:00",
          "id": 885920410,
          "installments": 3,
          "issuer_id": "25",
          "operation_type": "regular_payment",
          "order_id": 893431118,
          "overpaid_amount": 0,
          "payer_id": 160903317,
            "payment_method_id": "visa",
          "payment_type": "credit_card",
          "reason": "Item De Testeo, Por Favor No Ofertar --kc:off",
          "shipping_cost": 0,
          "site_id": "MLB",
          "status": "approved",
          "status_code": null,
          "status_detail": "accredited",
            "total_paid_amount": 315.62,
            "transaction_amount": 295
      }
  ],
  "seller": {
      "alternative_phone": {
          "area_code": null,
          "extension": null,
          "number": ""
      },
      "email": "test_user_70385259@testuser.com",
      "first_name": "Test",
      "id": 169648308,
      "last_name": "Test",
      "nickname": "TETE6072468",
      "phone": {
          "area_code": "01",
          "extension": null,
          "number": "1111-1111"
      }
  },
  "shipping": {
      "status": "null"
  },
  "status": "paid",
  "status_detail": null,
  "tags": [
      "not_delivered",
      "paid"
  ],
  "total_amount": 591,

}

Flujo de devolución de dinero en cuenta por ventas canceladas

Importante:
Solo está disponible para vendedores de México y próximamente, para aquellos de Argentina y Brasil.

Ante cancelaciones, los compradores con buena reputación y que realicen pagos con tarjeta de crédito o débito recibirán automáticamente la devolución con dinero en cuenta de Mercado Pago. De esta manera, la orden de compra queda en estado diferente respecto de los demás flujos. Los cambios serán:

  • status = paid
  • Nuevo tag: unfulfilled
Nota:
La orden jamás tendrá el status cancelled ya que mediante la devolución con dinero en cuenta genera que el pago debe concretarse. En el pago de la orden encontrarás el tag refund_account_money.

Siguiente: Feedback de una venta.

o regístrate para recibir las últimas novedades sobre nuestra API